Attribute 'conditionalshow'

The pragma is relevant for function blocks and other types contained in a library.

The effect of this pragma is to hide the identifiers of referenced libraries of type *.compiled-library that are marked with the pragma. The function blocks or variables are then not displayed in the user interface. If the referenced library is installed as *.library, the identifiers are visible in the user interface despite the pragma.

Affected features:

• Library management
• Debugging
• Input assistant
• List components function
• Monitoring
• Symbol configuration

This is useful when you are developing libraries. As a library developer, you provide function blocks or variables with the pragma. This allows you to specify which identifiers are hidden after being included in a project. If you miss the hidden identifiers later, for example when debugging or further developing the library, you can re-enable their visibility.

Syntax: {attribute 'conditionalshow'}

Insertion location: Line above a signature

Samples

Hide a variable:

FUNCTION_BLOCK FB_Sample
PROGRAM_MAIN
VAR
    {attribute 'conditionalshow'}
    nLocal    : INT;
    nCounter  : INT;
END_VAR

The variable nLocal is invisible.

Hide a function block:

{attribute 'conditionalshow'}
FUNCTION_BLOCK FB_ Sample
VAR
    nLocal    : INT;
    nCounter  : INT;
END_VAR

The function block FB_Sample is invisible.

Effects of the attribute on monitoring and intelligent coding

(when inserting the attribute above the declaration of the identifiers)

*.library (source library)

*.compiled-library (compiled library)

If the source code file *.library of a referenced library is available at the same location (repository), the identifiers are visible despite the pragma.

See also:

• Attribute 'conditionalshow_all_locals'
• Attribute 'hide'
• Attribute 'hide_all_locals'