可视化元素 "文本字段

标志

类别“通用控制”

该元素用于以下目的：

静态输出文本。变量的内容可以是文本的一部分。
显示工具提示文本作为静态文本管理，也可定义为同时显示变量的内容。
动态输出文本文本列表的文本是动态显示的。
输入文本。例如，用户可以输入数字或文本字面。

另见

⮫ “用元素设计可视化”

元素属性

“元素名称”

可选

例如 ‎FileName_A‎

提示为元素指定单独的名称，以便在元素列表中更快地找到它们。

“元素类型”

“文本字段”

元素属性 "位置

位置定义了元素在可视化窗口中的位置和大小。这些都基于直角坐标系。原点位于窗口的左上角。正水平 x 轴向右延伸。垂直 y 轴的正方向是向下的。

“X”	元素左上角的 X 坐标以像素为单位。示例：`‎10‎` 。
“Y”	元素左上角的 Y 坐标以像素为单位。示例：`‎10‎` 。
“宽度”	以像素为单位。例如 `‎150‎`
“高度”	以像素为单位。例如 `‎30‎`

您还可以通过拖动方框符号 ( _visu_icon_position_element ) 到编辑器中的其他位置来更改数值。

另见

⮫ “定位元素、调整尺寸和图层”

元素属性 "颜色

“正常状态”	如果“颜色变量切换颜色” 中的变量未定义或其值为`‎FALSE‎` ，则正常状态生效。
“框架颜色”	变量相应状态的边框和填充颜色。
“填充颜色”	变量相应状态的边框和填充颜色。
“透明度”	透明度值（0 至 255），用于定义所选颜色的透明度。示例：255:颜色不透明。0:颜色完全透明。
“报警状态”	如果“颜色变量切换颜色” 中的变量值为`‎TRUE‎` ，则警报状态生效。

另见

⮫ “渐变编辑器 "对话框”

元素属性 "外观

属性包含用于设置元素外观的固定值。

“线宽”

像素值

例如 ‎2‎

请注意：‎0‎ 和‎1‎ 的值都会导致 1 个像素的线条权重。如果不显示线条，则“线条样式” 属性必须设置为选项“不可见” 。

“填充属性”

填充元素的方式。

“Filled”:元素用“Colors Fill color” 属性中的颜色填充。
“隐形” ：填充颜色是不可见的。

“线条风格”

线条表示类型

“固体”
“破折号”
“圆点”
“小飞点”
“点点”
“不可见”

您可以在“Appearance variables” 属性中分配变量，以便动态控制外观。此处的固定值将被覆盖。

另见

⮫ “ 元素属性 "外观变量”

元素属性 "文本

属性包含用于标记元素的字符串。字符串还可以包含一个带有格式定义的占位符。在运行模式下，占位符将被指定格式的当前值所取代。

CODESYS 自动将指定文本输入“GlobalTextList” 文本列表。因此，这些文本可以本地化。

“Text”

用于标注元素的字符串（不含单引号）。按键盘快捷键[Ctrl] +[Enter] 添加换行符。

例如 ‎Accesses: %i‎

包含占位符当前值的变量在属性“文本变量文本” 中指定。

“Tooltip”

作为元素工具提示显示的字符串（不含单引号）。

示例：‎Number of valid accesses‎ 。

包含占位符当前值的变量在属性“文本变量工具提示” 中指定。

另见

元素属性 "文本属性

属性包含文本属性的固定值。

“水平对齐”	元素内文本的水平对齐方式。
“垂直排列”	元素内文本的垂直对齐方式。
“文本格式”	显示过长文本的定义 “默认” ：长文本被截断。 “换行” ：全文分为几个部分。 “省略号” ：可见文本以"...... "结尾，表明文本不完整。
“字体”	示例：“默认值” :“字体” 对话框将打开。 :包含样式字体的下拉列表。
“字体颜色”	示例：“Black” :“Color” 对话框将打开。 :包含样式颜色的下拉列表。
“透明度”	整数（数值范围从`‎0‎` 到`‎255‎` ）。这决定了相应颜色的透明度。示例：`‎255‎` ：颜色不透明。 `‎0‎`:颜色完全透明。请注意如果颜色是样式颜色，并且已经具有透明度值，则此属性受写保护。

