Attribute 'conditionalshow_all_locals'

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

The pragma causes all local variables of a library function block marked with the pragma to be hidden if the library is installed as *.compiled-library. The library function blocks of type *.compiled-library can be called, but the local variables are not displayed in the user interface. If the referenced library is installed as *.library, the local variables 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 with the pragma. This allows you to specify that their local variables are hidden after integration into a project. If you miss the hidden variables later, for example when debugging or further developing the library, you can re-enable their visibility.

Syntax: {attribute 'conditionalshow_all_locals'}

Insertion location: First line above the declaration part of the function block

Example: Hide all local variables

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

The local variables nLocal and nCounter of the function block FB_Sample are invisible.

Effects of the attribute on monitoring and intelligent coding

(Insertion location: above the declaration of the function block)

*.library (source library)

*.compiled-library (compiled library)

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

See also:

• Attribute 'conditionalshow'
• Attribute 'hide'
• Attribute 'hide_all_locals'