次の方法で共有

ボタン コントロールの種類

  • [アーティクル]

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

ボタンは、ダイアログ ボックスの [OK] ボタンや [キャンセル] ボタンなどのアクションを実行するためにユーザーが操作するオブジェクトです。 ボタン コントロールは、ユーザーが完了したい 1 つのコマンドにマップされるため、公開する簡単なコントロールです。

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

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

一般的なツリー構造

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

コントロール ビュー コンテンツ ビュー
  • ボタン
    • 画像 (0 以上)
    • テキスト (0 以上)
  • ボタン

 

関連するプロパティ

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

UI オートメーション プロパティ 価値 筆記
UIA_AcceleratorKeyPropertyId ノートを参照してください。 通常、ボタン コントロールはアクセラレータ キーをサポートし、エンド ユーザーがキーボードからボタンによって表されるアクションをすばやく実行できるようにします。
UIA_AutomationIdPropertyId ノートを参照してください。 このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素で一意である必要があります。
UIA_BoundingRectanglePropertyId ノートを参照してください。 コントロール全体を含む最も外側の四角形。
UIA_ClickablePointPropertyId ノートを参照してください。 外接する四角形がある場合にサポートされます。 外接する四角形内のすべてのポイントがクリック可能でなく、要素が特殊なヒット テストを実行する場合は、オーバーライドしてクリック可能なポイントを指定します。
UIA_ControlTypePropertyId ボタンの
UIA_HelpTextPropertyId ノートを参照してください。 ヘルプ テキストは、ボタンをアクティブ化した最終的な結果を示す必要があります。 これは通常、ツールヒントを通じて表示されるのと同じ種類の情報です。
UIA_IsContentElementPropertyId 真 ボタン コントロールは常にコンテンツである必要があります。
UIA_IsControlElementPropertyId 真 ボタン コントロールは常にコントロールである必要があります。
UIA_IsKeyboardFocusablePropertyId ノートを参照してください。 コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
UIA_LabeledByPropertyId ヌル ボタン コントロールは、その内容によって自己ラベル付けされます。
UIA_LocalizedControlTypePropertyId ノートを参照してください。 Button コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の場合は "button" です。
UIA_NamePropertyId ノートを参照してください。 ボタン コントロールの名前は、ラベル付けするために使用されるテキストです。 ボタンのラベル付けに画像を使用する場合は常に、ボタンの Name プロパティに代替テキストを指定する必要があります。

 

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

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

Control Pattern/Pattern プロパティ サポート/値 筆記
IExpandCollapseProviderをする ノートを参照してください。 ボタンが分割ボタンの子としてホストされている場合、子ボタンは、呼び出し またはトグル コントロール パターンではなく、ExpandCollapse コントロール パターン サポートできます。 ExpandCollapse コントロール パターンは、メニューまたはボタン要素に関連付けられているその他のサブ構造を開いたり閉じたりするために使用できます。
IInvokeProviderの ノートを参照してください。 すべてのボタンは、呼び出し コントロール パターンまたは トグル コントロール パターンをサポートする必要がありますが、両方はサポートしていません。 ボタンがユーザーの要求に応じてコマンドを実行する場合は、呼び出しコントロール パターンをサポートする必要があります。 このコマンドは、切り取り、コピー、貼り付け、削除などの 1 つの操作にマップされます。
IToggleProviderの ノートを参照してください。 すべてのボタンは、呼び出し コントロール パターンまたは トグル コントロール パターンをサポートする必要がありますが、両方はサポートしていません。 ボタンが一連の最大 3 つの状態を循環できる場合は、トグル コントロール パターンをサポートする必要があります。 通常、これは特定の機能のオン/オフ スイッチと見なされます。

 

必要なイベント

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

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

 

概念

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

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