.

符号：

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

调用：在输入配置属性中，单击配置。

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

.另请参见

创建结构化的用户界面

.

输入动作“用户管理”

.

输入动作“关闭对话框”

.

输入动作“打开对话框”

.

输入动作“改变语言”

.

输入动作“变更显示的可视化”

.

输入动作“执行命令”

此处列出了带有传输参数的命令，这些传输参数在发生输入事件时由可视化程序处理。

.

配置命令	来自下拉列表的命令。单击以添加列表中的命令在PLC上执行程序在客户端执行程序打印链接到URL(WebVisu) 创建配方读配方写配方将配方保存在文件从文件加载配方删除配方

.

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

.

.命令在PLC上执行程序

命令

第1个参数

第2个参数

ExecutePlcProgram

'C:\programs\notepad.exe'

'Notes_A.txt'

在控制器上执行的EXE文件

该程序在PLC上执行，因此它不能是交互式的或具有任何用户界面。

例如，程序可以复制文件。

带有目录的程序名称，格式为STRING，用单引号标记

格式为STRING的程序参数，用单引号标记

例：程序打开文件的名称

.

.命令在客户端执行程序

命令

第1个参数

第2个参数

ExecuteClientProgram

'C:\programs\notepad.exe'

'Notes_A.txt'

在显示变体上执行的EXE文件（例外： WebVisu)

程序在显示变体的上下文中执行。为此该程序可以是交互式的并具有用户接口。

带有目录的程序名称，格式为STRING，用单引号标记

格式为STRING的程序参数，用单引号标记

示例：程序打开文件的名称

提示！

如果可视化显示为CODESYS WebVisu,则无法启动任何程序(EXE文件)。

.

.链接到URL(WebVisu)

命令

第1个参数

第2个参数

NavigateURL

'http://en.wikipedia.org'

PLC_PRG.stURL

'replace'

可视化链接到URL的网页.

要求：可视化作为CODESYS WebVisu被执行

.URL

作为单引号中的文字
作为变量（STRING）

如果未指定参数，则该网页将显示在新窗口或新选项卡中。

如果指定'replace’，则CODESYS WebVisu被网页替换

.

.命令读取配方

命令	第1个参数	第2个参数
ReadRecipe	'RecipeDefinitionForModules'	'RecipeModuleA'
	.受影响的配方定义的名称作为文字作为变量（STRING）	.配方的名称作为文字作为变量（STRING）
在可视化 runtime ，控制器从配方定义的变量中读取实际值，并将其写入指定的配方中。值将隐式保存(到PLC上的文件中),并显示在CODESYS的配方管理器中的配方定义中。换句话说，使用来自控制器的值来更新CODESYS管理的配方。

.

.命令写入配方

命令	第1个参数	第2个参数
WriteRecipe	PLC_PRG.stRecipeDef	PLC_PRG.stRecipe
	.受影响的配方定义的名称作为文字作为变量（STRING）	.配方名称（来自配方定义）作为文字作为变量（STRING）
在可视化 runtime ，将配方值像在配方管理器中一样写入到控制器上的变量中。

.

.命令将配方保存在文件

命令	第1个参数	第2个参数
SaveRecipeAs	PLC_PRG.stRecipeDef	PLC_PRG.stRecipe
	.受影响的配方定义的名称作为文字作为变量（STRING）	.受影响的配方的名称已更新并保存到文件中作为文字作为变量（STRING）可选参数：如果在此处未指定传输参数，则配方变量中的值仅保存以后指定的文件。隐式配方文件不会更新。
在可视化 runtime ，保存配方为对话框将打开，并提示用户输入控制器上的文件名和存储位置。不允许使用文件名<recipe>.<recipe definition>文件扩展名为.txtrecipe。然后，用户可以保存包含配方变量实际值的文件。如果在第二个参数中未指定传输参数，则文件将被保存而不更改隐式配方文件。如果在第二个参数中指定了传输参数，则隐式配方文件也会更新。注意：如果在配方管理器-常规选项卡中选择自动保存配方更改到配方文件选项,则CODESYS中的配方定义和隐式配方文件自动同步。注意：控制器上存在隐式（自动生成的）配方文件，其名称具有以下语法： <recipe>.<recipe definition>.txtrecipe。在读取和写入配方变量时，它们通常在应用程序中用作缓冲区。

.

.命令从文件加载配方

命令	第1个参数	第2个参数
LoadRecipeFrom	PLC_PRG.stRecipeDef	PLC_PRG.stRecipe
	.受影响的配方定义的名称作为文字作为变量（STRING）	.受影响的配方的名称作为文字作为变量（STRING）
在可视化runtime中,将打开加载配方对话框。它为可视化用户提供位于控制器文件系统中的文件列表，并按扩展名txtrecipe进行过滤。所选文件可以下载。然后，将文件中的配方写入隐式文件，并读取到“配方管理器”的配方定义中的给定配方。要求：文件通过 SaveRecipeAs命令被创建

