输入配置 "对话框

标志 _visu_icon_input_configuration

功能：该对话框用于为特定输入事件分配输入操作。它还包括所选输入操作的特定设置。

请致电 ：在“输入配置” 属性中，单击“配置” 。

要求：在编辑器中选择一个元素。

输入操作 "用户管理

“对话和行动”	配置输入事件后可能出现的用户管理对话框或动作请注意：运行时使用的对话框在可视化管理器的“对话框设置” 选项卡中配置。另见 “登录对话框” “更改密码对话框” “更改配置对话框” 默认值：`‎VisuUserManagement‎` 库中的对话框
“登录”	登录提示打开。默认值：“登录对话框”中的`‎VisuUserManagement.VUM_Login‎`
“注销”	当前用户已注销。
“更改用户密码”	更改密码的对话框打开。默认值：“更改密码对话框”中的`‎VisuUserManagement.VUM_ChangePassword‎`
“打开用户配置”	打开用于更改配置的对话框。默认值：“更改配置对话框”中的`‎VisuUserManagement.VUM_UserManagement‎`

另见

输入操作 "关闭对话框

“对话框”

将关闭的可视化类型“Dialog” 。

_visu_icon_open_list :包含项目中所有“Dialog” 类型可视化内容的列表框。

示例：

通常集成在项目中的‎VisuDialogs‎ 库的默认对话框。

‎FileOpenSave‎
‎Keypad‎
‎Login‎
‎Numpad‎
‎NumpadExtended‎
‎TextinputWithLimits‎

请注意：可视化对象属性（“可视化” 选项卡）中的设置决定了可视化是否可用作对话框。

“结果”	关闭对话框的返回值。请注意：如果关闭后有更多输入操作，则在“输入配置 OnDialogClosed” 元素属性中配置。
“无”	:无返回值
“OK”	:将返回设置的返回值。返回值指的是对话框中的按钮。`‎OK‎` 返回确定按钮的值。`‎Cancel‎` 返回取消按钮的值。
“取消”
“中止”
“Retry”
“忽略”
“是”
“没有”

另见

⮫ “可视化对象 "属性 "对话框”

输入操作 "打开对话框

“对话框”

可视化（类型“Dialog” ）。对话框打开。

_visu_icon_open_list :包含项目中所有可用对话框的列表框。

请注意：“VisuDialogs” 库提供可视化功能（类型“Dialog” ）。

‎VisuDialogs.FileOpenSave‎
‎VisuDialogs.Login‎

对话框的传输参数
“参数”	可视化界面编辑器中声明的界面参数例如 `‎filelistProvider‎`
“Type”	可视化界面编辑器中声明的参数数据类型。例如 `‎VISU_FBFILELISTPROVIDER‎`
“Value”	变量（数据类型与参数的数据类型一致）。对话框打开时会读取变量的值，并将其传递给参数。例如 `‎PLC_PRG.fileListProvider // Instance of function block VisuDialogs.Visu_FbFileListProvider‎` :输入辅助工具可提供整个项目中的所有变量。

此处激活对话框的返回值，并写入`‎Var_OUTPUT‎` 变量和`‎VAR_IN_OUT‎` 变量。对话框随后关闭。
“如果有结果，更新” “和” “参数”	请注意：参数会在对话框关闭前更新。在此之前，这些值将被临时存储。它们是作为副本存储的，而不是作为参考。
“无”	:无返回值
“OK”	:定义写入传输参数的返回值
“取消”
“中止”
“Retry”
“忽略”
“是”
“没有”

“打开对话框模式”

_cds_icon_option_activated :只有对话框处理用户输入。其余的可视化功能则受用户输入的限制。

“打开位置”
“居中”	对话框将在可视化中心打开。
“职位”	对话框在“X” 和“Y” 所定义的位置打开。
“X”	位置（像素）或变量（整数数据类型）
“Y”	位置（像素）或变量（整数数据类型）

另见

⮫ “在可视化中调用对话框”

输入操作 "更改语言

“Language”

要转换的语言

例如 ‎en‎

_visu_icon_open_input_assistant :输入辅助工具提供项目中所有可用的语言。

输入操作 "更改显示的可视化效果

表格 683： “缩放至可视化”
用户输入时显示的可视化效果
“分配”	从项目或库中所有可用可视化中选择的可视化。例如 `‎visMain‎`
“指定表达式”	包含可视化名称的变量 (`‎STRING‎`) 示例：`‎PLC_PRG.strVisu‎` ，应用代码如下： `‎strVisu: STRING := 'visMain';‎`
用户输入的可视化显示顺序由内部保存。以下选项使用了这一信息。
“上一次显示的可视化”	:在当前可视化之前已经显示过的可视化内容要求：可视化切换已经发生。
“下一个显示的可视化”	:在当前调用顺序之后的下一个可视化。要求：“调用的可视化切换已经发生上一次显示的可视化” 。

