Thumb 控件类型

  • 项目

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

Thumb 控件提供移动（或拖动）控件的功能（如滚动栏按钮），或调整大小的功能（如窗口调整小组件）。 请注意，Thumb 控件不提供拖放功能。 Thumb 控件可以接收鼠标焦点，但不能接收键盘焦点。 控件开发人员必须实现该控件，使其执行相应的操作（可以是拖放或调整大小）。

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

本主题包含以下各节：

典型树结构

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

控件视图 内容视图
  • Thumb
 (ぃ続ノ)

 

Thumb 控件永远不会显示在内容视图中，因为它们的存在只是使用鼠标操作。 它们通过 滚动控件模式 、 转换 控件模式或 RangeValue 控件模式（在拇指控件的容器上受支持）的其他控件模式公开。

相关属性

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

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

 

所需的控件模式

下表列出需要由 Thumb 控件支持的 UI 自动化控件模式。 有关控件模式的详细信息，请参阅 UI Automation Control Patterns Overview。

控件模式 支持 说明
ITransformProvider 必须 使缩略控件在屏幕上移动。 由于拇指控件通常不能调整大小或旋转， 因此转换 控件模式主要支持 Move 函数。

 

必需事件

下表列出了 thumb 控件需要支持UI 自动化事件。 有关事件的详细信息，请参阅 F:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty。

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

 

概念性

UI 自动化控件类型概述

UI 自动化概述