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