次の方法で共有

TabItem コントロールの種類

  • [アーティクル]

このトピックでは、TabItem コントロール型に対する Microsoft UI オートメーションのサポートについて説明します。

タブ項目コントロールは、ウィンドウに表示する特定のページを選択するタブ コントロール内のコントロールとして使用されます。

次のセクションでは、TabItem コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンに対する UI オートメーションのサポートを統合するすべてのタブ項目コントロールに適用されます。

このトピックには、次のセクションが含まれています。

一般的なツリー構造

次の表は、タブ項目コントロールに関連する UI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容を示しています。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。

コントロール ビュー コンテンツ ビュー
  • TabItem
    • 画像 (0 または 1)
    • テキスト
    • 硝子
      • 各種コントロール (0 以上)
  • TabItem
    • 硝子
      • 各種コントロール (0 以上)

 

関連するプロパティ

次の表に、TabItem コントロール型に特に関連する値または定義を持つ UI オートメーション プロパティの一覧を示します。 UI オートメーション プロパティの詳細については、「UI オートメーション要素からプロパティを取得する」を参照してください。

UI オートメーション プロパティ 価値 筆記
UIA_AutomationIdPropertyId ノートを参照してください。 このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素で一意である必要があります。
UIA_BoundingRectanglePropertyId ノートを参照してください。 コントロール全体を含む最も外側の四角形。
UIA_ClickablePointPropertyId ノートを参照してください。 タブ項目コントロールには、項目が選択されるクリック可能なポイントが必要です。
UIA_ControllerForPropertyId ノートを参照してください。 このプロパティは、関連付けられているタブ ウィンドウへのポインターとして使用できます。 これは、タブ項目オブジェクトの子としてペインをホストできない場合に便利です。
UIA_ControlTypePropertyId TabItem の この値は、すべての UI フレームワークで同じです。
UIA_IsContentElementPropertyId 真 タブ項目コントロールは、常に UI オートメーション ツリーのコンテンツ ビューに含まれます。
UIA_IsControlElementPropertyId 真 タブ項目コントロールは、常に UI オートメーション ツリーのコントロール ビューに含まれます。
UIA_IsKeyboardFocusablePropertyId ノートを参照してください。 コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
UIA_LabeledByPropertyId ヌル タブ項目コントロールには、静的なテキスト ラベルがありません。
UIA_LocalizedControlTypePropertyId ノートを参照してください。 TabItem コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "タブ項目" です。
UIA_NamePropertyId ノートを参照してください。 タブ項目コントロールの自己ラベル付け。

 

必要なコントロール パターン

次の表に、すべてのタブ項目コントロールでサポートされる必要がある UI オートメーション コントロール パターンの一覧を示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。

コントロール パターン 支える 筆記
ISelectionItemProviderの 必須 タブ項目コントロールは、IUIAutomationSelectionItemPatternサポートする必要があります。
IInvokeProviderの 一度もない タブ項目コントロールでは、IUIAutomationInvokePatternはサポートされません。

 

必要なイベント

次の表に、タブ項目コントロールがサポートするために必要な UI オートメーション イベントの一覧を示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。

UI オートメーション イベント 筆記
UIA_AutomationFocusChangedEventId
プロパティ変更イベント UIA_BoundingRectanglePropertyId します。
プロパティ変更イベントを UIA_IsEnabledPropertyId します。 コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベント UIA_IsOffscreenPropertyId します。 コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。
UIA_SelectionItem_ElementRemovedFromSelectionEventId
UIA_SelectionItem_ElementSelectedEventId
UIA_StructureChangedEventId

 

概念

UI オートメーション コントロールの種類の概要

UI オートメーションの概要