次の方法で共有

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

  • [アーティクル]

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

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

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

一般的なツリー構造

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

コントロール ビュー コンテンツ ビュー
  • 暦
    • DataGrid
      • ヘッダー (0 または 1)
        • HeaderItem (0 または 7、数量は列に表示される日数によって異なります)
      • ListItem (数量は表示日数によって異なります)
      • ボタン (0 または 2。予定表ビューのページング用)
  • 暦
    • ListItem (数量は表示日数によって異なります)

 

予定表コントロールは、ユーザー インターフェイス内でさまざまな形式で表すことができます。 UI オートメーション ツリーのコントロール ビューに表示されるコントロールは、データ グリッド、ヘッダー、ヘッダー項目、およびリスト項目コントロールだけです。

関連するプロパティ

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

UI オートメーション プロパティ 価値 筆記
UIA_AutomationIdPropertyId ノートを参照してください。 このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素で一意である必要があります。
UIA_BoundingRectanglePropertyId ノートを参照してください。 コントロール全体を含む最も外側の四角形。
UIA_ClickablePointPropertyId ノートを参照してください。 外接する四角形がある場合にサポートされます。 外接する四角形内のすべてのポイントがクリック可能でなく、要素が特殊なヒット テストを実行する場合は、オーバーライドしてクリック可能なポイントを指定します。
UIA_ControlTypePropertyId 予定表 の この値は、すべての UI フレームワークで同じです。
UIA_IsContentElementPropertyId 真 カレンダー コントロールは、UI オートメーション ツリーのコンテンツ ビューに常に含まれます。
UIA_IsControlElementPropertyId 真 カレンダー コントロールは、常に UI オートメーション ツリーのコントロール ビューに含まれます。
UIA_IsKeyboardFocusablePropertyId ノートを参照してください。 コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
UIA_LabeledByPropertyId ノートを参照してください。 このプロパティの値は、ドキュメント コントロールのラベルである必要があります。 通常、ドキュメントのタイトルが使用されます。
UIA_LocalizedControlTypePropertyId ノートを参照してください。 Calendar コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の場合は "calendar" です。
UIA_NamePropertyId ノートを参照してください。 カレンダー コントロールは通常、現在の日付からその名前を取得します。

 

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

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

Control Pattern/Pattern プロパティ サポート/値 筆記
IGridProviderの 必須 カレンダー コントロールは常に Grid コントロール パターンをサポートしています。これは、1 か月以内の日数は空間的に移動できるアイテムであるためです。
IScrollProviderの 依存 ほとんどの予定表コントロールでは、ページごとのビューの反転がサポートされています。 ページング ナビゲーションをサポートするには、スクロール コントロール パターンをお勧めします。
ISelectionProviderの 依存 ほとんどのカレンダー コントロールは、サブ要素の選択として特定の日、月、または年を保持します。 一部の予定表は複数選択可能で、その他は単一の選択可能です。 選択可能なサブ要素を持つ予定表コントロールは、選択 コントロール パターンをサポートする必要があります。
ITableProviderの 必須 カレンダー コントロールには、曜日のサブツリー内に常にヘッダーが含まれているため、Table コントロール パターンがサポートされている必要があります。
IValueProviderの いいえ Value コントロール パターンは、要素がコントロールに直接値を設定できないため、カレンダー コントロールには必要ありません。 特定の日付がコントロールに関連付けられている場合は、Selection コントロール パターンによって情報を提供する必要があります。

 

必要なイベント

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

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

 

概念

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

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