備註
本檔適用於想要使用 System.Windows.Automation 命名空間中定義的受控UI自動化類別的 .NET Framework 開發人員。 如需 UI 自動化的最新資訊，請參閱 Windows 自動化 API：使用者介面自動化。
本主題提供 Tab 控制件類型的 UI 自動化支援相關信息。 在UI自動化中，控件類型是控制項必須符合的一組條件，才能使用 ControlTypeProperty 屬性。 條件包括UI自動化樹狀結構、UI 自動化屬性值和UI自動化的特定指導方針。 控制模式。
索引標籤機控件類似於筆記本中的分隔符或檔案櫃中的標籤。 藉由使用索引標籤件，應用程式可以針對視窗或對話框的相同區域定義多個頁面。
下列各節會定義 Tab 控制項類型所需的 UI 自動化樹狀結構、屬性、控制項模式和事件。 使用者介面自動化需求適用於所有製表控件，無論是 Windows Presentation Foundation （WPF）、Win32 還是 Windows Forms。
必要的 UI 自動化樹狀結構
下表描述與索引標籤件相關的 UI 自動化樹狀結構的控件檢視和內容檢視，並描述每個檢視中可包含的內容。 如需UI自動化樹狀結構的詳細資訊，請參閱 UI自動化樹狀結構概觀。
| 控制項檢視 | 內容檢視 |
|---|---|
Tab鍵
|
Tab鍵 - TabItem （1 或更多） |
Tab 控制項具有以 Tab 專案控制項類型為基礎的子 UI 自動化元素。 當索引標籤項目分組時（例如，如 Microsoft Office 2007 應用程式），索引標籤控制類型也可以承載組合索引標籤項目的群組控制類型，如下列樹狀結構所示。
| 控制項檢視 | 內容檢視 |
|---|---|
Tab鍵
|
Tab鍵
|
必要的UI自動化屬性
下表列出UI自動化屬性，其值或定義與Tab控件類型特別相關。 如需UI自動化屬性的詳細資訊，請參閱 用戶端的UI自動化屬性。
| UI 自動化屬性 | 價值觀 | 註釋 |
|---|---|---|
| AutomationIdProperty | 請參閱備註。 | 這個屬性的值在應用程式中的所有控件中必須是唯一的。 |
| BoundingRectangleProperty | 請參閱備註。 | 包含整個控制項的最外層矩形。 |
| IsKeyboardFocusableProperty | 請參閱備註。 | 如果控制項可接收鍵盤焦點，就必定支援此屬性。 |
| NameProperty | 請參閱備註。 | 選項卡控制項很少需要 Name 屬性。 |
| ClickablePointProperty | 否 | 索引標籤控制件沒有可點選的點。 |
| LabeledByProperty | 請參閱備註。 | Tab 控件通常具有透過這個屬性公開的靜態文字標籤。 |
| ControlTypeProperty | Tab鍵 | 此值與所有使用者介面架構的值相同。 |
| LocalizedControlTypeProperty | “tab” | 對應至 Tab 控制件類型的當地語系化字串。 |
| IsKeyboardFocusableProperty | 對 | Tab 控制項類型必須能夠接收鍵盤焦點。 一般而言，使用者介面自動化用戶端會在選項卡控件上呼叫SetFocus，其中一個專案會將鍵盤焦點轉送至選項卡控件。 某些索引標籤容器可以取得焦點，而不需將焦點設定為其其中一個專案。 |
| IsContentElementProperty | 對 | 索引標籤控件一律包含在使用者介面自動化樹狀結構的內容檢視中。 |
| IsControlElementProperty | 對 | 索引標籤控件一律包含在UI自動化樹狀結構的控件檢視中。 |
| OrientationProperty | 請參閱備註。 | 索引標籤必須一律指出它是水平或垂直定位。 |
必要的使用者介面自動化控制項模式和屬性
下表列出所有索引標籤器都必須支援的UI自動化控制項模式。 如需控制樣式的詳細資訊，請參閱 UI 自動化控制樣式概觀。
| 控制件模式/模式屬性 | 支援/值 | 註釋 |
|---|---|---|
| ISelectionProvider | 是的 | 所有索引標籤控制項都必須支援選擇樣式。 |
| IsSelectionRequired | 對 | 索引標籤控件一律需要選取專案。 |
| CanSelectMultiple | 否 | 索引標籤控件一律為單一選取容器。 |
| IScrollProvider | 視情況而定 | 捲動模式必須在具有小工具的索引標籤控制中支援，這些小工具允許捲動一組索引標籤項目。 |
必要的UI自動化事件
下表列出所有索引標籤控制項必須支援的UI自動化事件。 如需事件的詳細資訊，請參閱 UI Automation Events Overview。
| UI 自動化事件 | 支援 | 註釋 |
|---|---|---|
| BoundingRectangleProperty 屬性變更事件。 | 為必填項目 | 沒有 |
| IsOffscreenProperty 屬性變更事件。 | 為必填項目 | 沒有 |
| IsEnabledProperty 屬性變更事件。 | 為必填項目 | 沒有 |
| HorizontallyScrollableProperty 屬性變更事件。 | 視情況而定 | 沒有 |
| HorizontalScrollPercentProperty 屬性變更事件。 | 視情況而定 | 沒有 |
| HorizontallyScrollableProperty 屬性變更事件。 | 視情況而定 | 沒有 |
| HorizontalViewSizeProperty 屬性變更事件。 | 視情況而定 | 沒有 |
| VerticalScrollPercentProperty 屬性變更事件。 | 視情況而定 | 沒有 |
| VerticalViewSizeProperty 屬性變更事件。 | 視情況而定 | 沒有 |
| AutomationFocusChangedEvent | 為必填項目 | 沒有 |
| StructureChangedEvent | 為必填項目 | 沒有 |