显示文本、数字、日期或货币等数据的框。
Description
标签显示指定为文本文本字符串的数据,该字符串的显示方式与键入方式完全相同,或者作为计算结果为文本字符串的公式。 标签通常出现在任何其他控件之外(例如标识屏幕的横幅),作为标识其他控件(如分级或音频控件)的标签,或在库中显示有关项目的特定类型信息。
键属性
AutoHeight – 设置为 true 以允许标签自动增长其高度以显示所有文本。 设置为 false,将文本截断为分配的高度。
颜色 – 控件中的文本颜色。
字体 – 显示文本的字体系列的名称。
文本 - 显示在控件上或用户键入控件的文本。
DelayOutput – 设置为 true 以在文本输入期间延迟作。
其他属性
对齐 - 文本相对于其控件的水平中心的位置。
AutoHeight – 如果标签的 Text 属性包含的字符多于控件一次可以显示的字符,则标签是否自动增加其 Height 属性。 如果控件不可见,则当文本更改时,输出属性 Height 将不会更新。
BorderColor – 控件边框的颜色。
BorderStyle – 控件的边框是 Solid、 Dashed、 Dotted 还是 None。
BorderThickness – 控件边框的粗细。
DisplayMode – 控件是否允许用户输入(编辑)、仅显示数据(视图)或已禁用(已禁用)。
DisabledBorderColor – 如果控件的 DisplayMode 属性设置为 Disabled,则控件边框的颜色。
DisabledColor – 控件中的文本颜色(如果控件的 DisplayMode 属性设置为 Disabled)。
DisabledFill – 控件的 DisplayMode 属性设置为 Disabled 时的背景色。
填充 – 控件的背景色。
FocusedBorderColor – 当控件聚焦时控件边框的颜色。
FocusedBorderThickness – 当控件聚焦时控件边框的粗细。
FontWeight – 控件中文本的粗细: 粗体、 半曲、 普通或 较轻。
高度 – 控件的上边缘和下边缘之间的距离。
HoverBorderColor – 当用户在该控件上保留鼠标指针时控件边框的颜色。
HoverColor – 当用户将鼠标指针放在控件上时,控件中文本的颜色。
HoverFill – 当用户将鼠标指针放在控件上时,控件的背景色。
斜体 – 控件中的文本是否为斜体。
LineHeight – 列表中的文本或项目行之间的距离。
实时 – 屏幕阅读器如何读出对标签的 Text 属性值的更改。
- 设置为 “关闭”时,屏幕阅读器不会报出更改。
- 设置为 “礼貌”时,屏幕阅读器在宣布屏幕阅读器说话时发生的任何更改之前,将完成朗读。
- 设置为 Assertive 时,屏幕阅读器会中断自身,以宣布屏幕阅读器说话时发生的任何更改。
OnSelect – 当用户点击或单击控件时要执行的作。
Overflow – 如果滚动条的 Wrap 属性设置为 true ,并且控件的 Text 属性的值包含的字符数超过控件一次可以显示的字符数,则是否显示在标签中。
PaddingBottom – 控件中的文本与该控件的下边缘之间的距离。
PaddingLeft – 控件中的文本与该控件的左边缘之间的距离。
PaddingRight – 控件中的文本与该控件右边缘之间的距离。
PaddingTop – 控件中的文本与该控件的上边缘之间的距离。
PressedBorderColor – 当用户点击或单击该控件时控件边框的颜色。
PressedColor – 当用户点击或单击该控件时控件中的文本颜色。
PressedFill – 当用户点击或单击该控件时控件的背景色。
角色 - 标签文本的语义角色,如标题 1。 不会更改标签的样式,而是使输出语义正确,供屏幕阅读器解释。
大小 – 控件上显示的文本的字号。
删除线 – 是否通过控件上显示的文本显示线条。
TabIndex – 相对于其他控件的键盘导航顺序。
工具提示 – 当用户将鼠标悬停在控件上时出现的解释性文本。
下划线 – 是否在控件上显示的文本下显示一行。
VerticalAlign – 控件上与该控件的垂直中心相关的文本位置。
可见 – 控件是显示还是隐藏。
宽度 – 控件的左边缘和右边缘之间的距离。
换行 – 文本是否应换行到多行。
X – 控件的左边缘与其父容器的左边缘之间的距离(如果没有父容器时显示屏幕)。
Y – 控件的上边缘与父容器的上边缘之间的距离(如果没有父容器时屏幕)。
相关函数
例子
显示文本字符串
显示公式的结果
添加标签,并将其 Text 属性设置为公式,如以下公式:
今天()注释
指定公式时,除非公式的参数是文本字符串,否则不要使用引号。 在这种情况下,请将参数(而不是公式)括在双引号中。
在库中显示数据
在此过程中,你将创建一个名为 CityPopulations 的集合,其中包含有关欧洲各城市人口的数据。 接下来,你将在包含三个标签的库中显示数据,并指定每个标签将显示的数据类型。
添加一个按钮,然后将其 OnSelect 属性设置为以下公式:
ClearCollect(CityPopulations, {City:“London”, Country:“United Kingdom”, Population:8615000}, {City:“Berlin”, Country:“Germany”, Population:3562000}, {City:“Madrid”, Country:“Spain”, Population:3165000}, {City:“Rome”, Country:“Italy”, Population:2874000}、 {City:“Paris”, Country:“France”, Population:2273000}, {City:“Hamburg”, Country:“Germany”, Population:1760000}, {City:“Barcelona”, Country:“Spain”, Population:1602000}, {City:“Munich”, Country:“Germany”, Population:“Germany”:1494000}, {City:“米兰”, 国家:“意大利”, 人口:1344000})按 F5,选择按钮,然后按 Esc。
添加文本库,并将其 Items 属性设置为 CityPopulations。
选择库后,右窗格会显示该库的选项。
在 “库 1 ”窗格中,将顶部列表设置为 “人口”,将中间列表设置为 “城市”,并将底部列表设置为 “国家/地区”。
辅助功能指南
尽管名称如此, 但 标签控件不必用作另一个控件的标签。 它可用于显示任何文本片段。
可以通过指定 OnSelect 行为,将标签用作按钮或链接。 以这种方式使用时,与按钮类似的辅助功能注意事项。
颜色对比度
在以下两者之间必须有足够的颜色对比度:
屏幕阅读器支持
低视力支持
-
如果标签 用作链接,则标签应类似于链接。
- 将 下划线 设置为 true
- HoverColor 应不同于 Color
键盘支持
- 如果文本用作按钮或链接,则 TabIndex 必须为零或更大。 这允许键盘用户导航到它。
- 如果文本用作按钮或链接,则焦点指示器必须清晰可见。 使用 FocusedBorderColor 和 FocusedBorderThickness 来实现此目的。