次の方法で共有


予定表コントロールの種類

このトピックでは、Microsoft UI オートメーション Calendar コントロールの種類のサポートについて説明します。 予定表コントロールを使用すると、ユーザーは日付を簡単に特定し、他の日付を選択できます。

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

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

一般的なツリー構造

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

コントロール ビュー コンテンツ ビュー
  • Calendar
    • DataGrid
      • Header (0 または 1)
        • HeaderItem (0 または 7、数量は列に表示される日数によって異なります)
      • ListItem (数量は表示される日数によって異なる)
      • Button (0 または 2、カレンダー ビューのページ移動用)
  • Calendar
    • ListItem (数量は表示される日数によって異なる)

 

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」を参照してください。

UI オートメーション イベント Notes
UIA_AutomationFocusChangedEventId
プロパティ変更イベントUIA_BoundingRectanglePropertyId
プロパティ変更イベントUIA_IsEnabledPropertyId コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベントUIA_IsOffscreenPropertyId コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。
UIA_LayoutInvalidatedEventId
プロパティ変更イベントUIA_MultipleViewCurrentViewPropertyIdします。 コントロールが MultipleView コントロール パターンの CurrentView プロパティをサポートしている場合は、このイベントをサポートする必要があります。
UIA_StructureChangedEventId
プロパティ変更イベントUIA_ScrollHorizontallyScrollablePropertyIdします。 コントロールが スクロール コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベントUIA_ScrollHorizontalScrollPercentPropertyIdします。 コントロールが スクロール コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベントUIA_ScrollHorizontalViewSizePropertyIdします。 コントロールが スクロール コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベントUIA_ScrollVerticalScrollPercentPropertyIdします。 コントロールが スクロール コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベントUIA_ScrollVerticallyScrollablePropertyIdします。 コントロールが スクロール コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベントUIA_ScrollVerticalViewSizePropertyId します。 コントロールが スクロール コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。
UIA_Selection_InvalidatedEventId

 

概念

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

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