元素属性 "文本变量

这些属性是变量，其内容可替代格式定义。

“文本变量”

变量（数据类型符合格式定义）。它包含打印的内容，而不是格式定义。

例如 ‎PLC_PRG.iAccesses‎

请注意：格式定义是“文本文本” 属性中文本的一部分。

请注意：如果您指定了一个支持文本列表的枚举类型变量，那么枚举数据类型的名称会自动添加到变量名后的角括号中。示例：‎PLC_PRG.enVar <enumeration name>‎ 。这样，在打印文本时，枚举部件的符号值就会被打印出来，而不是数值。有关枚举，请参阅帮助页面。

“工具提示变量”

变量（数据类型符合格式定义）。它包含打印的内容，而不是格式定义。

例如 ‎PLC_PRG.iAccessesInTooltip‎

请注意：格式定义是“文本工具提示” 属性中文本的一部分。

另见

元素属性 "动态文本

动态文本是文本列表中的可变索引文本。运行时，将显示变量中当前索引的文本。

“文本列表”

变量（字符串）或文本列表的名称，用单引号表示的固定字符串。

例如 ‎'Errorlist'‎

_cds_icon_arrow_down :下拉列表，包含文本列表中可用的对话框。

“文本索引”

文本列表 ID。这指的是所需的输出文本。

固定字符串，ID 用单引号标出。

例如 ‎'1'‎
作为变量 (‎STRING‎) 用于动态控制文本输出。

例如 ‎strTextID‎

任务示例： ‎PLC_PRG.strTextID := '1';‎

“工具提示索引”

文本列表 ID。这指的是所需的输出文本。

固定字符串，ID 用单引号标出。

例如 ‎'2'‎
作为变量 (‎STRING‎) 用于动态控制文本输出。

例如 ‎strToolTipID‎

任务示例： ‎PLC_PRG.strToolTipID := '2';‎

另见

⮫ “对象 "文本列表”

元素属性 "字体变量

通过这些变量可以对文本显示进行动态控制。

“字体名称”	变量 (`‎STRING‎`)。包括文字的字体。例如 `‎PLC_PRG.stFontVar := 'Arial';‎` 字体选择与默认的“字体” 对话框相对应。
“尺寸”	变量（数字数据类型）。包含字体大小（以像素或点为单位）。应用单位在变量名后的括号内指定。 <pt>：点数（默认）例如 `‎PLC_PRG.iFontHeight <pt>‎` 代码 `‎iFontHeight : INT := 12;‎` <px> :像素例如 `‎PLC_PRG.iFontHeight <px>‎` 代码 `‎iFontHeight : INT := 19;‎` 如果单击值字段，右侧会打开一个下拉列表，用于设置单位。提示字体大小以点为单位指定（例如：......）：Arial 12）。当变量字体大小应与字体匹配时，请使用点，例如，如果在属性“文本属性字体” 中设置了字体。
“旗帜”	变量 (`‎DWORD‎`)。包含用于显示字体的标志。旗帜 `‎1‎`:斜体 `‎ 2‎`:粗体 `‎4‎`:下划线 `‎8‎`:删除线请注意：您可以通过添加标志的编码来组合字体显示。例如，粗体和下划线文本： `‎PLC_PRG.dwFontType := 6;‎`
“字符集”	变量 (`‎DWORD‎`)。包含字体的字符集编号。字符集编号的选择与标准“字体” 对话框中的“脚本” 设置相对应。
“颜色”	变量 (`‎DWORD‎`)。包括文字的颜色。例如 `‎PLC_PRG.dwColorFont:= 16#FF000000;‎`
“文本对齐标志”	变量（整数数据类型）。包含文本对齐的编码。示例：`‎PLC_PRG.dwTextAlignment‎` 。编码： `‎0‎`:左上角 `‎1‎`:水平中心 `‎2‎`:对 `‎4‎`:垂直中心 `‎8‎`:底部请注意：您可以通过添加标记编码来组合文本对齐方式。例如，垂直和水平居中的文本： `‎PLC_PRG.dwFontType := 5;‎`

