可视化元素：日期/时间选择器

象征：

类别：日期/时间控件

该元素允许可视化用户选择带有时间的日期（在日历中）。

元素属性

所有元素属性都可用吗？

仅当您选择先进的选项或所有类别过滤特性。

元素名称	例子： `StartDateAndTime` 提示为元素分配单独的名称，以便在元素列表中更快地找到它们。
元素类型	日期/时间选择器

位置

位置定义了元素在可视化窗口中的位置和大小。它基于笛卡尔坐标系。原点位于窗口的左上角。水平 X 轴正方向向右。垂直 Y 轴正方向向下。

X	元素左上角的 X 坐标（以像素为单位）例子：`10`
Y	元素左上角的 Y 坐标（以像素为单位）例子：`10`
宽度	以像素为单位例子：`150`
高度	以像素为单位例子：`30`

提示

您可以通过拖动运算块来更改值符号到编辑器中的其他位置。

多变的

多变的	选修的多变的（`DATE, DT, LDATE, LDT, LTIME, LTOD, TIME, TOD`）表示日期和时间值如果没有配置变量，则该元素自动显示系统时间。可视化用户可以调整该值。 . 数据类型自动决定显示值的单位： `DATE`：年、月、日 `DT`：年、月、日、时、分、秒 `LTIME`：日、时、分、秒（默认不显示毫秒、微秒、纳秒） `TIME`：日、时、分、秒（默认不显示毫秒） `TOD`：时、分、秒（默认不显示毫秒）
格式字符串	重要如果元素应以世界时 (UTC) 显示系统时间，则需要确保变量 `VisuElems.Visu_DateTime.DisplayUTC` 设置为 `TRUE` 在应用程序中。您还可以使用格式选项调整世界时间 (UTC) 的显示 `Z`。格式化日期和时间值的显示，例如，显示可以限制为时间单位指定格式字符串的选项作为固定字符串例子： `yyyy-dd-MM` 作为对文本列表条目 <文本列表名称>.<ID> 的引用每种语言的格式字符串都有定义。示例 `LTIME` 带有格式字符串的变量 `HH:mm:ss.ms.us.ns` –> 显示：08：15：12.780.150.360 `LTIME` 具有限制格式字符串的变量 `HH:mm` –> 显示：08:15 `DATE` 带有格式字符串的变量 `yyyy/MM/dd` –> 显示：2015/12/17 如果未指定值多变的和变量 `VisuElems.Visu_DateTime.DisplayUTC = TRUE` 由程序控制设置，格式字符串包含 Z 标识符（`dd:MM:yyyy HH:mm:ss:ms:Z`），则输出世界时（`01.08.2021 10:12:03:450:Z`）。如果未指定值多变的和变量 `VisuElems.Visu_DateTime.DisplayUTC = FALSE` 由程序控制设置，格式字符串包含 Z 标识符（`dd:MM:yyyy HH:mm:ss:ms:Z`），则输出的本地时间与世界时存在偏差（`01.08.2021 10:12:03:450:+02:00` ） `DateTime.DTPicker` （文本列表条目）对于应用程序中的每种语言，文本列表条目都引用一个格式字符串。注意基本上，所有 `%t` 支持格式选项，具体描述见“具有格式定义的占位符”章。提示您可以通过编程将系统时间的本地时区切换为世界时间 (UTC)。当变量 `VisuElems.Visu_DateTime.DisplayUTC` 设置为 `TRUE`，系统时间显示为世界时（UTC）。默认情况下，变量 `VisuElems.Visu_DateTime.DisplayUTC` 设置为 `FALSE` 使系统时间显示为当地时区。对于日期和时间值的显示，您可以扩展相应的格式字符串带有时区代码 `Z`。对于本地系统时间的输出，偏移量将以世界时 (UTC) 显示。例如， `dd:MM:yyyy HH:mm:ss:ms:Z` 输出 `01.08.2021 12:00:00:001:+02:00`显示世界时间（UTC）时，也会显示UTC代码。 `01.08.2021 10:00:00:001:Z`
设计日期/时间选择器	从风格上：所有设置均根据风格预先配置。显式：这设计设置属性可用。您可以在此处自定义日历。
设计日期选择器	从风格上：所有设置均根据风格预先配置。显式：这设计设置属性可用。您可以在此处自定义日历。
定位日期选择器	动态的：日历自动调整并定位。手动的：这位置设置属性可用。您可以在此处自定义日历。

状态变量

变量动态控制元素行为。

无形的

多变的（BOOL) 用于切换元素的可见性

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

例子： bIsVisible 和 VAR bIsVisible : BOOL := FALSE; END_VAR

停用输入

多变的（BOOL) 用于切换元素的可操作性

TRUE：用户输入在运行时没有任何影响。该元素显示为已停用。

提示

这无形的 “客户端动画”功能支持属性。

中心

	这些属性包含旋转点坐标的固定值。旋转点在编辑器中显示为符号并作为旋转和缩放的中心。提示您还可以通过拖动符号移动到编辑器中的另一个位置。
