次の方法で共有


UI オートメーションによる SplitButton コントロール型のサポート

メモメモ

このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージ UI Automation クラスを使用する .NET Framework 開発者を対象としています。UI Automationに関する最新情報については、「Windows Automation API: UI Automation (Windows オートメーション API: UI オートメーション)」を参照してください。

このトピックでは、UI Automationによる SplitButton コントロール型のサポートについての情報を提供します。 UI Automationでは、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。 これらの条件には、UI Automation ツリー構造、UI Automationのプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。

分割ボタン コントロールを使用すると、コントロールに対するアクションを実行できます。また、コントロールを展開して、その他の実行可能なアクションのリストを表示することもできます。

以下のセクションでは、SplitButton コントロール型に必要な UI Automation ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI Automationの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows Formsのいずれの場合でも、すべての分割ボタン コントロールに当てはまります。

このトピックは、次のセクションで構成されています。

  • 必須の UI オートメーション ツリー構造
  • 必須の UI オートメーション プロパティ
  • 必須の UI オートメーション コントロール パターン
  • 必須の UI オートメーション イベント
  • SplitButton コントロールの例
  • 関連トピック

必須の UI オートメーション ツリー構造

次の表に、分割ボタン コントロールに関連する UI Automation ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに何を格納できるかについて説明します。 UI Automation ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。

コントロール ビュー

コンテンツ ビュー

SplitButton

  • イメージ (0 または 1 つ)

  • Text (0 または 1)

  • Button (1 または 2)

    • Menu (0 または 1。ExpandCollapse パターンをサポートするボタンの子として表示されます)

    • MenuItem (1 または多数)

SplitButton

  • MenuItem (1 または多数)

必須の UI オートメーション プロパティ

次の表に、値または定義が特に分割ボタン コントロールに関連する UI Automation プロパティを示します。 UI Automation プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。

UI Automation プロパティ

説明

AutomationIdProperty

説明を参照。

このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。

BoundingRectangleProperty

説明を参照。

コントロール全体を包含する外側の四角形。

ClickablePointProperty

説明を参照。

外接する四角形が存在する場合はサポートされます。 外接する四角形の範囲内にクリック不可能な点が存在するときに特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。

IsKeyboardFocusableProperty

説明を参照。

コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。

NameProperty

"戻る"

分割ボタン コントロールの名前は、ボタンに表示されます。

LabeledByProperty

Null

分割ボタン コントロールには、静的なテキスト ラベルはありません。

ControlTypeProperty

SplitButton

この値は、すべての UI フレームワークで共通です。

LocalizedControlTypeProperty

"分割ボタン"

SplitButton コントロール型に対応するローカライズされた文字列。

HelpTextProperty

説明を参照。

ヘルプ テキストには、分割ボタンを有効にした場合の最終結果を示します。通常は、ツールヒントで表示される情報と同様の内容になります。

IsContentElementProperty

True

分割ボタン コントロールには、エンド ユーザーに対する情報が含まれます。

IsControlElementProperty

True

分割ボタン コントロールは、エンド ユーザーに表示されます。

必須の UI オートメーション コントロール パターン

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

コントロール パターン

サポート

説明

IInvokeProvider

必須

分割ボタンには常に、Invoke と関連付けられた既定のアクションがあります。

IExpandCollapseProvider

必須

分割ボタンは常に、オプションの一覧を展開できます。

必須の UI オートメーション イベント

すべての分割ボタン コントロールでサポートする必要がある UI Automation イベントを次の表に示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。

UI Automation イベント

サポート

説明

InvokedEvent

必須

なし

BoundingRectangleProperty プロパティ変更イベント

必須

なし

IsOffscreenProperty プロパティ変更イベント

必須

なし

IsEnabledProperty プロパティ変更イベント

必須

なし

ExpandCollapseStateProperty プロパティ変更イベント

必須

なし

AutomationFocusChangedEvent

必須

なし

StructureChangedEvent

必須

なし

SplitButton コントロールの例

次の図は、データ グリッド コントロール内の SplitButton コントロール型を示しています。

分割ボタン

次に示すのは、データ グリッド コントロールと分割ボタン コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューです。 各オートメーション要素のコントロール パターンをかっこで囲んで示します。

UI Automation ツリー - コントロール ビュー

UI Automation ツリー - コンテンツ ビュー

  • SplitButton "Name" (Invoke, ExpandCollapse)

  • Button "More options" (Invoke)

    • Menu

    • MenuItem

  • SplitButton "Name" (Invoke, ExpandCollapse)

  • Button "More options" (Invoke)

    • Menu

    • MenuItem

参照

参照

SplitButton

概念

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

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