RadioButton コントロールの種類
このトピックでは、RadioButton コントロール型の Microsoft UI オートメーション サポートについて説明します。
オプション ボタンは、丸形のボタンとアプリケーションで定義されたテキスト (ラベル)、アイコン、またはユーザーがボタンを選択することで選択できる選択肢を示すビットマップで構成されます。 多くのアプリケーションでは、関連しているものの相互に排他的なオプションのセットからユーザーが選択できるようにするグループ ボックス内でオプション ボタンが使用されます。 たとえば、ユーザーがクライアント領域で選択したテキストの書式設定を選択できるオプション ボタンのグループをアプリケーションで表示することができます。 ユーザーは、対応するオプション ボタンを選択することによって、左揃え、右揃え、または中央揃えの形式を選択できます。 通常、ユーザーは、オプション ボタンのセットから、一度に 1 つのオプションしか選択することができません。
Note
グループ内の 1 つだけを選択できるボタンのもう 1 つのコントロールの一般化は、トグル ボタンの内容です。 一部の UI フレームワークでは、ラジオ ボタンが特殊なトグル ボタンと見なされます。
次のセクションでは、RadioButton コントロール型に必要なUI オートメーションツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンのサポートUI オートメーション統合するすべてのボタン コントロールに適用されます。
このトピックは、次のセクションで構成されています。
一般的なツリー構造
次の表は、ラジオ ボタン コントロールに関連するUI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
|
|
コントロール ビューまたはコンテンツ ビューに子は存在しません。
関連するプロパティ
次の表に、値または定義が RadioButton コントロールの種類 (ボタン コントロールなど) を実装するコントロールに特に関連するUI オートメーションプロパティの一覧を示します。 UI オートメーションプロパティの詳細については、「UI オートメーション要素からのプロパティの取得」を参照してください。
| UI Automation のプロパティ | 値 | メモ |
|---|---|---|
| UIA_AutomationIdPropertyId | 「ノート」を参照してください。 | このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素間で一意である必要があります。 |
| UIA_BoundingRectanglePropertyId | 「ノート」を参照してください。 | コントロール全体を格納する最も外側の四角形。 |
| UIA_ClickablePointPropertyId | 「ノート」を参照してください。 | クリック可能なポイントは、クリックしたときにラジオ ボタンを選択するポイントである必要があります。 |
| UIA_ControlTypePropertyId | RadioButton | |
| UIA_IsContentElementPropertyId | true | ラジオ ボタン コントロールは、UI オートメーション ツリーのコンテンツ ビューに常に含まれます。 |
| UIA_IsControlElementPropertyId | true | ラジオ ボタン コントロールは、UI オートメーション ツリーのコントロール ビューに常に含まれます。 |
| UIA_IsKeyboardFocusablePropertyId | 「ノート」を参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| UIA_LabeledByPropertyId | NULL | ラジオ ボタン コントロールは、その内容によって自己ラベル付けされます。 |
| UIA_LocalizedControlTypePropertyId | 「ノート」を参照してください。 | RadioButton コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "ラジオ ボタン" です。 |
| UIA_NamePropertyId | 「ノート」を参照してください。 | ラジオ ボタン コントロールの名前は、選択状態を維持するボタンの横に表示されるテキストです。 |
必須のコントロール パターン
次の表に、すべてのラジオ ボタン コントロールでサポートされる必要がある UI オートメーション コントロールのパターンを示します。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。
| コントロール パターン/パターン プロパティ | サポート/値 | メモ |
|---|---|---|
| ISelectionItemProvider | 必須 | すべてのラジオ ボタン コントロールは、 SelectionItem コントロール パターンをサポートして、それ自体を選択できるようにする必要があります。 |
| SelectionContainer | 「ノート」を参照してください。 | SelectionContainer プロパティは、UI オートメーション クライアントが特定のコンテキスト内の他のラジオ ボタンが相互に関連しているかを判断できるように、常に完了する必要があります。 Microsoft Win32 バージョンのラジオ ボタンでは、そのレガシ フレームワークからこの情報を取得できないため、このプロパティはサポートされていません。 |
| IToggleProvider | 行わない | オプション ボタンは、いったん設定されると、その状態を循環させることができません。 トグル コントロール パターンは、ラジオ ボタンでサポートしないでください。 |
必須イベント
次の表に、ボタン コントロールがサポートするために必要なUI オートメーション イベントの一覧を示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。
| UI オートメーション イベント | メモ |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| プロパティUIA_BoundingRectanglePropertyId 変更されたイベントです。 | |
| プロパティUIA_IsEnabledPropertyId 変更されたイベントです。 | コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。 |
| プロパティUIA_IsOffscreenPropertyId 変更されたイベントです。 | コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。 |
| UIA_SelectionItem_ElementRemovedFromSelectionEventId | コントロールが SelectionItem コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。 |
| UIA_SelectionItem_ElementSelectedEventId | コントロールが SelectionItem コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。 |
| UIA_StructureChangedEventId |
注釈
ラジオ ボタンは、ピア ラジオ ボタンのグループの中で 1 つの選択可能なオプションを表します。 理想的には、ラジオ ボタンには、ピア ラジオ ボタンの境界を明確にするグループ化要素が必要です。 ただし、多くの場合、境界は UI 要素構造によって暗黙的に示されます。 たとえば、メニューには、メニュー項目の代わりに連続するラジオ ボタンのセット、またはグループ ラベルの後、ボタンなどの操作可能な要素の前に発生するラジオ ボタンのセットが含まれている場合があります。
関連トピック