可视化元素：日期选择器

象征：

类别：日期/时间控件

该元素是一个显示当前日期的日历。用户可以单击某一天来选择一个日期，该日期将保存到一个变量中。此外，它还可以自定义日历显示的时间间隔。单击日历标题会更改年份。单击日历标题中的箭头会更改月份。

元素的语言相关文本

该元素包含在 System 文本列表。这涉及完整或缩写的月份名称和星期几。将日期选择器添加到可视化时，会在 POU 视图下方自动生成文本列表。 ID 对应于标准文本，因此对应于英文术语。文本列表使翻译这些文本成为可能。

例 41. 例子

System 文本列表

ID	默认
`Apr`	`Apr`
`April`	`April`

元素属性

所有元素属性都可用吗？

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

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

位置

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

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

提示

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

多变的

输入变量 (DATE）。包含用户在日历中选择的日期。

例子： PLC_PRG.dtDueDate

设计

从风格：所有设置都是根据样式预先配置的。
显式：这设计设置属性可用。您可以在此处自定义日历。

设计设置

要求：此属性仅在设计属性设置为显式.此设置允许您创建自定义的固定设计。

提示

如果设计已在样式中全局定义，则设计设置会自动分配这些样式值。

您可以显式更改这些值并从样式选择列表中选择其他值 () 或使用颜色选择器 () 以便您的元素显示在自定义主题中。

特性			描述
日期选择标题			头部的设计
	字体
	字体颜色		例子：日期选择标题字体颜色
	箭头
		指针颜色	例子：日期选择指针颜色
		打印箭头的颜色	例子：按下日期选择指针颜色
	背景
		绘制背景	从风格上：样式中全局定义的背景显示是的：背景填充有填充颜色财产。不：背景未填充颜色。
		填充颜色	要求：如果您选择了，则使用是的在绘制背景. 例子：日期选择标题背景颜色

主展示区			主展示区设计
	今天		今天的设计
		字体
		字体颜色	例子：日期选择当天字体颜色
		绘制背景	从风格上：样式中全局定义的背景显示是的：背景填充有背景颜色财产。不：背景未填充颜色。
		背景颜色	要求：如果您选择了，则使用是的在绘制背景. 示例：日期选择当前月份背景颜色
		显示框架	从风格上：框架在样式中被定义为全局。是的：框架将显示以下属性（框架颜色, 长方形, 行宽）。不: 不显示帧。
		框架颜色矩形类型行宽	要求：使用时是的被选中显示框架. 例子：灰色的例子：圆角矩形示例：1

选定日期		选定日期的设计
	字体
	字体颜色	例子：灰色的
	绘制背景	从风格上：样式中全局定义的背景显示是的：背景填充有背景颜色财产。不：背景未填充颜色。
	背景颜色	要求：如果您选择了，则使用是的在绘制背景.
	显示框架	从风格上：框架在样式中被定义为全局。是的：框架将显示以下属性（框架颜色, 长方形, 行宽）。不: 不显示帧。
	框架颜色矩形类型行宽	要求：使用时是的被选中显示框架.

这个月		选定月份的设计
	字体
	字体颜色	例子：灰色的
	绘制背景	从风格上：样式中全局定义的背景显示是的：背景填充有背景颜色财产。不：背景未填充颜色。
	背景颜色	要求：如果您选择了，则使用是的在绘制背景.
	显示框架	从风格上：框架在样式中被定义为全局。是的：框架将显示以下属性（框架颜色, 长方形, 行宽）。不: 不显示帧。
	框架颜色矩形类型行宽	要求：使用时是的被选中显示框架.

其他月份		前几个月和后几个月的设计
	字体
	字体颜色	例子：灰色的
	显示其他月份	从风格上: 前面和后面的月份按照样式中的定义显示。是的：以下属性应用于显示。不: 无显示
	绘制背景	从风格上：样式中全局定义的背景显示是的：背景填充有背景颜色财产。不：背景未填充颜色。
	背景颜色	要求：如果您选择了，则使用是的在绘制背景.
	显示框架	从风格上：框架在样式中被定义为全局。是的：框架将显示以下属性（框架颜色, 长方形, 行宽）。不: 不显示帧。
	框架颜色矩形类型行宽	要求：使用时是的被选中显示框架.

星期几标题		带有星期几的标题设计
	字体
	字体颜色	例子：灰色的
	绘制背景	从风格上：样式中全局定义的背景显示是的：背景填充有背景颜色财产。不：背景未填充颜色。
	背景颜色	要求：如果您选择了，则使用是的在绘制背景.
	显示框架	从风格上：框架在样式中被定义为全局。是的：框架将显示以下属性（框架颜色, 长方形, 行宽）。不: 不显示帧。
	框架颜色矩形类型行宽	要求：使用时是的被选中显示框架.
	显示分隔线	从风格上：分隔线在样式中被定义为全局。是的: 显示以下属性。不：不显示分隔线。
	分隔线的颜色分隔线宽度	使用时是的被选中显示分隔线.

背景		日历日的设计
	绘制背景	从风格上：样式中全局定义的背景显示是的：背景填充有填充颜色财产和陷害框架颜色. 不：背景未填充颜色。
	填充颜色
	框架颜色	例子：灰色的

显示类型

线条	每行的月历数（预设： `1`)
列	每列的月历数（预设： `1`)

