Skip to main content

对话框：输入配置

象征： _visu_icon_input_configuration.png

功能：该对话框允许您为输入事件分配输入操作并配置输入操作。

称呼： 配置 按钮 输入配置 财产

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

所有元素属性都可用吗？

只有在您选择 “” 后，所有属性才可用 高级 选项或 所有类别 过滤 特性。

输入动作：用户管理

对话框和动作

配置哪个可能的用户管理对话框或哪个操作跟随输入事件

注意

运行时使用的对话框在 对话框设置 可视化管理器的选项卡。

. 也可以看看

  • 登录对话框

  • 更改密码对话框

  • 更改配置对话框

默认值：来自 VisuUserManagement 图书馆

登录

登录提示打开。

默认： VisuUserManagement.VUM_Login 在 登录对话框

登出

当前用户已注销。

更改用户密码

更改密码的对话框打开。

默认： VisuUserManagement.VUM_ChangePassword 在 更改密码对话框

打开用户配置

对话框打开以更改配置。

默认： VisuUserManagement.VUM_UserManagement 在 更改配置对话框

输入动作：关闭对话框

对话

类型的可视化 对话 这将被关闭

_visu_icon_open_list.png: 全部列表框 对话 项目中可用的类型可视化

例子：

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

  • FileOpenSave

  • Keypad

  • Login

  • Numpad

  • NumpadExtended

  • TextinputWithLimits

注意

对象属性中的设置 (可视化 可视化的选项卡）确定可视化是否可以用作对话框。

结果

关闭对话框的返回值

注意

如果关闭后还有更多的输入动作，那么他们在 输入配置 → OnDialogClosed 元素的属性。

没有

standard icon: 没有返回值

好的

standard icon：返回设置的返回值。

返回值是指对话框中的按钮。价值 OK 为确定按钮返回。价值 Cancel 为取消按钮返回。

取消

中止

重试

忽视

是的

不

输入动作：打开对话框

对话

可视化的名称（类型： 对话) 在可视化用户触发输入操作后，它将在运行时作为对话框打开

_visu_icon_open_list.png：项目中所有可用对话框的列表框。

注意

这 VisuDialogs 库提供标准对话框。

  • VisuDialogs.FileOpenSave

  • VisuDialogs.Login

传递对话框的参数

参数

在可视化界面编辑器中声明的界面参数

例子： filelistProvider

类型

可视化界面编辑器中声明的参数数据类型

例子： VISU_FBFILELISTPROVIDER

价值

变量（数据类型对应参数的数据类型）

当对话框打开时，变量的值被传递给参数。

例子： PLC_PRG.fileListProvider // Instance of function block VisuDialogs.Visu_FbFileListProvider

_visu_icon_open_input_assistant.png：输入助手提供整个项目中可用的所有变量。

这里对话框的返回值被激活， Var_OUTPUT 变量和 VAR_IN_OUT 变量被写入。对话框随后关闭。

更新_cds_icon_output_channel.png和_visu_icon_inout_parameter.png在结果的情况下

注意

参数在对话框关闭之前更新。在此之前，这些值将被临时存储。它们存储为副本，而不是参考。

没有

standard icon: 没有返回值

好的

standard icon：定义为其写入传输参数的返回值

取消

中止

重试

忽视

是的

不

打开对话框模式

standard icon：在运行时，只有对话框处理用户输入。出现在对话框之外的用户输入将被忽略。那里的用户界面被阻止。

开仓

打开对话框相对于调用可视化的初始位置

居中

_cds_icon_radiobutton_activated.png：对话框显示在中央。

位置

_cds_icon_radiobutton_activated.png：对话框显示在下面设置的位置。

注意：使用相应的输入选项指定 X 方向和 Y 方向的位置。

X

打开对话框左上角的水平 X 位置

输入选项：

  • 固定（以像素为单位）

  • 作为 IEC 变量（整数数据类型）

  • 占位符： ElementRectangle.ptTopLeft.iX

    占位符替换为元素左上角的位置。

  • 占位符：ElementRectangle.ptBottomRight.iX

    占位符被替换为元素右下角的位置。