输入操作 "执行命令

这里列出的命令带有传输参数，可视化系统会在输入事件发生时处理这些参数。

“配置命令”

_visu_icon_open_list

“在 plc 上执行程序”
“在客户端执行程序”
“打印”
“导航至 URL（WebVisu）”
“创建配方”
“读取配方”
“写入配方”
“将配方写入文件”
“从文件加载配方”
“删除配方 ”

单击 _visu_icon_add ，将所选命令添加到下级命令列表中。

	“配置命令” 中的命令被添加到列表中。
	命令已删除。要求：选择一条命令。
列表中的顺序定义了执行顺序。
	所选命令在列表中向下移动一个位置。
	所选命令在列表中上移一个位置。

表格 684：命令“在 plc 上执行程序”
“指挥”	“第 1 个参数”	“第 2 个参数”
`‎ExecutePlcProgram‎`	`‎'C:\programs\notepad.exe'‎`	`‎'Notes_A.txt'‎`
在控制器上执行的 EXE 文件程序是在 PLC 上执行的，因此它不能是交互式的，也不能有任何用户界面。例如，程序可以复制文件。	程序名称，目录为`‎STRING‎` ，用单引号标出	程序参数`‎STRING‎` ，用单引号标出示例：程序打开的文件名

表格 685：命令“在客户端执行程序”
“指挥”	“第 1 个参数”	“第 2 个参数”
`‎ExecuteClientProgram‎`	`‎'C:\programs\notepad.exe'‎`	`‎'Notes_A.txt'‎`
在显示类型上执行的 EXE 文件。例外情况：WebVisu. 程序在显示类型的上下文中执行。之后，程序可以是交互式的，并具有用户界面。	程序名称，目录为`‎STRING‎` ，用单引号标出	程序参数`‎STRING‎` ，用单引号标出示例：程序打开的文件名

注意

如果可视化显示为CODESYS WebVisu ，则无法启动任何程序（EXE 文件）。

表格 686：命令“导航至 URL (WebVisu) ”
“指挥”	“第 1 个参数”	“第 2 个参数”
`‎NavigateURL‎`	`‎'http://en.wikipedia.org'‎` `‎PLC_PRG.stURL‎`	`‎'replace'‎`
可视化导航至 URL 的网页。要求：可视化以CODESYS WebVisu 的形式执行。	URL 用单引号直译作为变量 (`‎STRING‎`)	如果未指定参数，网页将在新窗口或新标签页中显示。如果指定`‎'replace'‎` ，则CODESYS WebVisu 将被网页取代。

表格 687：命令“读取配方”
“指挥”	“第 1 个参数”	“第 2 个参数”
`‎ReadRecipe‎`	`‎'RecipeDefinitionForModules'‎`	`‎'RecipeModuleA'‎`
	配方定义名称作为字面意思作为变量 (STRING)	配方名称作为字面意思作为变量 (STRING)
在可视化运行时，控制器从配方定义的变量中读取实际值，并将其写入指定配方。这些值会隐式保存（保存到控制器上的文件中），并显示在CODESYS 配方管理器的配方定义中。换句话说，在CODESYS 中管理的配方会根据控制器提供的值进行更新。

表格 688：命令“写配方”
“指挥”	“第 1 个参数”	“第 2 个参数”
`‎WriteRecipe‎`	`‎PLC_PRG.stRecipeDef‎`	`‎PLC_PRG.stRecipe‎`
	受影响配方定义的名称作为字面意思作为变量 (STRING)	配方名称（来自配方定义）作为字面意思作为变量 (STRING)
在可视化运行时，配方的值会写入控制器上的变量，就像在配方管理器中一样。

表格 689：命令“在文件中保存配方”
“指挥”	“第 1 个参数”	“第 2 个参数”
`‎SaveRecipeAs‎`	`‎PLC_PRG.stRecipeDef‎`	`‎PLC_PRG.stRecipe‎`
	受影响配方定义的名称作为字面意思作为变量 (STRING)	更新并保存到文件中的受影响配方名称作为字面意思作为变量 (STRING) 可选参数：如果不在此处指定传输参数，配方变量的值将只保存在稍后指定的文件中。隐式配方文件不会更新。