.

.命令创建配方

命令	第1个参数	第2个参数
CreateRecipe	PLC_PRG.stRecipeDef	PLC_PRG.stRecipe_New
	.受影响的配方定义的名称作为文字作为变量（STRING）	.新配方名作为文字作为变量（STRING）
在可视化 runtime ，将在给定的配方定义中创建一个新配方。

.

.命令删除配方

命令	第1个参数	第2个参数
DeleteRecipe	PLC_PRG.stRecipeDef	PLC_PRG.stRecipe
	.受影响的配方定义的名称作为文字作为变量（STRING）	.配方的名称作为文字作为变量（STRING）
在可视化 runtime ，将从配方定义中删除给定的配方。

.

.命令打印

命令

第1个参数

第2个参数

Print

可选的：要打印的可视化屏幕的文件名(例'Startup image')

无法为Print指定第二参数

可视化 runtime ，将打开默认的打印机对话框。在对话框中,选择打印机并配置更多打印设置。确认对话框后，将打印当前显示的可视化屏幕。

注意：该命令仅在TargetVisu中执行

.另请参见

.

输入动作“切换框架可视化”

.

输入动作“写变量”

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

.

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

.

选择要编辑的变量
使用文本输出变量	：输入值将写入元素的文本输出变量。这是在文本变量 ➔ 文本属性中指定的变量
使用其他变量	：输入值写入的变量。例：PLC_PRG.iVariable
初始化显示格式	带有格式定义的占位符。它确定变量值和输入限制的输出格式例：%2.3f用于将值显示为小数部分。

.

最小	.输入限制的最小值如果用户指定更小的值，则不接受该值作为固定值作为变量（数据类型符合选定的变量）
最大	.输入限制的最大值如果用户指定更大的值，则不接受该值作为固定值作为变量（数据类型符合选定的变量）
对话框标题	.对话框标题栏中显示的文本。可选的。作为固定字符串例：Insert value 作为变量（STRING）例：PLC_PRG.stTitle : STRING := 'Insert value';

.

密码字段	：不可见文字输入。***而不是输入文本。

.

.输入对话框打开的位置

使用全局设置（从可视化管理器）

：此选项仅适用于TargetVisu或WebVisu。使用可在可视化管理器中的对话框设置选项卡中提供的设置。

居中

：该对话框将在可视化窗口的中心打开。

位置

：该对话框在可视化中此处定义的位置处打开。

X, Y: 在可视化窗口的坐标系中定义对话框左上角的可变或显式数字（以像素为单位）。

您可以使用占位符ElementRectangle.ptTopLeft.iX and .iY ElementRectangle.ptBottomRight.iY。它在 runtime 由调用元素的坐标来替换

.另请参见

输入动作“执行ST代码”

输入动作“切换变量”

输入动作“文件传送”

.传送

方向	从PLC到可视化从可视化到PLC
类型	文件流
文件名	要求：传送类型为文件。控制器文件系统中的文件名称。文件名可以指定为STRING类型的变量，也可以直接在单引号中指定。还可以将具有目录信息的绝对路径或相对路径指定为文件名。例: 'E:\temp\test.txt' ->绝对路径。 'MyData/test.txt' ->相对路径。该文件保存在PlcLogic/MyData子目录中。”PlcLogic”是目录占位符$PLCLOGIC$的默认解析。此占位符不必指定，但也可以指定：'$$PLCLOGIC$$/MyData/test.txt')。 '$$VISU$$/test.txt' ->相对路径。该文件保存在PlcLogic/visu子目录中。”visu”是占位符$VISU$的默认解析）。它也可以明确指定'visu/test.txt'. '$$VISU$$/test.txt' ->相对路径。该文件保存在PlcLogic子目录中。注意：如果通过”文本字段”元素编辑可视化中的路径,则不必给出掩蔽字符$：$VISU$/dummy.txt
流实例名称	在流模式下生成传送数据的对象的实例名称。该对象必须实现接口IVisuStreamReader (PLC -->可视化) 或IVisuStreamWriter (可视化-->PLC)。要求：传送类型为流。
控制标志	变量类型 DWORD。通过这些标志控制数据传送的选项。此变量可以是以下标志的组合： VisuElems.VisuEnumFileTransferControlFlags.UseOriginalFileName: 定义是否在控制器中也使用所选文件名。 VisuEnumFileTransferControlFlags.ConfirmFileOverwriteInPlc: 定义用户是否必须在覆盖现有文件时进行确认。

.

.状态变量

传送激活

布尔变量（可选)

TRUE: 传送正在进行中

传送成功

布尔变量（可选)

TRUE: 传输已成功完成。

错误代码

