通过

Thumb 控件类型

  • 项目

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

Thumb 控件提供使控件能够移动（或拖动）的功能，例如滚动条按钮或调整大小，例如窗口调整小组件的大小。 请注意，拇指控件不提供拖放功能。 拇指控件可以接收鼠标焦点，但不能接收键盘焦点。 控件开发人员必须实现控件，以便它能够适当地执行（可以拖动或调整其大小）。

以下部分定义了 Thumb 控件类型所需的 UI 自动化树结构、属性、控件模式和事件。 UI 自动化要求应用 UI 框架/平台集成 UI 自动化对控件类型和控件模式的支持的所有拇指控件。

本主题包含以下部分。

典型树结构

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

控件视图 内容视图
  • 拇指
 （不适用）

 

Thumb 控件从不显示在内容视图中，因为它们只存在用鼠标作。 它们通过另一个控件模式（如 Scroll 控件模式、转换 控件模式或 RangeValue 控件模式）公开，这些模式在拇指控件的容器上受支持。

相关属性

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

UI 自动化属性 价值 笔记
UIA_AutomationIdPropertyId 请参阅备注。 此属性的值在 UI 自动化树的原始视图中的所有对等元素中必须是唯一的。
UIA_BoundingRectanglePropertyId 请参阅备注。 包含整个控件的最外侧矩形。
UIA_ClickablePointPropertyId 请参阅备注。 拇指控件可见工作区内的点。
UIA_ControlTypePropertyId Thumb
UIA_IsContentElementPropertyId 假 指纹控件永远不会包含在 UI 自动化树的内容视图中。
UIA_IsControlElementPropertyId 真 拇指控件始终包含在 UI 自动化树的控件视图中。
UIA_IsKeyboardFocusablePropertyId 请参阅备注。 如果控件可以接收键盘焦点，它必须支持此属性。 如果拇指控件用作调整窗口或窗格大小的“控制手柄”对象，则可以接收焦点。 滑块或滚动条中的拇指控件不应收到焦点。
UIA_LabeledByPropertyId 零 Thumb 控件永远不会有标签。
UIA_LocalizedControlTypePropertyId 请参阅备注。 对应于 Thumb 控件类型的本地化字符串。 en-US 或英语（美国）的默认值为“thumb”。
UIA_NamePropertyId 零 由于 Thumb 控件在 UI 自动化树的内容视图中不可用，因此它不需要名称。

 

所需的控件模式

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

控件模式 支持 笔记
ITransformProvider 必填 允许在屏幕上移动拇指控件。 由于拇指控件通常无法调整或旋转大小，因此 转换 控件模式主要支持 移动 函数。

 

必需事件

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

UI 自动化事件 笔记
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId 属性更改事件。
UIA_IsEnabledPropertyId 属性更改事件。 如果控件支持 IsEnabled 属性，则必须支持此事件。
UIA_IsOffscreenPropertyId 属性更改事件。 如果控件支持 IsOffscreen 属性，则必须支持此事件。
UIA_StructureChangedEventId

 

概念

UI 自动化控件类型概述

UI 自动化概述