通过

滑块控件类型

  • 项目

本主题提供有关 Microsoft UI 自动化对 Slider 控件类型的支持的信息。

滑块控件是包含按钮的复合控件，使用户能够设置数字范围或从一组项中进行选择。

以下各节定义 Slider 控件类型所需的 UI 自动化树结构、属性、控件模式和事件。 UI 自动化要求适用于 UI 框架/平台集成 UI 自动化对控件类型和控件模式的支持的所有滑块控件。

本主题包含以下部分。

典型树结构

下表描述了与滑块控件相关的 UI 自动化树的典型控件和内容视图，并描述了每个视图中可包含的内容。 有关 UI 自动化树的详细信息，请参阅 UI 自动化树概述。

控件视图 内容视图
  • 滑 块
    • 按钮 （2 或 4）
    • 拇指 （1）
    • 列表项（0 个或多个）
  • 滑 块
    • 列表项（0 个或多个）

 

相关属性

下表列出了其值或定义与滑块控件特别相关的 UI 自动化属性。 有关 UI 自动化属性的详细信息，请参阅 从 UI 自动化元素检索属性。

UI 自动化属性 价值 笔记
UIA_AutomationIdPropertyId 请参阅备注。 此属性的值在 UI 自动化树的原始视图中的所有对等元素中必须是唯一的。
UIA_BoundingRectanglePropertyId 请参阅备注。 包含整个控件的最外侧矩形。
UIA_ClickablePointPropertyId 请参阅备注。 大多数滑块控件必须返回 UIA_E_NOCLICKABLEPOINT 错误，因为滑块控件的整个边界矩形由子控件占用。
UIA_ControlTypePropertyId 滑块 对于所有框架，此值相同。
UIA_IsContentElementPropertyId 真 滑块控件始终包含在 UI 自动化树的内容视图中。
UIA_IsControlElementPropertyId 真 滑块控件始终包含在 UI 自动化树的控件视图中。
UIA_IsKeyboardFocusablePropertyId 请参阅备注。 如果控件可以接收键盘焦点，它必须支持此属性。 滑块控件的子级（按钮和拇指）绝不应获取焦点。 焦点应始终保留在滑块控件本身上。
UIA_LabeledByPropertyId 请参阅备注。 如果存在与控件关联的静态文本标签，此属性必须公开对该控件的引用。 如果文本控件是另一个控件的子组件，则它不会设置 LabeledBy 属性集。
UIA_LocalizedControlTypePropertyId 请参阅备注。 与 滑块 控件类型对应的本地化字符串。 默认值为 en-US 或英语（美国）的“滑块”。
UIA_NamePropertyId 请参阅备注。 滑块控件的名称通常从静态文本标签生成。 如果没有静态文本标签，则应用程序开发人员必须分配 名称 的属性值。

 

所需的控件模式

下表列出了所有滑块控件支持所需的 UI 自动化控件模式。 有关控件模式的详细信息，请参阅 UI 自动化控件模式概述。

控件模式/模式属性 支持/值 笔记
IRangeValueProvider 取决于 如果内容可以设置为数值范围内的值，滑块应支持 RangeValue 控件模式。
ISelectionProvider 取决于 如果内容表示一组离散选项中的一个值，滑块应支持 选择 控件模式。 支持选择控件模式时，相应的选择必须公开为滑块的一个或多个子列表项。
IValueProvider 取决于 如果内容表示一组离散选项中的一个值，滑块应支持 值 控件模式。

 

必需事件

下表列出了滑块控件需要支持的 UI 自动化事件。 有关事件的详细信息，请参阅 UI 自动化事件概述。

UI 自动化事件 笔记
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId 属性更改事件。
UIA_IsEnabledPropertyId 属性更改事件。 如果控件支持 IsEnabled 属性，则必须支持此事件。
UIA_IsOffscreenPropertyId 属性更改事件。 如果控件支持 IsOffscreen 属性，则必须支持此事件。
UIA_RangeValueValuePropertyId 属性更改事件。 如果控件支持 RangeValue 控件模式，则必须支持此事件。
UIA_Selection_InvalidatedEventId 如果控件支持 选择 控件模式，则必须支持此事件。
UIA_StructureChangedEventId
UIA_ValueValuePropertyId 属性更改事件。 如果控件支持 值 控件模式，则它必须支持此事件。

 

概念

UI 自动化控件类型概述

UI 自动化概述