UI オートメーションによる SplitButton コントロール型のサポート
.gif "メモ") メモ |
|---|
このドキュメントは、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
|
SplitButton
|
必須の UI オートメーション プロパティ
次の表に、値または定義が特に分割ボタン コントロールに関連する UI Automation プロパティを示します。 UI Automation プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
UI Automation プロパティ |
値 |
説明 |
|---|---|---|
説明を参照。 |
このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。 |
|
説明を参照。 |
コントロール全体を包含する外側の四角形。 |
|
説明を参照。 |
外接する四角形が存在する場合はサポートされます。 外接する四角形の範囲内にクリック不可能な点が存在するときに特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。 |
|
説明を参照。 |
コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
|
"戻る" |
分割ボタン コントロールの名前は、ボタンに表示されます。 |
|
Null |
分割ボタン コントロールには、静的なテキスト ラベルはありません。 |
|
SplitButton |
この値は、すべての UI フレームワークで共通です。 |
|
"分割ボタン" |
SplitButton コントロール型に対応するローカライズされた文字列。 |
|
説明を参照。 |
ヘルプ テキストには、分割ボタンを有効にした場合の最終結果を示します。通常は、ツールヒントで表示される情報と同様の内容になります。 |
|
True |
分割ボタン コントロールには、エンド ユーザーに対する情報が含まれます。 |
|
True |
分割ボタン コントロールは、エンド ユーザーに表示されます。 |
必須の UI オートメーション コントロール パターン
分割ボタン コントロールでサポートする必要がある UI Automation コントロール パターンの一覧を次の表に示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
コントロール パターン |
サポート |
説明 |
|---|---|---|
必須 |
分割ボタンには常に、Invoke と関連付けられた既定のアクションがあります。 |
|
必須 |
分割ボタンは常に、オプションの一覧を展開できます。 |
必須の UI オートメーション イベント
すべての分割ボタン コントロールでサポートする必要がある UI Automation イベントを次の表に示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
UI Automation イベント |
サポート |
説明 |
|---|---|---|
必須 |
なし |
|
BoundingRectangleProperty プロパティ変更イベント |
必須 |
なし |
IsOffscreenProperty プロパティ変更イベント |
必須 |
なし |
IsEnabledProperty プロパティ変更イベント |
必須 |
なし |
ExpandCollapseStateProperty プロパティ変更イベント |
必須 |
なし |
必須 |
なし |
|
必須 |
なし |
SplitButton コントロールの例
次の図は、データ グリッド コントロール内の SplitButton コントロール型を示しています。
.gif "分割ボタン")
次に示すのは、データ グリッド コントロールと分割ボタン コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューです。 各オートメーション要素のコントロール パターンをかっこで囲んで示します。
UI Automation ツリー - コントロール ビュー |
UI Automation ツリー - コンテンツ ビュー |
|---|---|
|
|