Y

打开对话框左上角的垂直 Y 位置

输入选项：

  • 固定（以像素为单位）

  • 作为 IEC 变量（整数数据类型）

  • 占位符： ElementRectangle.ptTopLeft.iY

    运行时，对话框显示在调用元素的左上角位置

  • 占位符：ElementRectangle.ptBottomRight.iY

    占位符被替换为元素右下角的位置。

输入动作：更改语言

客户端相关语言

可以为每个客户端单独切换语言。要求是 CODESYS Visualization 插件至少安装在版本 4.7.0.0 中，运行时系统版本 >= V3.5 SP20。启动可视化时，将以浏览器中设置的语言显示（例如， 德 或者 英文)。此语言必须在项目中可用。如果该语言不可用，则显示默认文本。

在 4.6.0.0 及更低版本中，所有客户端的语言均同时切换。

语言代码

使用 ISO 639 代码（例如，de、en、it、zh-CHS）来命名可视化中存在的语言。

语言

当前可视化客户端切换至的语言

例子： en

_visu_icon_open_input_assistant.png：输入助手提供项目中可用的所有语言。

输入操作：更改显示的可视化

表 110. 缩放到可视化

在用户输入处显示的可视化

分配

从项目或库中的所有可用可视化中选择的可视化。

例子： visMain

赋值表达式

多变的 （STRING) 包含可视化的名称

例子： PLC_PRG.strVisu 对于以下应用程序代码： strVisu: STRING := 'visMain';

用户输入显示可视化的顺序在内部保存。以下选项使用此信息。

先前显示的可视化

standard icon：在当前之前已经显示的可视化

要求：已发生可视化切换。

下一个显示的可视化

standard icon：在当前调用顺序之后的下一个可视化

要求：已经发生了一个被调用的可视化切换 先前显示的可视化.



输入动作：执行命令

此处列出了命令以及在输入事件发生时可视化处理的传输参数。

配置命令

_visu_icon_open_list.png

  • 在plc上执行程序

  • 在客户端执行程序

  • 打印

  • 导航到 URL (WebVisu)

  • 创建食谱

  • 阅读食谱

  • 写食谱

  • 将配方写入文件

  • 从文件加载配方

  • 删除配方

点击 _visu_icon_add.png 符号将选定的命令添加到下方的命令列表中。

_visu_icon_add.png

中的命令 配置命令 被添加到列表中。

_visu_icon_remove_command.png

该命令被删除。

要求：选择了一个命令。

列表中的顺序定义了执行的顺序。

_visu_icon_down_command.png

所选命令在列表中下移一位。

_visu_icon_up_command.png

所选命令在列表中上移一位。

表 111. 命令：在plc上执行程序

命令

第一个参数

第二个参数

ExecutePlcProgram

'C:\programs\notepad.exe'

'Notes_A.txt'

在控制器上执行的 EXE 文件

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

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

带有目录的程序名称作为单引号中的字符串

程序的参数作为单引号中的字符串

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



表 112. 命令：在客户端执行程序

命令

一、参数

2.参数

ExecuteClientProgram

'C:\programs\notepad.exe'

'Notes_A.txt'

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

该程序在显示变量的上下文中执行。此后，该程序可以是交互式的并具有用户界面。

目录为的程序名称 STRING 在单直引号中

程序的参数为 STRING 在单直引号中

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



重要

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

表 113. 命令：导航到 URL (WebVisu)

命令

一、参数

2.参数

NavigateURL

'http://en.wikipedia.org'

PLC_PRG.stURL

'replace'

可视化导航到 URL 的网页。

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

. 网址

  • 作为单直引号中的文字

  • 作为变量（字符串）

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

如果 'replace' 被指定，那么 CODESYS WebVisu 被网页取代。



表 114. 命令：阅读食谱

命令

第一个参数

第二个参数

ReadRecipe

'RecipeDefinitionForModules'

'RecipeModuleA'

. 配方定义的名称

  • 作为字面意思

  • 作为变量 (STRING)

. 配方名称

  • 作为字面意思

  • 作为变量 (STRING)

