Udostępnij przez

Atrybuty tekstu automatyzacji interfejsu użytkownika

W tym temacie opisano, jak usługa Microsoft UI Automation uwidacznia właściwości formatu i stylu (atrybuty tekstowe) zawartości tekstowej i zawiera listę obsługiwanych atrybutów tekstowych.

Dostawcy automatyzacji interfejsu użytkownika uwidaczniają atrybuty tekstowe za pomocą GetAttributeValue i metod findAttribute wzorca kontrolki TextRange. Aplikacje klienckie używają metody IUIAutomationTextRange::GetAttributeValue, aby pobrać wartość określonego atrybutu tekstowego dla zakresu tekstu. Klienci mogą użyć metody IUIAutomationTextRange::FindAttribute w celu wyszukania zakresu tekstu zawierającego określony atrybut. Jeśli zostanie znaleziony pasujący tekst, metoda tworzy nowy zakres tekstu zawierający pasujący tekst.

Atrybuty tekstowe na poniższej liście są obsługiwane przez wzorzec kontrolki TextRange. Nazwy atrybutów pochodzą z identyfikatorów atrybutów tekstowych automatyzacji interfejsu użytkownika. Na przykład atrybut AnimationStyle jest identyfikowany przez klientów jako UIA_AnimationStyleAttributeId (zdefiniowany w Uiautomationclient.h) i przez dostawców jako Text_AnimationStyle_Attribute_GUID (zdefiniowany w Uiautomationcoreapi.h). Aby uzyskać więcej informacji na temat każdego obsługiwanego atrybutu tekstowego, zobacz Text Attribute Identifiers.

Nuta

Niektóre wymienione atrybuty są obsługiwane począwszy od systemu Windows 8. Aby uzyskać uwagi dotyczące obsługi wersji, zobacz Text Attribute Identifiers (Identyfikatory atrybutów tekstowych).

 

Ten temat zawiera następujące sekcje:

Atrybuty adnotacji

Obiekty adnotacji i typy adnotacji są dostępne za pośrednictwem następujących atrybutów.

Atrybut Identyfikator
AnnotationObjects UIA_AnnotationObjectsAttributeId
AnnotationTypes UIA_AnnotationTypesAttributeId

 

Atrybuty czcionki

Nazwa, rozmiar i waga czcionki są dostępne za pomocą następujących atrybutów.

Atrybut Identyfikator
FontName UIA_FontNameAttributeId
FontSize UIA_FontSizeAttributeId
FontWeight UIA_FontWeightAttributeId

 

Atrybuty języka

Informacje o języku tekstu są dostępne za pośrednictwem następujących atrybutów.

Atrybut Identyfikator
kultury UIA_CultureAttributeId
TextFlowDirections UIA_TextFlowDirectionsAttributeId

 

Poniższy atrybut zawiera zakres tekstu, który jest elementem docelowym linku w dokumencie.

Atrybut Identyfikator
Link UIA_LinkAttributeId

 

Atrybuty marginesu strony

Prostokąty ograniczenia zakresu tekstu nie uwidaczniają współrzędnych tekstu na stronie. Jednak dostawca może uwidocznić informacje o marginesie strony przy użyciu następujących atrybutów tekstowych.

Atrybut Identyfikator
MarginBottom UIA_MarginBottomAttributeId
MarginLeading UIA_MarginLeadingAttributeId
MarginTop UIA_MarginTopAttributeId
MarginTrailing UIA_MarginTrailingAttributeId

 

Atrybuty wyrównania tekstu

Informacje o wyrównaniu tekstu, takie jak wcięcia, ustawienia tabulatora i wyrównanie w poziomie, są dostępne za pośrednictwem następujących atrybutów.

Atrybut Identyfikator
HorizontalTextAlignment UIA_HorizontalTextAlignmentAttributeId
wcięcieFirstLine UIA_IndentationFirstLineAttributeId
wcięcieLeading UIA_IndentationLeadingAttributeId
wcięcie UIA_IndentationTrailingAttributeId
kart UIA_TabsAttributeId

 

Atrybuty koloru tekstu

Kolory tekstu pierwszego planu i tła są dostępne za pomocą następujących atrybutów tekstu. Oba kolory są określane jako typ danych COLORREF.

Atrybut Identyfikator
BackgroundColor UIA_BackgroundColorAttributeId
ForegroundColor UIA_ForegroundColorAttributeId

 

Atrybuty dekoracji tekstu

Dekoracje tekstu obejmują obszary, takie jak punktory, podkreślenie i animacje. Jeśli tekst zawiera punktory wiodące lub cyfry, symbol lub tekst używany dla punktora lub liczby powinien być uwzględniony w strumieniu tekstowym, jeśli ma to zastosowanie.

Informacje o dekoracjach tekstu są dostępne za pośrednictwem następujących atrybutów.

Atrybut Identyfikator
AnimationStyle UIA_AnimationStyleAttributeId
BulletStyle UIA_BulletStyleAttributeId
Style konspektu UIA_OutlineStylesAttributeId
OverlineColor UIA_OverlineColorAttributeId
OverlineStyle UIA_OverlineStyleAttributeId
StrikethroughColor UIA_StrikethroughColorAttributeId
StrikethroughStyle UIA_StrikethroughStyleAttributeId
UnderlineColor UIA_UnderlineColorAttributeId
UnderlineStyle UIA_UnderlineStyleAttributeId

 

Atrybuty stylu tekstu

Informacje o stylach tekstu są dostępne, choć następujące atrybuty.

Atrybut Identyfikator
CapStyle UIA_CapStyleAttributeId
IsHidden UIA_IsHiddenAttributeId
IsItalic UIA_IsItalicAttributeId
IsReadOnly UIA_IsReadOnlyAttributeId
IsSuperscript UIA_IsSuperscriptAttributeId
IsSubscript UIA_IsSubscriptAttributeId

 

Interakcje i atrybuty wyboru

Informacje o bieżącym zaznaczeniu tekstu w zakresie i stanie koncentracji uwagi są dostępne, choć następujące atrybuty.

Atrybut Identyfikator
IsActive UIA_IsActiveAttributeId
SelectionActiveEnd UIA_SelectionActiveEndAttributeId
CaretPosition UIA_CaretPositionAttributeId
CaretBidiMode UIA_CaretBidiModeAttributeId

 

koncepcyjne

Informacje o wzorcach kontrolki Automatyzacja interfejsu użytkownika i TextRange

wzorce kontrolek Text And TextRange

praca z kontrolkami opartymi na tekście

 

 

  • Last updated on