UI オートメーションによる Calendar コントロール型のサポート
.gif "メモ") メモ |
|---|
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージ UI Automation クラスを使用する .NET Framework 開発者を対象としています。UI Automationに関する最新情報については、「Windows Automation API: UI Automation (Windows オートメーション API: UI オートメーション)」を参照してください。 |
ここでは、UI Automationによる Calendar コントロール型のサポートに関する情報を示します。 UI Automationでは、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。 これらの条件には、UI Automation ツリー構造、UI Automationのプロパティ値、コントロール パターン、および UI Automation イベントに関する特定のガイドラインが含まれます。
Calendar コントロールでは、簡単に日付を決めたり、他の日付を選択できます。
以下のセクションでは、Calendar コントロール型で必要な UI Automation ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI Automationの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows Formsのいずれの場合でも、すべてのカレンダー コントロールに当てはまります。
このトピックは、次のセクションで構成されています。
- 必須の UI オートメーション ツリー構造
- 必須の UI オートメーション プロパティ
- 必須の UI オートメーション コントロール パターン
- 必須の UI オートメーション イベント
- 関連トピック
必須の UI オートメーション ツリー構造
次の表では、カレンダー コントロールに関連した UI Automation ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに格納できるものについて説明します。 UI Automation ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
コントロール ビュー |
コンテンツ ビュー |
|---|---|
Calendar
|
Calendar
|
Calendar コントロールは、ユーザー インターフェイスのさまざまな形式で表すことができます。 UI Automation ツリーのコントロール ビューに含まれることが保証されるコントロールは、データ グリッド、ヘッダー、ヘッダー項目、およびリスト項目のコントロールだけです。
必須の UI オートメーション プロパティ
次の表に、値または定義が特にカレンダー コントロールに関連する UI Automation プロパティを示します。 UI Automation プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
UI Automation プロパティ |
値 |
説明 |
|---|---|---|
説明を参照。 |
このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。 |
|
説明を参照。 |
コントロール全体を包含する外側の四角形。 |
|
説明を参照。 |
外接する四角形が存在する場合はサポートされます。 外接する四角形の範囲内にクリック不可能な点が存在するときに特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。 |
|
Calendar |
この値は、すべての UI フレームワークで共通です。 |
|
True |
カレンダー コントロールは、UI Automation ツリーのコンテンツ ビューに常に含まれます。 |
|
True |
カレンダー コントロールは、UI Automation ツリーのコントロール ビューに常に含まれます。 |
|
説明を参照。 |
コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
|
説明を参照。 |
ドキュメント コントロールのラベル。 通常は、ドキュメントのタイトルが使用されます。 |
|
"カレンダー" |
Calendar コントロール型に対応するローカライズされた文字列。 |
|
説明を参照。 |
通常、カレンダー コントロールの名前は、当日の日付から取得されます。 |
必須の UI オートメーション コントロール パターン
すべてのカレンダー コントロールでサポートする必要がある UI Automation コントロール パターンの一覧を次の表に示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
コントロール パターン/パターン プロパティ |
サポート |
説明 |
|---|---|---|
○ |
1 か月の日付が空間的に移動できる項目になるため、カレンダー コントロールは Grid パターンを常にサポートします。 |
|
依存 |
ほとんどのカレンダー コントロールはページごとのビューのフリッピングをサポートしています。 ページごとに移動できるようにするには、Scroll パターンをサポートすることをお勧めします。 |
|
依存 |
ほとんどのカレンダー コントロールは、特定の日付、月、または年を、サブ要素の選択内容の形で保存します。 複数が選択可能なカレンダーと 1 つのみ選択可能なカレンダーがあります。 |
|
○ |
カレンダー コントロールには曜日のサブツリー内に常にヘッダーがあるため、Table パターンがサポートされる必要があります。 |
|
Ｘ |
カレンダー コントロールでは値を直接設定できないため、このコントロールに Value コントロール パターンは必要ありません。 特定の日付がコントロールに関連付けられている場合は、Selection コントロール パターンによって情報を提供します。 |
必須の UI オートメーション イベント
すべてのカレンダー コントロールでサポートする必要がある UI Automation イベントを次の表に示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
UI Automation イベント |
サポート |
説明 |
|---|---|---|
必須 |
なし |
|
BoundingRectangleProperty プロパティ変更イベント |
必須 |
なし |
IsEnabledProperty プロパティ変更イベント |
必須 |
なし |
IsOffscreenProperty プロパティ変更イベント |
必須 |
なし |
必須 |
なし |
|
必須 |
なし |
|
CurrentViewProperty プロパティ変更イベント |
依存 |
なし |
HorizontallyScrollableProperty プロパティ変更イベント |
依存 |
コントロールで Scroll コントロール パターンをサポートする場合は、このイベントをサポートする必要があります。 |
HorizontalScrollPercentProperty プロパティ変更イベント。 |
依存 |
コントロールで Scroll コントロール パターンをサポートする場合は、このイベントをサポートする必要があります。 |
HorizontalViewSizeProperty プロパティ変更イベント。 |
依存 |
コントロールで Scroll コントロール パターンをサポートする場合は、このイベントをサポートする必要があります。 |
VerticalScrollPercentProperty プロパティ変更イベント。 |
依存 |
コントロールで Scroll コントロール パターンをサポートする場合は、このイベントをサポートする必要があります。 |
VerticallyScrollableProperty プロパティ変更イベント。 |
依存 |
コントロールで Scroll コントロール パターンをサポートする場合は、このイベントをサポートする必要があります。 |
VerticalViewSizeProperty プロパティ変更イベント。 |
依存 |
コントロールで Scroll コントロール パターンをサポートする場合は、このイベントをサポートする必要があります。 |
必須 |
なし |