備註
本檔適用於想要使用 System.Windows.Automation 命名空間中定義的受控UI自動化類別的 .NET Framework 開發人員。 如需 UI 自動化的最新資訊，請參閱 Windows 自動化 API：使用者介面自動化。
本主題提供 Thumb 控制項類型的 UI 自動化支援相關信息。 在UI自動化中，控件類型是控制項必須符合的一組條件，才能使用 ControlTypeProperty 屬性。 這些條件包括UI自動化樹狀結構、UI自動化屬性值和控件模式的特定指導方針。
Thumb 控件提供的功能可讓控件移動（或拖曳），例如滾動條按鈕或重設大小，例如視窗重設大小小工具。 Thumb 控件也可以實作為窗格的可移動框線。 請注意，它不提供拖放功能。 Thumb 控制件可以接收滑鼠焦點，但通常不是鍵盤焦點。 控件開發人員必須實作 控件，使其可以適當地執行（可以拖曳或重設大小）。
下列各節會定義 Thumb 控制項類型所需的 UI 自動化樹狀結構、屬性、控制件模式和事件。 使用者介面自動化需求適用於所有滑控元件，無論是 Windows Presentation Foundation（WPF）、Win32 或 Windows Forms。
必要的 UI 自動化樹狀結構
下表描述與 Thumb 控制項相關的 UI 自動化樹狀結構的控件檢視和內容檢視，並描述每個檢視中可包含的內容。 如需UI自動化樹狀結構的詳細資訊，請參閱 UI自動化樹狀結構概觀。
| 控制項檢視 | 內容檢視 |
|---|---|
| 拇指 | - 不適用 |
Thumb 控制項永遠不會出現在內容檢視中，因為它們只為供滑鼠操作而存在。 在 Thumb 容器上支援其他控制項模式，例如捲動模式、轉換模式或 RangeValue 模式，都會公開其功能。
必要的UI自動化屬性
下表列出UI自動化屬性，其值或定義與Thumb控件特別相關。 如需UI自動化屬性的詳細資訊，請參閱 用戶端的UI自動化屬性。
| UI 自動化屬性 | 價值觀 | 註釋 |
|---|---|---|
| AutomationIdProperty | 請參閱備註。 | 這個屬性的值在應用程式中的所有控件中必須是唯一的。 |
| BoundingRectangleProperty | 請參閱備註。 | 包含整個控制項的最外層矩形。 |
| ClickablePointProperty | 請參閱備註。 | Thumb 控件在可見用戶區域內的任何點。 |
| IsKeyboardFocusableProperty | 請參閱備註。 | 如果控制項可接收鍵盤焦點，就必定支援此屬性。 |
| NameProperty | Null |
Thumb 控制項無法在 UI 自動化樹狀結構的內容檢視中使用，因此不需要名稱。 |
| LabeledByProperty | Null |
Thumb 控件永遠不會有標籤。 |
| ControlTypeProperty | 拇指 | 此值與所有使用者介面架構的值相同。 |
| LocalizedControlTypeProperty | 拇指 | 對應 Thumb 控制項類型的本地化字串。 |
| IsContentElementProperty | 否 | Thumb 控件從不滿足。 |
| IsControlElementProperty | 對 | Thumb 控制元件必須始終是控制元件。 |
必要的使用者介面自動化控制模式
下表列出拇指控制項需要支援的UI自動化控制件模式。 如需控制樣式的詳細資訊，請參閱 UI 自動化控制樣式概觀。
| 控制件模式/模式屬性 | 支援/值 | 註釋 |
|---|---|---|
| ITransformProvider | 為必填項目 | 可讓拇指控件在畫面上移動。 |
必要的UI自動化事件
下表列出所有拇指控制件都必須支援的UI自動化事件。 如需事件的詳細資訊，請參閱 UI 自動化事件概觀。
| UI 自動化事件 | 支援 | 註釋 |
|---|---|---|
| BoundingRectangleProperty 屬性變更事件。 | 為必填項目 | 沒有 |
| IsOffscreenProperty 屬性變更事件。 | 為必填項目 | 沒有 |
| IsEnabledProperty 屬性變更事件。 | 為必填項目 | 沒有 |
| AutomationFocusChangedEvent | 為必填項目 | 沒有 |
| StructureChangedEvent | 為必填項目 | 沒有 |