Attribute: conditionalshow

The pragma has the effect that the identifiers of an integrated compiled library ‎<library name>.compiled-library‎, which are decorated with the pragma, are hidden before programming an application. The POUs can be called but the variables are invisible in the CODESYS user interface.

Affected features

Library management
Debugging
Input Assistant
"List components" Feature
Monitoring
Symbol Configuration

This is useful when you develop libraries. As the library developer, you decorate function blocks or variables with the pragma. As a result, you determine which identifiers are hidden in an application after integration. If you want to show the hidden identifiers later, for example for debugging or further development of the library, you can reactivate its visibility.

Syntax

‎{attribute 'conditionalshow' := ' <some text> '}‎

Insert location: Top line in the declaration part of a function block, above a variable

Insert location

First line above the declaration part of functions and programs

‎<some text>‎

Optional

String literal to control the visibility of the identifiers decorated with this kind of pragma by means of a command-line command and this literal

When the pragma is specified without a literal, the variables in the CODESYS development environment are always hidden, regardless of how CODESYS was started.

TIP:

For more help about this, see the "Library Development Summary" document.

Example

For examples, see the "Library Development Summary" document.

Hiding a variable

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

The variable ‎iLocal‎ is invisible.

Hiding a function block

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

The identifiers ‎FB_DataManager‎, ‎iLocal‎, and ‎iCounter‎ are invisible.

Visibility in case of existing source code file
Command-line call to activate visibility