该 pragma 的作用是,在对应用程序进行编程之前,用该 pragma 修饰的集成编译库 <library name> .compiled-library
的标识符将被隐藏。可以调用 POU,但在CODESYS 用户界面上看不到变量。
受影响的功能
-
库管理
-
调试
-
输入助理
-
功能 "列出组件"
-
监测
-
符号配置
这在开发图书馆时非常有用。作为程序库开发人员,您可以使用 pragma 来装饰功能块或变量。因此,您可以确定哪些标识符会在集成后隐藏在应用程序中。如果以后想显示隐藏的标识符,例如用于调试或进一步开发库,可以重新激活其可见性。
语法
{attribute 'conditionalshow' ( := ' <some text> ' )? }
<some text>
:可选的字符串字面量,用于通过命令行命令和该字面量控制使用此类 pragma 修饰的标识符的可见性。在指定该 pragma 时,无论CODESYS 是如何启动的,它都会隐藏CODESYS 开发环境中的变量。有关这方面的更多帮助,请参阅文件 "库开发摘要"。
插入位置:函数块声明部分的顶行,变量上方
示例
更多实例,请参阅文件 "库开发摘要"。
隐藏变量
FUNCTION_BLOCK FB_DataManager VAR {attribute 'conditionalshow' := 'Library_Developer'} iLocal : INT; iCounter : INT; END_VAR
变量iLocal
是不可见的。
隐藏功能块
{attribute 'conditionalshow' := 'Library_Developer'} FUNCTION_BLOCK FB_DataManager VAR iLocal : INT; iCounter : INT; END_VAR
标识符FB_DataManager
、iLocal
和iCounter
是不可见的。
现有源代码文件的可见性
当集成库中的源代码文件 <library name> .library
也存在于同一内存位置(存储库)时,尽管有pragma标记,标识符还是可见的。这与声明中是否指定了属性值无关。
激活可见性的命令行调用
您也可以通过使用命令行选项conditionalshowsymbols
启动CODESYS ,在没有源代码文件的情况下启用隐藏变量的可见性。要启用可见性,请指定用逗号分隔的 pragma 属性值。
语法
codesys.exe --conditionalshowsymbols=" <some text> ( ,<next text> )* "
示例
codesys.exe --conditionalshowsymbols="Library_Developer"
codesys.exe --conditionalshowsymbols="Group_A,Group_B"
另见
-
"库开发摘要","可见性控制 "章