在可视化运行时，将打开“Save Recipe as” 对话框，提示用户输入文件名和控制器上的存储位置。文件名不得为`‎<recipe>.<recipe definition>‎` 。文件扩展名为`‎.txtrecipe‎` 。然后，用户可以保存包含配方变量实际值的文件。如果第 2 个参数中指定的传输参数不是，则保存文件时不会更改隐式配方文件。如果在第 2 个参数中给出了转移参数，则隐式配方文件也会更新。请注意：如果在“Recipe "配方管理器 - 常规 "” 标签中选择“"自动将配方更改保存到配方文件 "” 选项，则CODESYS 中的配方定义和隐式配方文件会自动保持一致。请注意：控制器上存在隐式（自动生成）配方文件，其名称语法如下：`‎<recipe>.<recipe definition>.txtrecipe‎`.在读写配方变量时，这些变量通常在应用程序中用作缓冲区。

表格 690：命令“从文件加载配方”
“指挥”	“第 1 个参数”	“第 2 个参数”
`‎LoadRecipeFrom‎`	`‎PLC_PRG.stRecipeDef‎`	`‎PLC_PRG.stRecipe‎`
	受影响配方定义的名称作为字面意思作为变量 (STRING)	受影响配方的名称作为字面意思作为变量 (STRING)
在可视化运行时，将打开“Load Recipe” 对话框。它为可视化用户提供位于控制器文件系统中的文件列表，并通过扩展名`‎txtrecipe‎` 进行筛选。所选文件已下载。然后将文件中的配方写入隐式文件，并读取到配方管理器配方定义中的指定配方。要求：文件是用`‎SaveRecipeAs‎` 命令创建的。

表格 691：命令“创建配方”
“指挥”	“第 1 个参数”	“第 2 个参数”
`‎CreateRecipe‎`	`‎PLC_PRG.stRecipeDef‎`	`‎PLC_PRG.stRecipe_New‎`
	受影响配方定义的名称作为字面意思作为变量 (STRING)	新配方名称作为字面意思作为变量 (STRING)
在可视化运行时，会在给定的配方定义中创建一个新配方。

表格 692：命令“删除配方”
“指挥”	“第 1 个参数”	“第 2 个参数”
`‎DeleteRecipe‎`	`‎PLC_PRG.stRecipeDef‎`	`‎PLC_PRG.stRecipe‎`
	受影响配方定义的名称作为字面意思作为变量 (STRING)	配方名称作为字面意思作为变量 (STRING)
在可视化运行时，指定配方将从配方定义中删除。

表格 693：命令“打印”
“指挥”	“第 1 个参数”	“第 2 个参数”
`‎Print‎`	可选：要打印的可视化屏幕的文件名（例如："......"）：开始屏幕）	`‎Print‎` 命令不能指定第二个参数。
运行可视化时，会打开默认的“打印机” 对话框。在对话框中，您可以选择打印机并配置其他打印设置。确认对话框后，将打印当前显示的可视化屏幕。请注意：该命令只能在 TargetVisu 中执行。

另见

输入操作 "切换画面可视化

当输入事件发生时，显示屏会在一帧内切换到另一种可视化效果。

“框架选择类型”
“切换本地可视化”	“框架选择” 组可见。
“切换到任何可视化”	“框架和可视化选择” 组可见。

要求：“选择 "切换本地可视化” "。
“框架选择”	包含活动可视化的所有帧的列表。根据“References” 属性，每个帧下方都会列出所引用的可视化内容。示例：
“分配选择”	接受“框架选择” 输入框中的选择。然后，它就会出现在“Selected frame” 和“Selected visualization” 设置中。要求：在“框架选择” 输入框中选择一个可视化效果。
“选定框架”	要切换到的帧的名称例如 `‎MainArea‎` 提示使用“Assign selection” 命令更改此处的设置。
“精选视频”	切换后的可视化名称。例如 `‎visMainArea‎` 提示使用“Assign selection” 命令更改此处的设置。

要求：选择“切换到任何可视化” 选项。
“框架和可视化选择”	包含要切换到的帧
“分配”	要切换到的机架（带完整路径）。指数决定可视化效果。例如 `‎visMain.frameA.visB.frameB‎` 路径按以下语法指定： `‎<visualization name>.<frame name> { <visualization name>.<frame name> }‎` 注意事项可视化效果可通过框架元素以任意深度嵌套。为了顺利使用“切换到任何可视化” 框架选择类型，一个框架所包含的引用可视化不得超过 21 个。
“指定表达式”	变量 (`‎STRING‎`)。包含要切换到的帧的路径例如 `‎strFrane: STRING := 'visMain.frameA.visB.frameB';‎`
“索引选择”	决定显示引用的可视化内容的索引作为整数作为变量（整数数据类型）例子：`‎PLC_PRG.iIndex‎` 请注意：一个框架中被引用的可视化内容会根据其顺序自动编制索引。

