Thumb 控制項類型

本主題提供Thumb控制項類型的 Microsoft 消費者介面自動化支援相關資訊。

Thumb 控制項提供移動 (或拖曳) 控制項的功能 (如捲軸按鈕),或是調整控制項大小的功能 (如會調整 Widget 大小的視窗)。 請注意,Thumb 控制項不提供拖放功能。 Thumb 控制項可以接收滑鼠焦點,但無法接收鍵盤焦點。 控制項開發人員必須正確實作控制項,使其能夠適當運作 (可供拖曳或調整大小)。

下列各節會定義Thumb控制項類型所需的樹狀結構、屬性、控制項模式和事件消費者介面自動化。 消費者介面自動化需求會套用 UI 架構/平臺整合消費者介面自動化控制項類型和控制項模式支援的所有 Thumb 控制項。

本主題包含下列各節。

一般樹狀結構

下表描述與 Thumb 控制項相關的消費者介面自動化樹狀結構的典型控制項和內容檢視,並描述每個檢視中可包含的內容。 如需 UI 自動化樹狀結構的詳細資訊,請參閱 UI 自動化樹狀結構概觀

控制項檢視 內容檢視
  • Thumb
(不適用)

 

Thumb 控制項永遠不會出現在內容檢視中,因為它們只存在以滑鼠操作。 它們會透過另一個控制項模式公開,例如 滾動 控制項模式、 轉換 控制項模式或 RangeValue 控制項模式,在 Thumb 控制項的容器上受到支援。

相關屬性

下表列示 UI 自動化屬性,其值或定義與縮圖控制項特別有關。 如需消費者介面自動化屬性的詳細資訊,請參閱從 消費者介面自動化 Elements 擷取屬性

使用者介面自動化屬性 注意
UIA_AutomationIdPropertyId 請參閱備註。 此屬性的值在消費者介面自動化樹狀結構的原始檢視中的所有對等專案之間必須是唯一的。
UIA_BoundingRectanglePropertyId 請參閱備註。 包含整個控制項的最外層矩形。
UIA_ClickablePointPropertyId 請參閱備註。 Thumb 控制項可見工作區內的點。
UIA_ControlTypePropertyId Thumb
UIA_IsContentElementPropertyId false thumb 控制項永遠不會包含在消費者介面自動化樹狀結構的內容檢視中。
UIA_IsControlElementPropertyId true thumb 控制項一律包含在消費者介面自動化樹狀結構的控制項檢視中。
UIA_IsKeyboardFocusablePropertyId 請參閱備註。 如果控制項可接收鍵盤焦點,就必定支援此屬性。 如果指紋控制項做為調整視窗或窗格大小的「移轉夾」物件,就可以接收焦點。 滑杆或捲軸中的捲軸控制項絕對不會收到焦點。
UIA_LabeledByPropertyId NULL Thumb 控制項一律沒有標籤。
UIA_LocalizedControlTypePropertyId 請參閱備註。 對應至 Thumb 控制項類型的當地語系化字串。 en-US 或英文 (美國) 的預設值為 「thumb」。
UIA_NamePropertyId NULL 因為消費者介面自動化樹狀結構的內容檢視中無法使用 Thumb 控制項,所以不需要名稱。

 

必要的控制項模式

下表列出縮圖控制項必須支援的 UI 自動化控制項模式。 如需控制項模式的詳細資訊,請參閱 UI Automation Control Patterns Overview

控制項模式 支援 備註
ITransformProvider 必要 使畫面上的 Thumb 控制項可以移動。 因為指紋控制項通常無法調整大小或旋轉, 所以轉換 控制項模式主要支援 Move 函式。

 

必要的事件

下表列出指紋控制項需要支援消費者介面自動化事件。 如需 UI Automation Events Overview事件的詳細資訊,請參閱

UI 自動化事件 備註
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId 屬性變更事件。
UIA_IsEnabledPropertyId 屬性變更事件。 如果控制項支援 IsEnabled 屬性,它必須支援這個事件。
UIA_IsOffscreenPropertyId 屬性變更事件。 如果控制項支援 IsOffscreen 屬性,它必須支援此事件。
UIA_StructureChangedEventId

 

概念

UI 自動化控制項類型概觀

UI 自動化概觀