显示文本的固定值在“文本属性” 中设置。

另见

⮫ “元素属性 "文本属性”

元素属性 "颜色变量

元素属性是项目变量的接口，用于在运行时动态控制颜色。

“切换颜色”	该属性控制运行时切换的颜色。数值分配： `‎FALSE‎`:元素会以“Color” 属性中指定的颜色显示。 `‎TRUE‎`:元素会以“警报颜色” 属性中指定的颜色显示。作业选项：用户输入变量的占位符 “<切换/轻敲变量>” “<不是切换/轻敲变量>” 颜色的变化不受自身变量的控制，而是受用户输入变量的控制。请注意：在元素的输入配置中为鼠标事件指定一个变量“Tap” 或“Toggle” 。只有这样才能设置占位符。如果在“Toggle” 和“Tap” 中都配置了变量，则使用“Tap” 中指定的变量。提示单击符号，插入占位符“<toggle/tap variable>” 。激活“Inputconfiguration”,“Tap FALSE” 属性后，会显示“<NOT toggle/tap variable>” 占位符。项目变量的实例路径 (`‎BOOL‎`) 例如 `‎PLC_PRG.xColorIsToggeled‎` 请注意：在代码中，声明并实现此处指定的变量。它的值分配决定了颜色何时改变。
“正常状态” “报警状态”	下面列出的属性可根据状态控制颜色。如果“颜色变量”,“切换颜色” 中的变量未定义或其值为`‎FALSE‎` ，则正常状态生效。如果“颜色变量”,“切换颜色” 中的变量值为`‎TRUE‎` ，则警报状态生效。
“框架颜色”	作业选项：边框颜色变量 (`‎DWORD‎`) 例如 `‎PLC_PRG.dwBorderColor‎` 颜色字面绿色和不透明的例子： `‎16#FF00FF00‎`
“填充颜色”	作业选项：用于填充颜色的变量 (`‎DWORD‎`) 例如 `‎PLC_PRG.dwFillColor‎` 颜色字面灰色和不透明的例子： `‎16#FF888888‎`

只有在可视化管理器的“激活半透明绘图” 选项被选中时，颜色值的透明度部分才会被评估。

在属性视图的工具栏中选择“Advanced” 选项。然后就可以看到所有元素属性。

另见

⮫ “动画彩色显示屏”

元素属性 "绝对移动

属性包含用于动态控制元素位置的 IEC 变量。参考点是元素的左上角。在运行模式下，整个元素都会被移动。

“运动”
“X”	变量（数字数据类型）。定义 X 位置（以像素为单位）。示例：`‎PLC_PRG.iPos_X‎` 。在运行模式下，增加该值可将元素向右移动。
“Y”	变量（数字数据类型）。定义 Y 位置（以像素为单位）。示例：`‎PLC_PRG.iPos_Y‎` 。在运行模式下，增加该值会使元素向下移动。
“旋转”	变量（数字数据类型）。定义旋转角度（度）。示例：`‎PLC_PRG.iAngle1‎` 。元素的中点在“中心” 点旋转。该旋转点显示为符号。在运行模式下，元素相对于可视化坐标系的对齐方式保持不变。增大数值会使元素向右旋转。
“内部旋转”	变量（数字数据类型）。定义旋转角度（度）。示例：`‎PLC_PRG.iAngle2‎` 。在运行模式下，元素会根据变量值围绕“Center” 中指定的旋转点旋转。此外，元素的排列会根据可视化坐标系进行旋转。代码中的数值越大，旋转方向越顺时针。旋转点显示为符号。请注意：如果在“Position Angle” 属性中指定了静态旋转角度，那么在执行可视化时，静态旋转角度将添加到可变旋转角度（偏移）中。