X	旋转点的 X 坐标
Y	旋转点的 Y 坐标

绝对运动

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

移动
X	X 位置的变量（数字数据类型）（以像素为单位）例子： `PLC_PRG.iPos_X`. 容器变量： `Container.Width` 有关详细信息，请参阅：优化调整位置和大小在运行时增加此值会使元素向右移动。
Y	Y 位置的变量（数字数据类型）（以像素为单位）例子： `PLC_PRG.iPos_Y`. 容器变量： `Container.Height` 有关详细信息，请参阅：优化调整位置和大小在运行时增加此值会使元素向下移动。
回转	旋转角度的变量（数字数据类型）（以度为单位）例子： `PLC_PRG.iAngle1`. 元素的中点在中心观点。该旋转点显示为象征。在运行时，元素的对齐相对于可视化的坐标系保持不变。增加该值会使元素向右旋转。
缩放	用于触发中心拉伸的变量（整数数据类型）例子： `PLC_PRG.iScaling` 参考点是中心财产。价值 `1` 将元素缩小一个因子 `0.001`.价值 `1000` 将元素返回到其原始大小。
内部旋转	旋转角度的变量（数字数据类型）（以度为单位）例子： `PLC_PRG.iAngle2`. 在运行时，元素围绕指定的旋转点旋转中心根据变量的值。此外，元素的对齐方式会根据可视化的坐标系进行旋转。增加代码中的值会顺时针旋转。旋转点如图所示象征。注意如果在位置→角度属性，然后在执行可视化时将静态旋转角度添加到可变旋转角度（偏移量）中。

提示

您可以将变量组合成单位换算。

提示

这 X, 是, 回转，和内部旋转 “客户端动画”功能支持属性。

动画片

提示

仅当您选择了支持客户端动画和原生元素叠加选项可视化管理器。

动画持续时间

元素运行动画的持续时间（以毫秒为单位）的变量

变量（整数值）
例子：Menu.tContent和VAR tContent : INT := 500; END_VAR
整数文字
例子：500

. 可动画的属性

绝对运动，移动，十，是
绝对运动，旋转
绝对运动，内旋
绝对运动，外旋

当可动画属性的至少一个值发生变化时，就会执行动画移动。此时执行的移动不会出现抖动，而是在指定的动画时长内保持平滑。可视化元素会动态旋转并移动到指定位置。过渡非常流畅。

移至前台

多变的（BOOL）用于将元素设置在前景中

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

FALSE：在运行时，可视化元素显示在可视化编辑器中插入它的层中。

例子：bIsInForeground和VAR bIsInForeground : BOOL := FALSE; END_VAR

输入配置

提示

这配置按钮打开输入配置对话。您可以在此处为事件分配后续操作。

OnValueChanged

由于值的变化而触发后续动作的事件

触发哪些后续动作在输入配置对话。

定义的后续动作和相应的配置显示在元素属性下方。

这 OnValueChanged 事件可以被禁用 VISU_NO_VALUECHANGED 编译器在应用程序的属性对话框中定义。

权限

注意

仅当设置了用户管理以实现可视化时才可用。

访问权限按钮

打开访问权限对话框。您可以在那里编辑元素的访问权限。

. 状态消息：

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

本节内容如下:

X	元素左上角的 X 坐标（以像素为单位）例子：`10`
Y	元素左上角的 Y 坐标（以像素为单位）例子：`10`
宽度	以像素为单位例子：`150`
高度	以像素为单位例子：`30`

移动
X	X 位置的变量（数字数据类型）（以像素为单位）例子： `PLC_PRG.iPos_X`. 容器变量： `Container.Width` 有关详细信息，请参阅：优化调整位置和大小在运行时增加此值会使元素向右移动。
Y	Y 位置的变量（数字数据类型）（以像素为单位）例子： `PLC_PRG.iPos_Y`. 容器变量： `Container.Height` 有关详细信息，请参阅：优化调整位置和大小在运行时增加此值会使元素向下移动。
回转	旋转角度的变量（数字数据类型）（以度为单位）例子： `PLC_PRG.iAngle1`. 元素的中点在中心观点。该旋转点显示为象征。在运行时，元素的对齐相对于可视化的坐标系保持不变。增加该值会使元素向右旋转。
缩放	用于触发中心拉伸的变量（整数数据类型）例子： `PLC_PRG.iScaling` 参考点是中心财产。价值 `1` 将元素缩小一个因子 `0.001`.价值 `1000` 将元素返回到其原始大小。
内部旋转	旋转角度的变量（数字数据类型）（以度为单位）例子： `PLC_PRG.iAngle2`. 在运行时，元素围绕指定的旋转点旋转中心根据变量的值。此外，元素的对齐方式会根据可视化的坐标系进行旋转。增加代码中的值会顺时针旋转。旋转点如图所示象征。注意如果在位置→角度属性，然后在执行可视化时将静态旋转角度添加到可变旋转角度（偏移量）中。