次の方法で共有

ドキュメント コントロールの種類

  • [アーティクル]

このトピックでは、Document コントロールの種類に対する Microsoft UI オートメーションのサポートについて説明します。

ドキュメント コントロールを使用すると、ユーザーは複数のテキスト ページを表示および操作できます。 書式設定されていないテキストの単純な行のみをサポートする編集コントロールとは異なり、ドキュメント コントロールは、豊富なスタイルと書式設定されたテキストをホストできます

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

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

一般的なツリー構造

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

コントロール ビュー コンテンツ ビュー
  • 文書
    • 異なります
  • 文書
    • 異なります

 

関連するプロパティ

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

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

 

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

次の表に、ドキュメント コントロールでサポートするために必要な UI オートメーション コントロール パターンの一覧を示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。

Control Pattern/Pattern プロパティ サポート/値 筆記
IScrollProviderの 依存 ドキュメント コントロールは、ビューポートのそのスパンより大きいスパンにすることができます。 コンテンツがスクロール可能な場合、コントロールは Scroll コントロール パターンをサポートする必要があります。
ITextProviderの 必須 すべてのドキュメント コントロールは、Text コントロール パターンをサポートする必要があります。
IValueProviderの 依存 UI オートメーション クライアント IUIAutomationTextPattern を使用してドキュメントに関するテキスト情報を取得できますが、内部値を設定するには、値 コントロール パターンが必要です。 単純なテキスト入力は、Value コントロール パターンでのみ可能です。

 

必要なイベント

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

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

 

概念

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

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