您可以将变量与单位换算联系起来。

“X”,“Y”,“旋转”, 和“内部旋转” 属性由 "客户端动画 "功能支持。

另见

元素属性 "状态变量

变量可动态控制元素的行为。

“无形”

变量 (‎BOOL‎)。切换元素的可见性。

‎TRUE‎:该元素在运行时不可见。

示例：‎bIsVisible‎ ‎VAR bIsVisible : BOOL := FALSE; END_VAR‎

“停用输入”

变量 (‎BOOL‎)。切换元素的可操作性。

‎TRUE‎:用户输入在运行时不会产生任何影响。元素显示为停用。

“不可见” 属性由 "客户端动画 "功能支持。

元素属性 "选择和标记符号配置

通过这些变量可以控制滑鼠游标的位置和文本的选择。

“键槽位置”	变量（整数数据类型）。包含光标的位置。
“选择开始”	变量（整数数据类型）。包含第一个选定字符的位置。例如 `‎PLC_PRG.iSelStart‎`
“选择结束”	变量（整数数据类型）。包含最后一个选定字符的位置。例如 `‎PLC_PRG.iSelEnd‎`
“全部选定”	变量 (BOOL)。切换输入文本的选择。 `‎TRUE‎`:文本字段中的文本被选中。 `‎FALSE‎`:选择从“中的值开始，选择从” 开始，选择从“结束，选择从” 结束。

只有在可视化管理器中选择“Support client animations and overlay of native elements” 选项后，这些属性才可用。

“动画持续时间”

定义元素运行动画的持续时间（以毫秒为单位

变量 (‎integer value‎)

示例：‎Menu.tContent‎ ‎VAR tContent : INT := 500; END_VAR‎
整数字面

例如 ‎500‎

动画属性

“绝对运动”,“运动”,“X”,“Y”
“绝对运动”,“旋转”
“绝对运动”,“内部旋转”
“绝对运动”,“外部旋转”

当可动画属性的至少一个值发生变化时，就会执行动画运动。在指定的动画持续时间内，执行的动作不会生涩，而是很流畅。可视化元素在动态旋转的同时移动到指定位置。过渡流畅。

“移至前景”

将可视化元素移至前台

变量 (‎BOOL‎)

示例：‎bIsInForeground‎ ‎VAR bIsInForeground : BOOL := FALSE; END_VAR‎

‎TRUE‎:运行时，可视化元素显示在前台。

‎FALSE‎:运行时，可视化元素会显示在可视化编辑器中插入该元素的图层中。

元素属性 "输入配置

属性包含用户使用鼠标或键盘输入时的配置。用户输入定义了一个事件以及事件发生时要执行的一个或多个操作。

“配置” 按钮打开“输入配置” 对话框。您可以在这里创建或编辑用户输入。事件下方列出了已配置的用户输入。它们分别包括触发的操作和简短的设置。示例：“执行 ST 代码” ： `‎PLC_PRG.i_x := 0;‎`
“OnDialogClosed”	输入事件：用户关闭对话框。
“OnMouseClick”	输入事件：用户在元素区域内完全点击鼠标按钮。点击鼠标按钮并松开。
“OnMouseDown”	输入事件：用户向下点击鼠标键。
“OnMouseEnter”	输入事件：用户将鼠标指针拖到元素上。
“OnMouseLeave”	输入事件：用户将鼠标指针拖离元素。
“OnMouseMove”	输入事件：用户将鼠标指针移到元素区域上。
“OnMouseUp”	输入事件：用户在元素区域内松开鼠标按钮。至于用户之前是在元素区域内还是在元素区域外按下鼠标按钮，则无关紧要。用户在元素区域内按下鼠标键，离开元素区域，然后松开鼠标键。请注意：这种CODESYS 特有的触发行为可确保完成关键要素的操作。关键元素会启动“OnMouseDown” 的操作，并结束“OnMouseUp” 的操作。示例：可视化用户在关键元素的元素区域内按下鼠标键，然后移动光标位置，使其位于元素区域之外。由于“OnMouseUp” 已被触发，因此该操作还是结束了。