要求：该项目包含形成结构的可视化内容。

另见

⮫ “框架配置 "对话框”

输入操作 "写入变量

输入操作的配置定义了可视化用户如何指定数值以及将数值写入哪个变量。

检查所有输入是否有效。确保只能将范围内的值添加到数字字段中。输入值的数据类型不同，限制也会不同。

“输入类型” 如何提示输入。
“默认” ：	输入框也会打开，必要时还会打开虚拟键盘（当显示类型没有物理键盘时）。请注意：运行时文本输入的默认选项在可视化管理器中设置：“对话框设置” 选项卡，“默认文本输入的设置” 。
“文本输入”	出现输入框。您可以使用键盘指定数字或文本。要求：显示变体有一个键盘作为输入设备。
“带限制的文本输入”	出现输入框。您可以使用键盘指定数字或文本。该字段还显示输入值的范围。超过限值时，输入值将显示为红色。要求：显示变体有一个键盘作为输入设备。
“VisuDialogs.Keypad”	虚拟键盘打开。您可以用它来指定数字或文本。
“VisuDialogs.Numpad”	虚拟键盘打开。您可以用它来指定一个数字。
“VisuDialogs.NumpadExtended”	虚拟键盘打开。您可以用它来指定一个数字。这里也允许使用十六进制和指数符号。

“选择要编辑的变量”
“使用文本输出变量”	:输入值将写入元素的文本输出变量。这是分配给“文本变量文本” 属性的变量。
“使用另一个变量”	:写入输入值的变量。例如 `‎PLC_PRG.iVariable‎`
“初始显示格式”	格式定义占位符。它定义了变量值的输出格式和输入限制。例如：`‎%2.3f‎` ，用于将数值显示为十进制分数。

“最小”	输入限值的最小值。如果用户指定的数值较小，则不会被接受。作为固定值作为变量（数据类型与所选变量一致）
“最大”	输入限值的最大值。如果用户指定了更大的值，则不会被接受。作为固定值作为变量（数据类型与所选变量一致）
“对话框标题”	对话框标题栏中显示的文本。可选。作为固定字符串例如 `‎Insert value‎` 作为变量 (`‎STRING‎`) 例如 `‎PLC_PRG.stTitle : STRING := 'Insert value';‎`

“密码字段”

_cds_icon_option_activated :看不见的文本输入。‎***‎ ，而不是输入文本。

表格 694： “打开输入对话框的位置”
“使用全局设置（来自可视化管理器）”	:该选项仅适用于 TargetVisu 或 WebVisu。使用的设置可在可视化管理器的“对话框设置” 选项卡中找到。
“居中”	:对话框将在可视化窗口中央打开。
“职位”	:对话框将在可视化界面中此处定义的位置打开。 “X”,“Y” ：在可视化窗口坐标系中定义对话框左上角的变量或显式数字（单位：像素）。您可以使用占位符`‎ElementRectangle.ptTopLeft.iX‎` 和`‎.iY ElementRectangle.ptBottomRight.iY‎` 。它在运行时会被调用元素的坐标所取代。

另见

输入操作 "执行 ST 代码

输入栏	结构化文本代码编辑器

输入操作 "切换变量

“可变”	变量 (`‎BOOL‎`)。它在`‎TRUE‎` 和`‎FALSE‎` 之间切换输入事件。例如 `‎PLC_PRG.bSwitch‎`

输入操作 "文件传输

