Skip to main content

Attribut : conditionnelshow_all_locals

Le pragma a pour effet que tout tous locaux les variables d'un POU de bibliothèque décoré avec le pragma sont cachées aux programmeurs d'application. Les POU d'une bibliothèque compilée intégrée <library name>.compiled-library peut être appelé, mais les variables sont invisibles dans le Basic Level interface utilisateur.

. Affecte les fonctionnalités :
  • Gestion de la bibliothèque

  • Débogage

  • Assistant de saisie

  • Fonction "Liste des composants"

  • Surveillance

  • Configuration des symboles

Ceci est utile lorsque vous développez des bibliothèques. En tant que développeur de bibliothèque, vous décorez des blocs fonctionnels avec le pragma. Par conséquent, vous déterminez que leurs identifiants sont cachés dans une application après l'intégration. Si vous souhaitez afficher ces identifiants ultérieurement, par exemple pour un débogage ou un développement ultérieur de la bibliothèque, vous pouvez réactiver sa visibilité.

Pour plus d'informations, consultez la documentation "Résumé du développement de la bibliothèque"

Syntaxe

{attribute 'conditionalshow_all_locals' := ' <some text> ' }

Emplacement d'insertion

Première ligne au-dessus de la partie déclaration du bloc fonction

<some text>

Optionnel

Littéral de chaîne facultatif pour contrôler la visibilité des identifiants décorés avec ce type de pragma au moyen d'une commande de ligne de commande et de ce littéral

Lorsque le pragma est spécifié sans littéral, les variables du Basic Level l'environnement de développement sont toujours cachés, quelle que soit la façon dont Basic Level a été lancé.

Masquer toutes les variables locales

{attribute 'conditionalshow_all_locals' := 'Library_Developer'}
FUNCTION_BLOCK FB_DataManager
VAR
    iLocal : INT;
    iCounter : INT;
END_VAR

Pour des exemples, voir le document "Résumé du développement de la bibliothèque".

Visibilité en cas de fichier de code source existant

Lorsque le fichier de code source <library name>.library d'une bibliothèque intégrée existe également au même emplacement mémoire (référentiel), les variables du POU de la bibliothèque sont visibles malgré les pragmas. C'est indépendamment du fait qu'une valeur d'attribut ait été spécifiée ou non dans la déclaration.

Appel en ligne de commande pour activer la visibilité

Vous pouvez également activer la visibilité de la variable cachée sans fichier de code source en lançant Basic Level avec l'option de ligne de commande conditionalshowsymbols. Pour activer la visibilité, spécifiez les valeurs d'attribut du pragma qui sont séparées par des virgules.

Syntaxe

codesys.exe --conditionalshowsymbols=" <some text> ( ,<next text> )* "
Exemple 260. Exemple
codesys.exe --conditionalshowsymbols="Library_Developer"
codesys.exe --conditionalshowsymbols="Group_A,Group_B"


Pour plus d'informations, consultez : hide_all_locals, conditionalshow, et le chapitre "Contrôle de la visibilité"