UI オートメーションによる RadioButton コントロール型のサポート
Note
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、Windows Automation API の「UI オートメーション」を参照してください。
このトピックでは、RadioButton コントロール型に対する UI オートメーションのサポートに関する情報を提供します。 UI オートメーションでのコントロール型とは、コントロールで ControlTypeProperty プロパティを使用するために満たす必要がある条件のセットのことです。 この条件には、UI オートメーション ツリーの構造、UI オートメーションのプロパティ値、コントロール パターンに関する特定のガイドラインが含まれます。
オプション ボタンは、丸形のボタンとアプリケーションで定義されたテキスト (ラベル)、アイコン、またはユーザーがボタンを選択することで選択できる選択肢を示すビットマップで構成されます。 多くのアプリケーションでは、関連しているものの相互に排他的なオプションのセットからユーザーが選択できるようにするグループ ボックス内でオプション ボタンが使用されます。 たとえば、ユーザーがクライアント領域で選択したテキストの書式設定を選択できるオプション ボタンのグループをアプリケーションで表示することができます。 ユーザーは、対応するオプション ボタンを選択することによって、左揃え、右揃え、または中央揃えの形式を選択できます。 通常、ユーザーは、オプション ボタンのセットから、一度に 1 つのオプションしか選択することができません。
以降のセクションでは、RadioButton コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、イベントを定義します。 この UI オートメーションの要件は、Windows Presentation Foundation (WPF)、Win32、または Windows フォームのいずれにおいても、すべてのリスト コントロールに適用されます。
必須の UI オートメーション ツリー構造
次の表に、ラジオ ボタン コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
| RadioButton | RadioButton |
コントロール ビューまたはコンテンツ ビューに子は存在しません。
必須の UI オートメーション プロパティ
次の表に、RadioButton コントロール型に特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
| UI Automation のプロパティ | 値 | Notes |
|---|---|---|
| AutomationIdProperty | 「ノート」を参照してください。 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
| BoundingRectangleProperty | 「ノート」を参照してください。 | コントロール全体を格納する最も外側の四角形。 |
| IsKeyboardFocusableProperty | 「ノート」を参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| NameProperty | 「ノート」を参照してください。 | オプション ボタン コントロールの名前は、選択状態を保持するボタンの横に表示されたテキストです。 |
| ClickablePointProperty | 「ノート」を参照してください。 | オプション ボタン コントロールのクリック可能なポイントは、マウス ポインターでクリックされた場合にオプション ボタン上に選択が設定されるポイントにする必要があります。 |
| LabeledByProperty | Null |
オプション ボタンはそれ自体がラベルであるコントロールです。 |
| ControlTypeProperty | RadioButton | この値は、すべての UI フレームワークで同じです。 |
| LocalizedControlTypeProperty | "オプション ボタン" | RadioButton コントロール型に対応する、ローカライズされた文字列。 |
| IsContentElementProperty | ○ | ラジオ ボタン コントロールは、UI オートメーション ツリーのコンテンツ ビューに常に含まれます。 |
| IsControlElementProperty | True | ラジオ ボタン コントロールは、UI オートメーション ツリーのコントロール ビューに常に含まれます。 |
必須の UI オートメーション コントロール パターン
次の表に、すべてのラジオ ボタン コントロールでサポートされる必要がある UI オートメーション コントロールのパターンを示します。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。
| コントロール パターン/コントロール パターン プロパティ | サポート/値 | メモ |
|---|---|---|
| ISelectionItemProvider | はい | すべてのオプション ボタン コントロールが、それ自体を選択可能にする選択項目パターンをサポートする必要があります。 |
| SelectionContainer | 「ノート」を参照してください。 | UI オートメーション クライアントが特定のコンテキスト内で相互に関連する他のオプション ボタンを特定できるためには、 SelectionContainerProperty が設定されている必要があります。 オプション ボタンの Win32 バージョンでは、このプロパティがサポートされません。これは、従来のフレームワークからこの情報を取得できないためです。 |
| IToggleProvider | 行わない | オプション ボタンは、いったん設定されると、その状態を循環させることができません。 このパターンは、オプション ボタンではサポートしないでください。 |
必須の UI オートメーション イベント
次の表に、すべてのラジオ ボタン コントロールでサポートされる必要がある UI オートメーション イベントを示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。
| UI オートメーション イベント | サポート | Notes |
|---|---|---|
| ElementRemovedFromSelectionEvent | 必須 | なし |
| ElementSelectedEvent | 必須 | なし |
| ToggleStateProperty プロパティ変更イベント。 | なし | なし |
| BoundingRectangleProperty プロパティ変更イベント。 | 必須 | なし |
| IsOffscreenProperty プロパティ変更イベント。 | 必須 | なし |
| IsEnabledProperty プロパティ変更イベント。 | 必須 | なし |
| AutomationFocusChangedEvent | 必須 | なし |
| StructureChangedEvent | 必須 | なし |