CheckBox コントロールの種類

  • [アーティクル]

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

チェック ボックスは、ユーザーが対話的にその状態を循環させることが可能な状態を示すために使用されるオブジェクトです。 チェック ボックスでは、2 項 (はい/いいえ)、(オン/オフ) または 3 項 (オン/オフ、不定) のいずれかのオプションをユーザーに提示できます。

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

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

一般的なツリー構造

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

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

 

関連するプロパティ

次の表に、値または定義が CheckBox コントロール型に特に関連するUI オートメーションプロパティの一覧を示します。 UI オートメーションプロパティの詳細については、「UI オートメーション要素からのプロパティの取得」を参照してください。

UI Automation のプロパティ 値 Notes
UIA_AutomationIdPropertyId 「ノート」を参照してください。 このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素間で一意である必要があります。
UIA_BoundingRectanglePropertyId 「ノート」を参照してください。 コントロール全体を格納する最も外側の四角形。
UIA_ClickablePointPropertyId 「ノート」を参照してください。 四角形領域が存在する場合にサポートされます。 外接する四角形内のすべてのポイントがクリック可能でなく、要素が特殊なヒット テストを実行する場合は、オーバーライドしてクリック可能なポイントを指定します。
UIA_ControlTypePropertyId CheckBox
UIA_IsContentElementPropertyId true このプロパティの値は常に TRUE である必要があります。 つまり、チェック ボックス コントロールが常に UI オートメーション ツリーのコンテンツ ビューに含まれている必要があります。
UIA_IsControlElementPropertyId true このプロパティの値は常に TRUE である必要があります。 つまり、チェック ボックス コントロールが常に UI オートメーション ツリーのコントロール ビューに含まれている必要があります。
UIA_IsKeyboardFocusablePropertyId 「ノート」を参照してください。 コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
UIA_LabeledByPropertyId [Null] チェック ボックス コントロールは自己ラベル付けです。
UIA_LocalizedControlTypePropertyId 「ノート」を参照してください。 CheckBox コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "チェック ボックス" です。
UIA_NamePropertyId 「ノート」を参照してください。 チェック ボックス コントロールの IUIAutomationElement::CurrentName (または CachedName) プロパティの値は、トグル状態を維持するボックスの横に表示されるテキストです。

 

必須のコントロール パターン

次の表に、すべてのチェック ボックス コントロールでサポートされる必要がある UI オートメーション コントロールのパターンを示します。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。

コントロール パターン/パターン プロパティ サポート/値 Notes
IToggleProvider 必須 チェック ボックスはトグル コントロール パターンをサポートし、チェック ボックスをプログラムで内部状態に切り替えることができます。

 

必須イベント

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

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

 

DefaultAction

チェック ボックスの既定の動作では、ラジオ ボタンにフォーカスが設定されて、その現在の状態を切り替えます。 前述のように、チェック ボックスには、バイナリ (Yes/No または On/Off) の決定がユーザーまたは 3 次 (オン、オフ、不確定) のいずれかに表示されます。 チェック ボックスが 2 項の場合、既定の動作では、「オン」の状態が「オフ」になり、「オフ」の状態が「オン」になります。 3 つ目のチェック ボックスでは、既定のアクションは、ユーザーが連続したマウス クリックをコントロールに送信した場合と同じ順序で、チェック ボックスの状態を順番に切り替えます。

概念

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

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