テキスト属性のUI オートメーション
このトピックでは、Microsoft UI オートメーションがテキスト コンテンツの書式プロパティとスタイル プロパティ (テキスト属性) を公開する方法について説明し、サポートされているテキスト属性の一覧を提供します。
UI オートメーション プロバイダーは、TextRange コントロール パターンの GetAttributeValue メソッドと FindAttribute メソッドを介してテキスト属性を公開します。 クライアント アプリケーションでは、 IUIAutomationTextRange::GetAttributeValue メソッドを使用して、テキスト範囲の特定のテキスト属性の値を取得します。 クライアントは IUIAutomationTextRange::FindAttribute メソッドを使用して、特定の属性を持つテキストのテキスト範囲を検索できます。 一致するテキストが見つかった場合、 メソッドは、一致するテキストを含む新しいテキスト範囲を作成します。
次の一覧のテキスト属性は、 TextRange コントロール パターンでサポートされています。 属性名は、UI オートメーションテキスト属性識別子から派生します。 たとえば、 AnimationStyle 属性は、クライアントによって UIA_AnimationStyleAttributeId (Uiautomationclient.h で定義) として識別され、プロバイダーによって Text_AnimationStyle_Attribute_GUID (Uiautomationcoreapi.h で定義) として識別されます。 サポートされている各テキスト属性の詳細については、「 テキスト属性識別子」を参照してください。
Note
一覧表示されている属性の一部は、Windows 8 以降でサポートされています。 バージョンのサポートに関する注意事項については、「 テキスト属性識別子」を 参照してください。
このトピックは、次のセクションで構成されています。
- annotation 属性
- フォント属性
- 言語属性
- リンク属性
- ページ余白の属性
- テキストの配置属性
- テキストの色の属性
- テキスト装飾属性
- テキスト スタイル属性
- 相互作用属性と選択属性
- 関連トピック
annotation 属性
注釈オブジェクトと注釈型は、次の属性を使用して使用できます。
| 属性 | 識別子 |
|---|---|
| AnnotationObjects | UIA_AnnotationObjectsAttributeId |
| AnnotationTypes | UIA_AnnotationTypesAttributeId |
フォント属性
フォントの名前、サイズ、および太さは、次の属性を使用して使用できます。
| 属性 | 識別子 |
|---|---|
| FontName | UIA_FontNameAttributeId |
| FontSize | UIA_FontSizeAttributeId |
| フォント太さ | UIA_FontWeightAttributeId |
言語属性
テキストの言語に関する情報は、次の属性を使用して入手できます。
| 属性 | 識別子 |
|---|---|
| カルチャ | UIA_CultureAttributeId |
| TextFlowDirections | UIA_TextFlowDirectionsAttributeId |
リンク属性
次の属性は、ドキュメント内のリンクのターゲットであるテキスト範囲を提供します。
| 属性 | 識別子 |
|---|---|
| リンク | UIA_LinkAttributeId |
ページ余白の属性
テキスト範囲の外接する四角形は、ページ内のテキストの座標を公開しません。 ただし、プロバイダーは、次のテキスト属性を使用してページ余白情報を公開できます。
| 属性 | 識別子 |
|---|---|
| MarginBottom | UIA_MarginBottomAttributeId |
| MarginLeading | UIA_MarginLeadingAttributeId |
| MarginTop | UIA_MarginTopAttributeId |
| MarginTrailing | UIA_MarginTrailingAttributeId |
テキストの配置属性
インデント、タブ設定、水平方向の配置などのテキストの配置に関する情報は、次の属性を使用して使用できます。
| 属性 | 識別子 |
|---|---|
| HorizontalTextAlignment | UIA_HorizontalTextAlignmentAttributeId |
| IndentationFirstLine | UIA_IndentationFirstLineAttributeId |
| インデントリード | UIA_IndentationLeadingAttributeId |
| インデントTrailing | UIA_IndentationTrailingAttributeId |
| Tabs | UIA_TabsAttributeId |
テキストの色の属性
前景色と背景色は、次のテキスト属性を使用して使用できます。 両方の色は COLORREF データ型として指定されます。
| 属性 | 識別子 |
|---|---|
| BackgroundColor | UIA_BackgroundColorAttributeId |
| ForegroundColor | UIA_ForegroundColorAttributeId |
テキスト装飾属性
テキスト装飾には、箇条書き、下線、アニメーションなどの領域が含まれます。 テキストに先頭の行頭文字または数字が含まれている場合は、該当する場合は、行頭文字または番号に使用される記号またはテキストをテキスト ストリームに含める必要があります。
テキスト装飾に関する情報は、次の属性を使用して入手できます。
| 属性 | 識別子 |
|---|---|
| AnimationStyle | UIA_AnimationStyleAttributeId |
| BulletStyle | UIA_BulletStyleAttributeId |
| OutlineStyles | UIA_OutlineStylesAttributeId |
| OverlineColor | UIA_OverlineColorAttributeId |
| OverlineStyle | UIA_OverlineStyleAttributeId |
| StrikethroughColor | UIA_StrikethroughColorAttributeId |
| StrikethroughStyle | UIA_StrikethroughStyleAttributeId |
| UnderlineColor | UIA_UnderlineColorAttributeId |
| UnderlineStyle | UIA_UnderlineStyleAttributeId |
テキスト スタイル属性
テキスト スタイルに関する情報は、次の属性を使用できます。
| 属性 | 識別子 |
|---|---|
| CapStyle | UIA_CapStyleAttributeId |
| IsHidden | UIA_IsHiddenAttributeId |
| IsItalic | UIA_IsItalicAttributeId |
| IsReadOnly | UIA_IsReadOnlyAttributeId |
| IsSuperscript | UIA_IsSuperscriptAttributeId |
| IsSubscript | UIA_IsSubscriptAttributeId |
相互作用属性と選択属性
範囲とフォーカスの状態での現在のテキストの選択に関する情報は、次の属性を使用できます。
| 属性 | 識別子 |
|---|---|
| IsActive | UIA_IsActiveAttributeId |
| SelectionActiveEnd | UIA_SelectionActiveEndAttributeId |
| CaretPosition | UIA_CaretPositionAttributeId |
| CaretBidiMode | UIA_CaretBidiModeAttributeId |
関連トピック
-
概念