在可视化运行时，控制器从配方定义的变量中读取实际值并将它们写入指定的配方。这些值被隐式保存（到控制器上的文件）并显示在配方管理器的配方定义中 CODESYS.换句话说，管理的配方 CODESYS 使用来自控制器的值进行更新。



表 115. 命令：写食谱

命令

一、参数

2.参数

WriteRecipe

PLC_PRG.stRecipeDef

PLC_PRG.stRecipe

. 受影响配方定义的名称

  • 作为字面意思

  • 作为变量 (STRING)

. 配方名称（来自配方定义）

  • 作为字面意思

  • 作为变量 (STRING)

在可视化运行时，配方的值被写入控制器上的变量，就像它们在配方管理器中一样。



表 116. 命令：将配方保存在文件中

命令

一、参数

2.参数

SaveRecipeAs

PLC_PRG.stRecipeDef

PLC_PRG.stRecipe

. 受影响配方定义的名称

  • 作为字面意思

  • 作为变量 (STRING)

. 更新并保存到文件中的受影响配方的名称

  • 作为字面意思

  • 作为变量 (STRING)

可选参数：如果您未在此处指定传输参数，则配方变量中的值仅保存在稍后指定的文件中。隐式配方文件不会更新。

在可视化运行时， 将食谱另存为 对话框打开并提示用户输入文件名和控制器上的存储位置。文件名不得为 <recipe>.<recipe definition>.文件扩展名为 .txtrecipe.

然后，用户可以保存包含来自配方变量的实际值的文件。如果传输参数是 不是 在第二个参数中指定，然后保存文件而不更改隐式配方文件。如果在第二个参数中给出了传输参数，那么隐式配方文件也会被更新。

注意：如果 将配方更改自动保存到配方文件 选项被选中 配方管理器 - 一般 选项卡，然后是配方定义 CODESYS 并且隐式配方文件自动保持不变。

注意：控制器上存在隐式（自动生成的）配方文件，其名称采用以下语法： <recipe>.<recipe definition>.txtrecipe.这些通常在应用程序中用作读取和写入配方变量时的缓冲区。



表 117. 命令：从文件加载配方

命令

第一个参数

第二个参数

LoadRecipeFrom

PLC_PRG.stReccipeDef

PLC_PRG.stReccipe

. 受影响配方定义的名称

  • 作为字面意思

  • 作为变量 (STRING)

. 受影响配方的名称

  • 作为字面意思

  • 作为变量 (STRING)

在可视化运行时， 加载配方 对话框打开。它为可视化用户提供位于控制器文件系统中并按扩展名过滤的文件列表 txtrecipe.下载选定的文件。然后将文件中的配方写入隐式文件并读取到配方管理器的配方定义中的给定配方。

要求：文件是用 SaveRecipeAs 命令。



表 118. 命令：创建配方

命令

一、参数

2.参数

CreateRecipe

PLC_PRG.stRecipeDef

PLC_PRG.stRecipe_New

. 受影响配方定义的名称

  • 作为字面意思

  • 作为变量（字符串）

. 新配方的名称

  • 作为字面意思

  • 作为变量（字符串）

在可视化运行时，在给定的配方定义中创建一个新的配方。



表 119. 命令：删除配方

命令

一、参数

2.参数

DeleteRecipe

PLC_PRG.stRecipeDef

PLC_PRG.stRecipe

. 受影响配方定义的名称

  • 作为字面意思

  • 作为变量 (STRING)

. 配方名称

  • 作为字面意思

  • 作为变量 (STRING)

在可视化运行时，从配方定义中删除指定的配方。



表 120. 命令：打印

命令

一、参数

2.参数

Print

可选：要打印的可视化屏幕的文件名（例如：“开始屏幕”）

不能为第二个参数指定 Print 命令。

默认 打印机 可视化运行时打开对话框。在对话框中，您可以选择一台打印机并配置其他打印设置。当您确认对话框时，将打印当前显示的可视化屏幕。

注意

该命令只能在 TargetVisu 中执行。



输入动作：切换帧可视化

