消費者介面自動化文字屬性
本主題描述 Microsoft 消費者介面自動化如何公開文字內容) 文字屬性的格式和樣式 (屬性，並提供支援的文字屬性清單。
消費者介面自動化提供者會透過TextRange控制項模式的GetAttributeValue和FindAttribute方法公開文字屬性。 用戶端應用程式會使用 IUIAutomationTextRange：：GetAttributeValue 方法來擷取文字範圍之特定文字屬性的值。 用戶端可以使用 IUIAutomationTextRange：：FindAttribute 方法來搜尋具有特定屬性的文字文字範圍。 如果找到任何相符的文字，此方法會建立包含相符文字的新文字範圍。
TextRange控制項模式支援下列清單中的文字屬性。 屬性名稱衍生自消費者介面自動化文字屬性識別碼。 例如， AnimationStyle 屬性是由用戶端 識別為 uiautomationclient.h) 中定義的UIA_AnimationStyleAttributeId (，並由提供者 識別為 uiautomationcoreapi.h) 中所定義的Text_AnimationStyle_Attribute_GUID (。 如需每個支援之文字屬性的詳細資訊，請參閱 文字屬性識別碼。
注意
從 Windows 8 開始，支援列出的部分屬性。 如需版本支援的相關注意事項 ，請參閱文字屬性識別碼 。
本主題包含下列幾節：
註釋屬性
注釋物件和注釋類型可透過下列屬性取得。
| 屬性 | 識別碼 |
|---|---|
| AnnotationObjects | UIA_AnnotationObjectsAttributeId |
| AnnotationTypes | UIA_AnnotationTypesAttributeId |
字型屬性
字型的名稱、大小和粗細可透過下列屬性取得。
| 屬性 | 識別碼 |
|---|---|
| FontName | UIA_FontNameAttributeId |
| FontSize | UIA_FontSizeAttributeId |
| FontWeight | 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 |
| IndentationTrailing | UIA_IndentationTrailingAttributeId |
| 索引標籤 | 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 |
相關主題