予定表コントロールの種類
このトピックでは、Microsoft UI オートメーション Calendar コントロールの種類のサポートについて説明します。 予定表コントロールを使用すると、ユーザーは日付を簡単に特定し、他の日付を選択できます。
次のセクションでは、Calendar コントロール型に必要なUI オートメーションツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンのサポートUI オートメーション統合するすべての予定表コントロールに適用されます。
このトピックは、次のセクションで構成されています。
一般的なツリー構造
次の表は、予定表コントロールに関連するUI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
|
|
Calendar コントロールは、ユーザー インターフェイスのさまざまな形式で表すことができます。 UI オートメーション ツリーのコントロール ビューに表示されるコントロールは、データ グリッド、ヘッダー、ヘッダー項目、およびリスト アイテム コントロールのみです。
関連するプロパティ
次の表に、値または定義が Calendar コントロールの種類に特に関連するUI オートメーションプロパティの一覧を示します。 UI オートメーションプロパティの詳細については、「UI オートメーション要素からのプロパティの取得」を参照してください。
| UI Automation のプロパティ | 値 | Notes |
|---|---|---|
| UIA_AutomationIdPropertyId | 「ノート」を参照してください。 | このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素間で一意である必要があります。 |
| UIA_BoundingRectanglePropertyId | 「ノート」を参照してください。 | コントロール全体を格納する最も外側の四角形。 |
| UIA_ClickablePointPropertyId | 「ノート」を参照してください。 | 四角形領域が存在する場合にサポートされます。 外接する四角形内のすべてのポイントがクリック可能でなく、要素が特殊なヒット テストを実行する場合は、オーバーライドしてクリック可能なポイントを指定します。 |
| UIA_ControlTypePropertyId | Calendar | この値は、すべての UI フレームワークで同じです。 |
| UIA_IsContentElementPropertyId | true | このカレンダー コントロールは、UI オートメーション ツリーのコンテンツ ビューに常に含まれます。 |
| UIA_IsControlElementPropertyId | true | このカレンダー コントロールは、UI オートメーション ツリーのコントロール ビューに常に含まれます。 |
| UIA_IsKeyboardFocusablePropertyId | 「ノート」を参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| UIA_LabeledByPropertyId | 「ノート」を参照してください。 | このプロパティの値は、ドキュメント コントロールのラベルでなければなりません。 通常、ドキュメントのタイトルが使用されます。 |
| UIA_LocalizedControlTypePropertyId | 「ノート」を参照してください。 | Calendar コントロールの種類に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "calendar" です。 |
| UIA_NamePropertyId | 「ノート」を参照してください。 | 通常、カレンダー コントロールは現在の日付からその名前を取得します。 |
必須のコントロール パターン
次の表に、すべてのカレンダー コントロールでサポートされる必要がある UI オートメーションのコントロール パターンを示します。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。
| コントロール パターン/パターン プロパティ | サポート/値 | Notes |
|---|---|---|
| IGridProvider | 必須 | カレンダー コントロールは常に Grid コントロール パターンをサポートしています。これは、1 か月以内の日数は空間的に移動できるアイテムであるためです。 |
| IScrollProvider | 依存 | ほとんどのカレンダー コントロールはページごとのビューのフリッピングをサポートしています。 ページング ナビゲーションをサポートするには、 スクロール コントロール パターンをお勧めします。 |
| ISelectionProvider | 依存 | ほとんどのカレンダー コントロールでは、サブ要素の選択として特定の日、月、または年が保持されます。 一部の予定表は複数選択可能で、他の予定表は単一選択可能です。 選択可能なサブ要素を持つ予定表コントロールは、 選択 コントロール パターンをサポートする必要があります。 |
| ITableProvider | 必須 | カレンダー コントロールは、曜日のサブツリー内に常にヘッダーを持っているため、 Table コントロール パターンをサポートする必要があります。 |
| IValueProvider | いいえ | 要素はコントロールに 直接 値を設定できないため、カレンダー コントロールには Value コントロール パターンは必要ありません。 特定の日付がコントロールに関連付けられている場合は、 Selection コントロール パターンで情報を指定する必要があります。 |
必須イベント
次の表に、予定表コントロールがサポートするために必要なUI オートメーション イベントを示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。
関連トピック