次の方法で共有

RadioButton コントロールの種類

  • [アーティクル]

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

ラジオ ボタンは、丸いボタンと、アプリケーション定義のテキスト (ラベル)、アイコン、またはユーザーがボタンを選択して選択できることを示すビットマップで構成されます。 通常、アプリケーションはグループ ボックス内のラジオ ボタンを使用して、関連するが相互に排他的な一連のオプションからユーザーが選択できるようにします。 たとえば、アプリケーションでは、ユーザーがクライアント領域で選択したテキストの書式設定を選択できるラジオ ボタンのグループを表示できます。 ユーザーは、対応するラジオ ボタンを選択して、左揃え、右揃え、または中央揃えの書式を選択できます。 通常、ユーザーは一連のラジオ ボタンから一度に 1 つのオプションのみを選択できます。

手記

グループ内の 1 つだけを選択できるボタンのもう 1 つのコントロールの一般化は、トグル ボタンの内容です。 一部の UI フレームワークでは、ラジオ ボタンは特殊なトグル ボタンと見なされます。

 

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

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

一般的なツリー構造

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

コントロール ビュー コンテンツ ビュー
  • RadioButton
  • RadioButton

 

コントロール ビューまたはコンテンツ ビューには子がありません。

関連するプロパティ

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

UI オートメーション プロパティ 価値 筆記
UIA_AutomationIdPropertyId ノートを参照してください。 このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素で一意である必要があります。
UIA_BoundingRectanglePropertyId ノートを参照してください。 コントロール全体を含む最も外側の四角形。
UIA_ClickablePointPropertyId ノートを参照してください。 クリック可能なポイントは、クリックしたときにラジオ ボタンを選択するポイントである必要があります。
UIA_ControlTypePropertyId RadioButton
UIA_IsContentElementPropertyId 真 ラジオ ボタン コントロールは、常に UI オートメーション ツリーのコンテンツ ビューに含まれます。
UIA_IsControlElementPropertyId 真 ラジオ ボタン コントロールは、常に UI オートメーション ツリーのコントロール ビューに含まれます。
UIA_IsKeyboardFocusablePropertyId ノートを参照してください。 コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
UIA_LabeledByPropertyId ヌル ラジオ ボタン コントロールは、その内容によって自己ラベル付けされます。
UIA_LocalizedControlTypePropertyId ノートを参照してください。 RadioButton コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "ラジオ ボタン" です。
UIA_NamePropertyId ノートを参照してください。 ラジオ ボタン コントロールの名前は、選択状態を維持するボタンの横に表示されるテキストです。

 

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

次の表に、すべてのラジオ ボタン コントロールでサポートするために必要な UI オートメーション コントロール パターンを示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。

Control Pattern/Pattern プロパティ サポート/値 筆記
ISelectionItemProviderの 必須 すべてのラジオ ボタン コントロールは、SelectionItem コントロール パターンをサポートして、自身を選択できるようにする必要があります。
SelectionContainerの ノートを参照してください。 SelectionContainer プロパティは、UI オートメーション クライアントが特定のコンテキスト内で相互に関連する他のラジオ ボタンを決定できるように、常に完了する必要があります。 Microsoft Win32 バージョンのラジオ ボタンの場合、このプロパティはサポートされていません。このプロパティは、そのレガシ フレームワークからこの情報を取得できないためです。
IToggleProviderの 一度もない ラジオ ボタンが設定されると、その状態を循環することはできません。 トグル コントロール パターンは、ラジオ ボタンではサポートされません。

 

必要なイベント

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

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

 

備考

ラジオ ボタンは、ピア ラジオ ボタンのグループの中で 1 つの選択可能なオプションを表します。 理想的には、ラジオ ボタンには、ピア ラジオ ボタンの境界を明確にするグループ化要素が必要です。 ただし、多くの場合、境界は UI 要素構造によって暗黙的に示されます。 たとえば、メニューには、メニュー項目の代わりに連続するラジオ ボタンのセットや、グループ ラベルの後、ボタンなどの操作可能な要素の前に発生するラジオ ボタンのセットが含まれている場合があります。

概念

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

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