注
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、「Windows Automation API: UI オートメーション 」を参照してください。
このトピックでは、ドキュメント コントロールの種類に対する UI オートメーションのサポートについて説明します。 UI オートメーションでは、コントロール型は、 ControlTypeProperty プロパティを使用するためにコントロールが満たす必要がある一連の条件です。 条件には、UI オートメーション ツリー構造、UI オートメーション プロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。
ドキュメント コントロールを使用すると、ユーザーは複数のテキスト ページを表示および操作できます。 書式設定されていないテキストの単純な行のみをサポートする編集コントロールとは異なり、ドキュメント コントロールは、豊富なスタイルと書式設定されたテキストをホストできます。
次のセクションでは、Document コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、Windows Presentation Foundation (WPF)、Win32、Windows フォームのいずれであっても、すべてのドキュメント コントロールに適用されます。
必要な UI オートメーション ツリー構造
次の表は、ドキュメント コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに含めることができる内容を示しています。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
| ドキュメント -異なります |
ドキュメント -異なります |
必要な UI オートメーション プロパティ
次の表に、値または定義がドキュメント コントロールに特に関連する UI オートメーション プロパティの一覧を示します。 UI オートメーション プロパティの詳細については、「 クライアントの UI オートメーション プロパティ」を参照してください。
| UI オートメーション プロパティ | 価値 | 注記 |
|---|---|---|
| AutomationIdProperty | ノートを参照してください。 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
| BoundingRectangleProperty | ノートを参照してください。 | コントロール全体を含む最も外側の四角形。 |
| ClickablePointProperty | ノートを参照してください。 | ドキュメントにはクリック可能なポイントがあり、ドキュメント コンテナー内のいずれかの要素のドキュメントにフォーカスが移動します。 |
| ControlTypeProperty | ドキュメント | この値は、すべての UI フレームワークで同じです。 |
| IsContentElementProperty | 正しい | ドキュメント コントロールは、常に UI オートメーション ツリーのコンテンツ ビューに含まれます。 |
| IsControlElementProperty | 正しい | ドキュメント コントロールは、常に UI オートメーション ツリーのコントロール ビューに含まれます。 |
| IsKeyboardFocusableProperty | ノートを参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| LabeledByProperty | ノートを参照してください。 | このプロパティの値は、ドキュメント コントロールのラベルである必要があります。 通常、ドキュメントのタイトルが使用されます。 |
| LocalizedControlTypeProperty | "document" | Document コントロール型に対応するローカライズされた文字列。 |
| NameProperty | ノートを参照してください。 | 通常、ドキュメント コントロールは、読み込まれるファイル名から名前を取得します。 これは、多くの場合、包含ウィンドウまたはフレーム タイトルに表示されます。 |
必要な UI オートメーション コントロール パターン
次の表に、ドキュメント コントロールでサポートするために必要な UI オートメーション コントロール パターンの一覧を示します。 コントロール パターンの詳細については、「 UI オートメーション コントロール パターンの概要」を参照してください。
| コントロール パターン | 支援 | 注記 |
|---|---|---|
| IScrollProvider | 依存 | ドキュメント コントロールは、ビューポートのそのスパンより大きいスパンにすることができます。 コンテンツがスクロール可能な場合、コントロールは Scroll コントロール パターンをサポートする必要があります。 |
| ITextProvider | 必須 | ドキュメント コントロールは、ビューポートのそのスパンより大きいスパンにすることができます。 コンテンツがスクロール可能な場合、コントロールは Scroll コントロール パターンをサポートする必要があります。 |
| IValueProvider | 決してない | ドキュメント コントロールは、多くの場合、コントロールの内容が複数のページにまたがるため、このコントロール パターンをサポートしていません。 UI オートメーション クライアントは、 TextPattern を使用してドキュメントに関するテキスト情報を取得する必要があります。 |
必要な UI オートメーション イベント
次の表に、すべてのドキュメント コントロールでサポートされる必要がある UI オートメーション イベントを示します。 イベントの詳細については、「 UI オートメーション イベントの概要」を参照してください。
| UI オートメーション イベント | 支援 | 注記 |
|---|---|---|
| AutomationFocusChangedEvent | 必須 | 無し |
| BoundingRectangleProperty プロパティ変更イベント。 | 必須 | 無し |
| IsEnabledProperty プロパティ変更イベント。 | 必須 | 無し |
| IsOffscreenProperty プロパティ変更イベント。 | 必須 | 無し |
| StructureChangedEvent | 必須 | 無し |
| HorizontallyScrollableProperty プロパティ変更イベント。 | 必須 | 無し |
| HorizontalScrollPercentProperty プロパティ変更イベント。 | 必須 | 無し |
| HorizontalViewSizeProperty プロパティ変更イベント。 | 必須 | 無し |
| VerticalScrollPercentProperty プロパティ変更イベント。 | 必須 | 無し |
| VerticallyScrollableProperty プロパティ変更イベント。 | 必須 | 無し |
| VerticalViewSizeProperty プロパティ変更イベント。 | 必須 | 無し |
| InvalidatedEvent | 依存 | コントロールが Selection コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。 |
| TextSelectionChangedEvent | 必須 | 無し |
| TextChangedEvent | 必須 | 無し |
| ValueProperty プロパティ変更イベント。 | 決してない | 無し |