0: 没有错误
1: 未指定的错误
2: 取消文件对话框
3: 其他文件传送有效
4: 文件传送期间出错
5: 超时取消
6: 文件读取错误-文件不可用或无法读取
7: 没有设备支持文件传输
可能的情况：
- CODESYS WebVisu：默认情况下，无法进行文件传输。
- 与版本<3.5.11的控制器通信：功能未实现
- 与版本>=3.5.11的控制器通信：文件传输未激活(设备描述)。
  注意：在这种情况下,请联系CODESYS支持团队。

.在线模式下的行为(类型文件)

从控制器传输到可视化(操作面板)文件另存为对话框打开。可以在操作面板上为在输入配置的文件名中指定的文件定义文件名和存储位置。然后将文件存储在此处。
从可视化(操作面板)传送到控制器将打开打开文件对话框。可以根据文件名中的信息选择保存在控制器上的任何文件

对话框和动作	配置哪个可能的用户管理对话框或哪个操作跟随输入事件注意：在 runtime 使用的对话框是在可视化管理器的对话框设置选项卡中配置的。 .另请参见登录对话框更改密码对话框更改配置对话框默认：VisuUserManagement库中的对话框
登录	登录提示打开: 默认：登录对话框中的VisuUserManagement.VUM_Login
登出	当前用户已注销。
更改用户密码	打开用于更改密码的对话框。默认：更改密码对话框中的VisuUserManagement.VUM_ChangePassword
打开用户配置	对话框打开以更改配置。默认：更改配置对话框中的VisuUserManagement.VUM_UserManagement

结果	关闭对话框的返回值。注意：如果关闭后还有更多输入操作，则在元素的输入配置 ➔ OnDialogClosed属性中对其进行配置。
无	：无返回值
确定	：返回设置的返回值。返回值参考对话框中的按钮。为确定按钮返回值OK为取消按钮返回值Cancel
取消
中止
重试
忽略
是
否

对话框的传输参数
参数	在可视化的接口编辑器中声明的接口参数例如：filelistProvider
类型	在可视化的接口编辑器中声明的参数的数据类型。例如：VISU_FBFILELISTPROVIDER
值	变量（数据类型对应于参数的数据类型）。当对话框打开时，变量的值被读取并传输给参数例如：PLC_PRG.fileListProvider // Instance of function block VisuDialogs.Visu_FbFileListProvider ：输入助手提供了整个工程中所有可用的变量。

此处将激活对话框的返回值，并为其写入Var_OUTPUT变量和VAR_IN_OUT变量。然后对话框关闭
更新和在结果情况下的参数	注意：在关闭对话框之前将更新参数。在此之前，这些值将临时存储。它们存储为副本，而不是参考。
无	：无返回值
确定	：定义为其写入传递参数的返回值
取消
中止
重试
忽略
是
否

打开位置
居中	该对话框将在可视化的中心打开.
位置	对话框在X和Y定义的位置打开.
X	位置(以像素为单位)或变量(整数数据类型)
Y	位置(以像素为单位)或变量(整数数据类型)

在用户输入处显示的可视化
赋值	从工程或库中的所有可用可视化中选择的可视化。例: visMain
分配表达式	变量(STRING),包含可视化的名称。例：PLC_PRG.strVisu 用于以下应用程序代码: strVisu: STRING := 'visMain';
用户输入显示可视化的顺序在内部保存。以下选项使用此信息。
上一个显示的可视化	：在当前可视化之前已经显示的可视化要求：可视化已经切换
下一个显示的可视化	：调用顺序中当前调用可视化的下一个可视化要求：由上一个显示的可视化调用的可视化已切换

框架选择类型
切换本地可视化	框架选择组可见
切换到任意可视化	框架和可视化选择组可见

要求：选中切换本地可视化。
框架选择	包含活动可视化的所有框架的列表。引用的可视化列在每个框架的下方,如相应框架的引用可视化属性中所确定. 例：
分配选择	框架选择输入字段接受的选择它将显示在所选框架和所选可视化设置中。要求：在框架选择输入字段中选择可视化。
选择框架	要切换的框架的名称例：MainArea 提示：使用分配选择命令更改此处的设置。
可视化选择	切换可视化的名称例：visMainArea 提示：使用分配选择命令更改此处的设置。

要求：选择切换任意可视化选项
框架和可视化选择	包含切换的框架
赋值	切换框架（带完整路径）索引确定可视化例：visMain.frameA.visB.frameB 路径以以下格式指定： <visualization name>.<frame name> { <visualization name>.<frame name> } 警告：可视化可以通过框架元素嵌套在任何深度。为了使用切换到任何可视化框架选择类型没有任何问题，框架不得包含超过21个参考的可视化。
分配表达式	变量（STRING）。包含切换框架的路径例：strFrane: STRING := 'visMain.frameA.visB.frameB';
索引选择	.确定显示哪个参考可视化的索引作为整数作为变量(整数数据类型) 例：PLC_PRG.iIndex 注意：框架的引用可视化按其排序顺序自动编入索引。

“输入配置”对话框