当输入事件发生时，显示切换到一帧内的另一个可视化。

框架选择类型

切换本地可视化

这 帧选择 组可见。

切换到任何可视化

这 框架和可视化选择 组可见。

要求： 切换本地可视化 被选中。

帧选择

包含活动可视化的所有框架的列表。参考的可视化列在每帧下方，如在 参考 相应框架的属性。

例子：

_visu_img_frame_selection.png

分配选择

中的选择 帧选择 输入字段被接受。然后出现在 选定的框架 和 选定的可视化 设置。

要求：在 帧选择 输入字段。

选定的帧

要切换到的帧的名称

例子： 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

注意：框架的引用可视化会根据它们的顺序自动索引。

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

输入动作：写变量

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

输入类型

如何提示输入

默认

输入字段，或者如果需要虚拟键盘（如果显示变体没有物理键盘）

注意：运行时文本输入的默认选项在可视化管理器中设置： 对话框设置 标签， 默认文本输入的设置.

文字输入

将显示一个输入字段。作为可视化用户，您可以使用键盘指定数字或文本。

要求：显示器变体有一个键盘作为输入设备。

有限制的文本输入

将显示一个输入字段。您可以使用键盘指定数字或文本。该字段还显示输入的值范围。超过限制时，输入值显示为红色。

要求：显示器变体有一个键盘作为输入设备。

VisuDialogs.Keypad

一个虚拟键盘打开。您可以使用它来指定数字或文本。

VisuDialogs.Numpad

一个虚拟键盘打开。你用它来指定一个数字。

VisuDialogs.NumpadExtended

一个虚拟键盘打开。你用它来指定一个数字。这里也允许使用十六进制和指数表示法。

选择要编辑的变量

使用文本输出变量

_cds_icon_radiobutton_activated.png：输入值被写入元素的文本输出变量。这是在 文本变量 → 文本 财产。

使用另一个变量

_cds_icon_radiobutton_activated.png: 写入输入值的变量。

例子： PLC_PRG.iVariable

初始显示格式

具有格式定义的占位符。它定义了变量值的输出格式和输入限制。

例子： %2.3f 用于将值显示为小数部分。

敏

. 输入限制的最小值。如果用户指定较小的值，则不接受。

  • 作为固定值

  • 作为变量（数据类型对应于所选变量）

最大限度

. 输入限制的最大值。如果用户指定了更大的值，则不接受。

  • 作为固定值

  • 作为变量（数据类型对应于所选变量）

对话框标题

. 显示在对话框标题栏中的文本。可选的。

  • 作为固定字符串

    例子： Insert value

  • 作为变量 (STRING)

    例子： PLC_PRG.stTitle : STRING := 'Insert value';

密码字段

standard icon： *** 显示而不是输入文本。

打开输入对话框的位置

打开输入对话框相对于调用可视化的初始位置

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

要求：此选项仅在显示在 TargetVisu 上或作为 WebVisu 时可用。

_cds_icon_radiobutton_activated.png：在可视化管理器中设置的位置 对话框设置 使用选项卡。

居中

_cds_icon_radiobutton_activated.png：对话框显示在中央。

位置

_cds_icon_radiobutton_activated.png：对话框显示在下面设置的位置。

注意：使用相应的输入选项指定 X 方向和 Y 方向的位置。

X

打开对话框左上角的水平 X 位置

输入选项：

  • 固定（以像素为单位）

  • 作为 IEC 变量（整数数据类型）

  • 占位符： ElementRectangle.ptTopLeft.iX

    占位符替换为元素左上角的位置。

  • 占位符：ElementRectangle.ptBottomRight.iX

    占位符被替换为元素右下角的位置。

Y

打开对话框左上角的垂直 Y 位置

输入选项：

  • 固定（以像素为单位）

  • 作为 IEC 变量（整数数据类型）

  • 占位符： ElementRectangle.ptTopLeft.iY

    占位符替换为元素左上角的位置。

  • 占位符：ElementRectangle.ptBottomRight.iY

    占位符被替换为元素右下角的位置。

输入动作：执行 ST 代码

输入栏