状态变量

变量动态控制元素行为。

无形的

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

提示

您可以将变量组合到单位换算.

提示

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

动画

提示

这些属性仅在您选择了支持客户端动画和原生元素叠加中的选项可视化管理器.

动画时长

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

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

. 动画属性

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

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

移至前台

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

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

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

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

输入配置

属性包含使用鼠标或键盘时用户输入的配置。用户输入定义了一个事件和一个或多个在事件发生时执行的动作。

提示这配置按钮打开输入配置对话。您可以在那里创建或编辑用户输入。配置的用户输入列在事件下方。它们每个都包括触发的动作和简短形式的设置。例子：执行 ST 代码： `PLC_PRG.i_x := 0;`
OnDialogClosed	输入事件：用户关闭对话框。
鼠标点击	输入事件：用户在元素区域完全点击鼠标按钮。单击并释放鼠标按钮。
鼠标按下	输入事件：用户点击鼠标按钮。
OnMouseEnter	输入事件：用户将鼠标指针拖到元素上。
鼠标离开	输入事件：用户将鼠标指针拖离元素。
鼠标移动	输入事件：用户将鼠标指针移动到元素区域上。
OnMouseUp	. 输入事件：用户在元素区域内释放鼠标按钮。用户之前是否在元素区域内部或外部按下鼠标按钮是无关紧要的。用户在元素区域内按下鼠标按钮，离开元素区域，然后释放鼠标按钮。注意这 CODESYS- 特定的触发行为保证关键元素的动作完成。一个关键元素开始一个动作鼠标按下并结束动作 OnMouseUp. 示例：可视化用户在关键元素的元素区域内按下鼠标按钮，然后移动光标位置，使其位于元素区域之外。无论如何，该操作都结束了，因为 OnMouseUp 被触发。
OnValueChanged	由于值更改而触发后续操作的事件。在对话框中指定触发哪些后续动作输入配置配置。定义的后续操作和相关配置显示在元素属性下方。事件 OnValueChanged 可以由编译器定义 VISU_NO_VALUECHANGED 在应用程序的属性对话框中停用。

轻敲	当鼠标点击事件发生时，定义在多变的在应用程序中进行了描述。编码取决于点击错误和如果捕获，请点击输入选项。
多变的	要求：点击错误选项未激活。多变的（`BOOL`) 用于鼠标点击事件 `TRUE`: 存在鼠标点击事件。只要用户在元素上按下鼠标按钮，它就会持续。它在按钮被释放时结束。 `FALSE`: 鼠标点击事件不存在。例子： `PLC_PRG.bIsTapped`
点击错误	: 鼠标点击事件导致一个互补值多变的. `TRUE`: 鼠标点击事件不存在。 `FALSE`: 当鼠标点击事件存在时。
如果捕获，请点击输入	：在用户输入过程中，还考虑在按下鼠标按钮时是否在元素区域内拖动鼠标指针。 `TRUE`: 当鼠标点击事件存在并且鼠标指针移动到元素区域时。 `FALSE`: 鼠标点击事件不存在。或者用户在按下鼠标按钮时将鼠标指针移到元素区域之外。值为 `TRUE` 一旦用户将指针移回元素区域，就会再次出现。然后捕获鼠标。

切换

随着鼠标点击事件的发生，变量被设置；当鼠标点击事件完成时，变量被重置。

多变的

多变的（BOOL) 用于在鼠标单击事件结束时进行切换

这是当鼠标指针位于元素区域上时用户释放鼠标按钮。如果用户在鼠标指针位于元素区域之外时释放鼠标按钮，则鼠标单击事件不会结束，值不会切换。

提示

用户可以通过将鼠标指针拖出元素区域来取消已启动的切换输入。

如果捕获则打开

standard icon ：无论释放鼠标按钮时鼠标指针在哪里，该值都会切换。然后捕获鼠标。

热键	用于触发特定输入操作的元素上的快捷方式当热键事件发生时，在活动属性被触发。这样，导致这个输入动作的不是输入动作本身，而是鼠标输入动作。
钥匙	按键输入动作。例子：吨选择键时会出现以下属性。
活动	没有鼠标向下: 按键触发输入动作鼠标按下财产。鼠标向上：松开按键会触发在 OnMouseUp 财产。鼠标向下/向上：按下和释放键触发在配置的输入动作鼠标按下财产和 OnMouseUp 财产。
切换	：与“Shift”键组合例子：转移+吨.
控制	: 与“Ctrl”键组合例子： Ctrl+吨.
Alt	：与“Alt”键组合例子： Alt+吨.

提示

可视化中配置的所有键盘快捷键及其操作都列在键盘配置标签。

访问权

注意

仅当为可视化设置用户管理时可用。

访问权按钮

打开访问权对话。您可以在此处编辑元素的访问权限。

. 状态消息：

没有设置。完全权利。：所有用户组的访问权限：可操作
权利已设定：有限权利: 至少有一组限制访问。

本节内容如下:

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