ウィンドウ コントロールの種類
このトピックでは、Windows コントロール型の Microsoft UI オートメーション サポートについて説明します。
ウィンドウ コントロールは、子オブジェクト (タイトル バー、クライアント、その他のオブジェクトなど) が含まれているウィンドウ フレームで構成されます。
次のセクションでは、Window コントロール型に必要なUI オートメーションツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーション要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンのサポートUI オートメーション統合するすべてのウィンドウ コントロールに適用されます。
このトピックは、次のセクションで構成されています。
一般的なツリー構造
次の表は、ウィンドウ コントロールに関連するUI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
|
|
関連するプロパティ
次の表に、ウィンドウ コントロールに特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーションプロパティの詳細については、「UI オートメーション要素からのプロパティの取得」を参照してください。
| UI Automation のプロパティ | 値 | Notes |
|---|---|---|
| UIA_AutomationIdPropertyId | 「ノート」を参照してください。 | このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素間で一意である必要があります。 |
| UIA_BoundingRectanglePropertyId | 「ノート」を参照してください。 | コントロール全体を格納する最も外側の四角形。 |
| UIA_ClickablePointPropertyId | 「ノート」を参照してください。 | ウィンドウ コントロールには、ウィンドウを選択または選択解除するクリック可能なポイントが必要です。 |
| UIA_ControlTypePropertyId | ウィンドウ | この値は、すべての UI フレームワークで同じです。 |
| UIA_IsContentElementPropertyId | true | ウィンドウ コントロールは常に、UI オートメーション ツリーのコンテンツ ビューに含まれます。 |
| UIA_IsControlElementPropertyId | true | ウィンドウ コントロールは、常にUI オートメーション ツリーのコントロール ビューに含まれます。 |
| UIA_IsKeyboardFocusablePropertyId | 「ノート」を参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| UIA_LabeledByPropertyId | NULL | ウィンドウ コントロールには静的ウィンドウ ラベルがありません。 |
| UIA_LocalizedControlTypePropertyId | 「ノート」を参照してください。 | Window コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "window" です。 |
| UIA_NamePropertyId | 「ノート」を参照してください。 | ウィンドウ コントロールには常に、ユーザーがアイテムの最もセマンティック識別子として関連付ける内容に関連するプライマリ ウィンドウ要素が含まれます。 |
必須のコントロール パターン
次の表に、ウィンドウ コントロールでサポートされる必要がある UI オートメーション コントロール パターンを示します。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。
| コントロール パターン/パターン プロパティ | サポート/値 | Notes |
|---|---|---|
| IDockProvider | 条件付き | ウィンドウをドッキングできる場合は、 Dock コントロール パターンをサポートする必要があります。 |
| ITransformProvider | 必須 | Transform コントロール パターンを使用すると、ウィンドウを画面上で移動、サイズ変更、または回転できます。 (Windows ストア アプリには適用されません)。) |
| IWindowProvider | 必須 | ウィンドウ コントロール パターンを使用すると、ウィンドウに対する特定の操作が可能になります。 |
必須イベント
次の表に、Window コントロールがサポートするために必要なUI オートメーション イベントの一覧を示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。
関連トピック
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示