通过“File Transfer” 输入操作，可将文件从操作变量（目标或网络可视化）传输到 PLC，也可在 PLC 之间传输文件。这可以通过文件传输（“类型” ：“文件”) 或流媒体 (“类型” ：“流媒体” ）。

该操作的效果是在运行时在可视化界面中显示文件选择对话框。在这里，可视化用户可以选择一个文件，将其传输到 PLC 或从 PLC 传输出去：要从 PLC 传输到可视化系统，将打开“Save File” 对话框。要从可视化系统传输到 PLC，将打开“Open File” 对话框。

“转让”

“方向”

文件传输方向

“从 PLC 到可视化”

“文件名” 或“流实例名” 中指定的对象将从 PLC 传输到可视化系统。

“保存文件” 文件选择对话框会在运行时显示在可视化界面中。

“从可视化到 PLC”

可视化用户指定的文件将传输到 PLC，并保存在“文件名” 或“流实例名” 中指定的文件路径中。

“Open File” 文件选择对话框会在运行时显示在可视化界面中。

“Type”

确定文件传输的方式

传输类型“文件” ：通过文件传输
传输类型“流媒体” ：通过流媒体

“Type”

“文件”

数据传输通过文件传输完成。

“文件名”

文件路径（类型‎STRING‎ ），用于描述文件系统中的文件

可变

例如 ‎strTransferFile: STRING;‎
带相对路径的字面

例如：‎'/Recipes/Recipe_1.txt'‎ 将文件保存在‎Recipes‎ 目录中。
带有占位符的字面 ‎$PLCLOGIC$‎

‎PlcLogic‎ 是目录占位符‎$PLCLOGIC$‎ 的默认分辨率。

例如：‎'$$PLCLOGIC$$/test.txt'‎ 将文件保存在‎PlcLogic‎ 目录中。

例如：‎'$$PLCLOGIC$$/MyData/test.txt'‎ 将文件保存在‎PlcLogic/MyData‎ 目录中。
带有占位符的字面 ‎$VISU$‎

‎visu‎ 是占位符‎$VISU$‎ 的默认分辨率。

例如：‎'$$VISU$$/test.txt'‎ 将文件保存在子目录‎PlcLogic/visu‎ 中。此外，还可以指定‎'visu/test.txt'‎ 。
带有绝对路径的字面

例如 ‎ 'E:\temp\test.txt'‎

请注意：这类文件路径并不总是受支持。

请注意：如果用户通过“文本字段” 元素在可视化中指定文件路径，则不得包含屏蔽字符‎$‎ ： ‎$VISU$/dummy.txt‎

请注意：如果文件路径由用户指定，则应由应用程序进行检查，以防止文件被意外读取或覆盖。

“Type”

“流媒体”

数据传输采用流式传输方式。

“流媒体实例名称”

实例路径（类型：‎IVisuStreamWriter‎ 或‎IVisuStreamReader‎ ），用于描述控制器文件系统中的对象

用于传输方向的类型‎IVisuStreamReader‎ “ 从 PLC 到可视化”

‎IVisuStreamWriter‎ 用于传输方向“从可视化系统到 PLC”

“控制标志”

请注意：变量仅对传输方向进行评估“从可视化到 PLC” 。

变量（类型‎DWORD‎)

确定 PLC 文件系统处理对象（文件或实例对象）的方式。为此提供了两个标志，可用于设置变量。

标志 1： ‎VisuElems.VisuEnumFileTransferControlFlags.UseOriginalFileName‎
旗帜 2： ‎VisuElems.VisuEnumFileTransferControlFlags.ConfirmFileOverwriteInPlc‎

选项

未设置标志：

用户选择的文件保存在“文件名” 或“流实例名” 中指定的路径中。
标志 1 已设置：

用户在可视化运行时指定的路径将被应用并用作 PLC 文件系统中的路径。
两个标志都已设置：

还将检查路径。如果客户端指定的路径中已经存在一个对象，可视化界面中就会显示一条信息提示。可视化用户可在此确认文件是否将被覆盖。

例如 ‎dwControlFlag‎

示例

传输方向是“从可视化到 PLC” （写）。

示例：在可视化设备中创建了一个新的配方文件‎Recipes/Recipe_2021.txt‎ 。可视化用户选择了该文件，并希望以相同的名称将文件保存在 PLC 上。由于控制标志已相应设置，因此会打开一个消息窗口，可视化用户可以确认文件将被覆盖。

PROGRAM PLC_PRG
VAR
	xVisuToggle : BOOL;
	dwControlFlag : DWORD:= VisuElems.VisuEnumFileTransferControlFlags.UseOriginalFileName + VisuElems.VisuEnumFileTransferControlFlags.ConfirmFileOverwriteInPlc;
	strFileName: STRING := '/Recipes/Recipe_new.txt';
END_VAR

表格 695： “状态变量”
“主动转账”	布尔变量（可选） `‎TRUE‎`:转账正在进行中。
“转账成功”	布尔变量（可选） `‎TRUE‎`:传输已成功完成。
“错误代码”	`‎0‎`:无差错 `‎1‎`:不明错误 `‎2‎`:取消文件对话框 `‎3‎`:其他文件传输进行中 `‎4‎`:文件传输过程中出现错误 `‎5‎`:超时取消 `‎6‎`:文件读取错误 - 文件不可用或无法读取。 `‎7‎`:不支持设备传输文件可能的原因 CODESYS WebVisu:默认情况下无法进行文件传输。与版本 < 3.5.11 的控制器通信：功能未实现。与版本 >= 3.5.11 的控制器通信：文件传输未激活（设备描述）。请注意：在这种情况下，请联系CODESYS 支持团队。