“敲击”	当鼠标单击事件发生时，应用程序中将描述“Variable” 中定义的变量。编码取决于“Tap FALSE” 和“Tap on enter if captured” 选项。
“可变”	在鼠标点击事件中设置的变量 (`‎BOOL‎`)。例如 `‎PLC_PRG.bIsTapped‎` `‎TRUE‎`:存在鼠标点击事件。只要用户在元素上按下鼠标键，它就会持续。按钮松开时结束。 `‎FALSE‎`:不存在鼠标点击事件。要求：“Tap FALSE” 选项未激活。
“轻按 FALSE”	:鼠标点击事件会在“变量” 中产生一个互补值。 `‎TRUE‎`:不存在鼠标点击事件。 `‎FALSE‎`:当鼠标点击事件存在时
“如果捕获，请点击回车键”	:在用户输入时，还要考虑按下鼠标按钮时鼠标指针是否在元素区域内被拖动。 `‎TRUE‎`:当鼠标点击事件存在，且鼠标指针移动到元素区域时。 `‎FALSE‎`:不存在鼠标点击事件。或者用户在按下鼠标键的同时将鼠标指针移出元素区域。一旦用户将指针移回元素区域，该值就会再次被`‎TRUE‎` 。然后捕捉鼠标。

“Toggle”

当鼠标点击事件发生时，变量被设置；当鼠标点击事件结束时，变量被重置。

“可变”

变量 (‎BOOL‎)。当鼠标点击事件结束时，其值会切换。当鼠标指针位于元素区域上方时，用户会松开鼠标按钮。

如果用户在鼠标指针离开元素区域时松开鼠标按钮，则鼠标点击事件不会结束，值也不会切换。

提示用户可以通过将鼠标指针拖出元素区域来取消已启动的切换输入。

“如果捕获，向上切换”

_cds_icon_option_activated :释放鼠标按钮时，无论鼠标指针在哪里，该值都会切换。然后捕捉鼠标。

“Hotkey”	元素上用于触发特定输入操作的键盘快捷键。键盘快捷键事件发生时，会触发“Events” 属性中的输入操作。这样，不是输入操作本身导致了这个输入操作，而是鼠标输入操作导致了这个输入操作。
“钥匙”	输入操作时按下的键。示例：[T] 请注意：选择按键时会显示以下属性。
“活动”	“无” “鼠标向下移动” ：按键会触发在“OnMouseDown” 属性中配置的输入操作。 “鼠标向上” ：释放按键会触发在“OnMouseUp” 属性中配置的输入操作。 “鼠标向下/向上” ：按下和松开按键会触发在“OnMouseDown” 属性和“OnMouseUp” 属性中配置的输入操作。
“Shift”	:与 Shift 键组合示例：[移位]+[T] 。
“控制”	:与 Ctrl 键组合使用示例：[Ctrl]+[T] 。
“Alt”	:与 Alt 键组合使用示例：[Alt]+[T] 。

“键盘配置” 选项卡上列出了可视化中配置的所有键盘快捷键及其操作。

另见

元素属性 "访问权限

要求：为可视化设置了用户管理。

“访问权限”

打开“访问权限” 对话框。在这里可以编辑元素的访问权限。

状态信息

“未设置。” ：所有用户组的访问权限：“可操作”
“权利已设定：有限权利” ：至少有一个小组的访问受到限制。

另见

⮫ “访问权限 "对话框”