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

象征：

类别：日期/时间控件

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

元素属性

所有元素属性都可用吗？

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

元素名称	例子： `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

. 动画属性

绝对运动, 移动, X, 是
绝对运动, 回转
绝对运动, 内部旋转
绝对运动, 外旋

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

移至前台

多变的（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`. 在运行时，元素围绕指定的旋转点旋转中心根据变量的值。此外，元素的对齐方式会根据可视化的坐标系进行旋转。增加代码中的值会顺时针旋转。旋转点如图所示象征。注意如果在位置→角度属性，然后在执行可视化时将静态旋转角度添加到可变旋转角度（偏移量）中。