SemanticZoom コントロール型
このトピックでは、 SemanticZoom コントロール型の UI オートメーションのサポートについて説明します。
セマンティック ズームは、フォト アルバム、アプリ リスト、アドレス帳など、1 つのビュー内で大量の関連データまたはコンテンツを表示および移動するために Windows 8 で導入された手法です。 セマンティック ズームでは、コンテンツの整理と表示に 2 つの異なる分類モード ( ズーム レベル) が使用されます。 低レベル (または 拡大) モードでは、フラットな "オールアップ" 構造の項目が表示されます。高レベル (または 縮小) モードでは、グループ内の項目が表示され、ユーザーはコンテンツをすばやく移動して参照できます。 たとえば、都市のリストをズームすると、それらの都市を含む州のリストに変わる可能性があります。 プログラムのリストをズームすると、論理プログラム・グループのリストに変わる可能性があります。
特に Windows ストア アプリで使用されるセマンティック ズームの詳細については、「 セマンティック ズームのガイドライン」を参照してください。
SemanticZoom コントロール型の使用モデルは、主にプログラムによるアクセス用に存在するという点で通常とは異なります。 Microsoft UI オートメーション クライアントは、セマンティック ズーム コントロールを監視および操作して、リストのズームイン状態を制御できます。 支援技術を使用していないユーザーは、通常、タッチ ジェスチャまたはキーボード ショートカットを使用してセマンティック ズーム コントロールを直接操作します。
次のセクションでは、 SemanticZoom コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンに対する UI オートメーションのサポートを統合するすべてのセマンティック ズーム コントロールに適用されます。
このトピックは、次のセクションで構成されています。
一般的なツリー構造
次の表は、 SemanticZoom コントロールの種類に関連する UI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
|
|
または:
| コントロール ビュー | コンテンツ ビュー |
|---|---|
|
|
関連するプロパティ
次の表に、値または定義が SemanticZoom コントロール型を実装するコントロールに特に関連する UI オートメーション プロパティの一覧を示します。 UI オートメーション プロパティの詳細については、「UI オートメーション 要素からのプロパティの取得」を参照してください。
| UI Automation のプロパティ | 値 | Notes |
|---|---|---|
| UIA_AutomationIdPropertyId | 「ノート」を参照してください。 | このプロパティの値は、UI オートメーション ツリーの生ビューのすべてのピア要素間で一意である必要があります。 |
| UIA_BoundingRectanglePropertyId | 「ノート」を参照してください。 | コントロール全体を格納する最も外側の四角形。 |
| UIA_ClickablePointPropertyId | 「ノート」を参照してください。 | リスト コントロールにクリック可能なポイント (リストにフォーカスを移すためにクリックできるポイント) がある場合は、このプロパティを通じてそのポイントを公開する必要があります。 UIA_IsOffscreenPropertyId プロパティの値が TRUE の場合、このプロパティを取得しようとすると、UIA_E_NOCLICKABLEPOINT エラーが発生します。 |
| UIA_ControlTypePropertyId | SemanticZoom | |
| UIA_IsContentElementPropertyId | TRUE | |
| UIA_IsControlElementPropertyId | TRUE | |
| UIA_IsKeyboardFocusablePropertyId | FALSE | |
| UIA_LabeledByPropertyId | 「ノート」を参照してください。 | 静的テキスト ラベルがある場合、このプロパティは、そのコントロールへの参照を公開する必要があります。 |
| UIA_LocalizedControlTypePropertyId | 「ノート」を参照してください。 |
SemanticZoom コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "セマンティック ズーム" です。
メモ： 一部のフレームワークでは、これを "semanticzoom" と連結しました。 |
| UIA_NamePropertyId | 「ノート」を参照してください。 | セマンティック ズームという用語が含まれていない限り、空の文字列を使用することも、より便利な名前を指定することもできます。これにより、コントロールの種類と名前の組み合わせが混乱します。 |
必須のコントロール パターンとプロパティ
次の表に、すべてのセマンティック ズーム コントロールでサポートされる必要がある UI オートメーション コントロール パターンの一覧を示します。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。
| コントロール パターン/パターン プロパティ | サポート/値 | Notes |
|---|---|---|
| IToggleProvider | 依存 | セマンティック ズーム コントロールでは、ズームを有効または無効にするための トグル コントロール パターンがサポートされています。 ToggleState_Off はフラット、オールアップ状態に対応し、 ToggleState_On は高レベルのズームアウト ビューに対応します。 |
必須イベント
次の表に、セマンティック ズーム コントロールがサポートするために必要な UI オートメーション イベントの一覧を示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。
| UI オートメーション イベント | Notes |
|---|---|
| プロパティUIA_BoundingRectanglePropertyId 変更されたイベントです。 | |
| プロパティUIA_IsEnabledPropertyId 変更されたイベントです。 | コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。 |
| プロパティUIA_IsOffscreenPropertyId 変更されたイベントです。 | コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。 |
| プロパティUIA_ToggleToggleStatePropertyId 変更されたイベントです。 |
注釈
UI にセマンティック ズーム コントロールの動作を切り替える表示ボタンがある場合、このボタンには SemanticZoom コントロールの種類を指定しないでください。 これは直感的ではありませんが、 SemanticZoom コントロールの種類は、ズームを制御するボタンではなく、ズーム コンテンツのコンテナーを特徴付けます。 (このようなボタンは、トグル コントロール パターンを使用してボタン コントロールの種類として表現できます)。