作为结构化文本的代码编辑器

输入动作：切换变量

多变的

多变的 （BOOL) 在输入事件发生时切换

例子： PLC_PRG.bSwitch

输入动作：文件传输

随着 文件传输 输入动作，文件可以从操作变量（目标或网络可视化）传输到 PLC 以及从 PLC 传输。这可以通过文件传输（类型： 文件) 或流式传输 (类型： 流媒体）。

该操作具有在运行时在可视化中显示文件选择对话框的效果。在那里，可视化用户可以选择将传输到 PLC 或从 PLC 传输的文件：对于从 PLC 传输到可视化， 保存存档 对话框打开。对于从可视化到 PLC 的传输， 打开文件 对话框打开。

转移

方向

文件传输方向

从 PLC 到可视化

中指定的对象 文件名 要么 流式传输实例名称 从 PLC 传输到可视化。

这 保存存档 文件选择对话框在运行时显示在可视化中。

从可视化到 PLC

可视化用户指定的文件被传送到 PLC 并保存在指定的文件路径中 文件名 要么 流式传输实例名称.

这 打开文件 文件选择对话框在运行时显示在可视化中。

类型

. 确定文件的传输方式

  • 传输类型 文件: 通过文件传输

  • 传输类型 流媒体: 通过流式传输

类型

文件

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

文件名

文件路径（类型 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

注意

在用户指定文件路径的情况下，应由应用程序检查，以防止文件被意外读取或覆盖。

类型

流媒体

数据传输是通过流式传输完成的。

流式传输实例名称

实例路径（类型 IVisuStreamWriter 要么 IVisuStreamReader) 描述控制器文件系统中的对象

类型 IVisuStreamReader 用于传输方向 从 PLC 到可视化

类型 IVisuStreamWriter 用于传输方向 从可视化到 PLC

控制标志

注意：该变量仅针对传输方向进行评估 从可视化到 PLC.

变量（类型 DWORD)

确定如何在 PLC 的文件系统上处理对象（文件或实例对象）。为此提供了两个可以设置变量的标志。

  • 标志 1： VisuElems.VisuEnumFileTransferControlFlags.UseOriginalFileName

  • 标志 2： VisuElems.VisuEnumFileTransferControlFlags.ConfirmFileOverwriteInPlc

. 选项

  • 未设置标志：

    用户选择保存在指定路径中的文件 文件名 要么 流式传输实例名称.

  • 设置标志 1：

    用户在可视化运行时指定的路径被应用并用作 PLC 文件系统中的路径。

  • 两个标志都设置：

    路径也被检查。如果在客户端指定的路径中已经存在对象，则在可视化中显示消息提示。在那里，可视化用户可以确认文件将被覆盖。

例子： dwControlFlag

例 49. 例子

传输方向为 从可视化到 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


状态变量

转移活跃

布尔变量（可选）

TRUE: 正在传输。

转账成功

布尔变量（可选）

TRUE: 传输成功。

错误代码

  • 0: 没有错误

  • 1：未指定的错误

  • 2：取消文件对话框

  • 3: 其他文件传输中

  • 4: 文件传输出错

  • 5: 超时取消

  • 6: 文件读取错误 – 文件不可用或无法读取。

  • 7: 没有设备支持文件传输

    可能的原因：

  • CODESYS WebVisu：默认情况下无法进行文件传输。

  • 与版本 < 3.5.11 的控制器通信：未实现功能。

  • 与版本 >= 3.5.11 的控制器通信：文件传输未激活（设备描述）。

    提示

    CODESYS 在项目设置中管理此设置。

使用本地可视化文件

要求：选项可用时 将可视化文件传输到 PLC 已指定为方向。

  • _cds_icon_option_deactivated.png：立即显示操作系统的文件选择对话框（默认为最近创建的输入操作）。

  • _cds_icon_option_black_activated.png：默认情况下可用的文件传输对话框将打开并提示您选择文件。您可以调整对话框。

    提示：对话框可能显示在不方便的位置，并且对话框布局与 Web 可视化界面的布局不对应。

本节内容如下:
参见: