atributos de texto Automação da Interface do Usuário
Este tópico descreve como a Microsoft Automação da Interface do Usuário expõe as propriedades de formato e estilo (atributos de texto) do conteúdo textual e fornece uma lista de atributos de texto com suporte.
Automação da Interface do Usuário provedores expõem atributos de texto por meio dos métodos GetAttributeValue e FindAttribute do padrão de controle TextRange. Os aplicativos cliente usam o método IUIAutomationTextRange::GetAttributeValue para recuperar o valor de um atributo de texto específico para um intervalo de texto. Os clientes podem usar o método IUIAutomationTextRange::FindAttribute para pesquisar um intervalo de texto em busca de texto que tenha um atributo específico. Se algum texto correspondente for encontrado, o método criará um novo intervalo de texto que contém o texto correspondente.
Os atributos de texto na lista a seguir têm suporte pelo padrão de controle TextRange . Os nomes de atributo são derivados dos identificadores de atributo de texto Automação da Interface do Usuário. Por exemplo, o atributo AnimationStyle é identificado pelos clientes como UIA_AnimationStyleAttributeId (definido em Uiautomationclient.h) e por provedores como Text_AnimationStyle_Attribute_GUID (definido em Uiautomationcoreapi.h). Para obter mais informações sobre cada atributo de texto com suporte, consulte Identificadores de atributo de texto.
Observação
Alguns dos atributos listados têm suporte começando com Windows 8. Consulte Identificadores de Atributo de Texto para obter anotações sobre o suporte à versão.
Este tópico contém as seguintes seções:
- Atributos de anotação
- Atributos de fonte
- Atributos de linguagem
- Atributo link
- Atributos de margem de página
- Atributos de alinhamento de texto
- Atributos de cor de texto
- Atributos de decoração de texto
- Atributos de estilo de texto
- Atributos de interação e seleção
- Tópicos relacionados
Atributos de anotação
Objetos de anotação e tipos de anotação estão disponíveis por meio dos atributos a seguir.
| Atributo | Identificador |
|---|---|
| AnnotationObjects | UIA_AnnotationObjectsAttributeId |
| AnnotationTypes | UIA_AnnotationTypesAttributeId |
Atributos de fonte
O nome, o tamanho e o peso de uma fonte estão disponíveis por meio dos atributos a seguir.
| Atributo | Identificador |
|---|---|
| FontName | UIA_FontNameAttributeId |
| FontSize | UIA_FontSizeAttributeId |
| FontWeight | UIA_FontWeightAttributeId |
Atributos de linguagem
Informações sobre o idioma do texto estão disponíveis por meio dos atributos a seguir.
| Atributo | Identificador |
|---|---|
| Cultura | UIA_CultureAttributeId |
| TextFlowDirections | UIA_TextFlowDirectionsAttributeId |
Atributo link
O atributo a seguir fornece o intervalo de texto que é o destino de um link em um documento.
| Atributo | Identificador |
|---|---|
| Link | UIA_LinkAttributeId |
Atributos de margem de página
Os retângulos delimitador de um intervalo de texto não expõem as coordenadas do texto na página. No entanto, um provedor pode expor as informações de margem de página usando os atributos de texto a seguir.
| Atributo | Identificador |
|---|---|
| MarginBottom | UIA_MarginBottomAttributeId |
| MarginLeading | UIA_MarginLeadingAttributeId |
| MarginTop | UIA_MarginTopAttributeId |
| MarginTrailing | UIA_MarginTrailingAttributeId |
Atributos de alinhamento de texto
Informações sobre alinhamento de texto, como recuo, configurações de guia e alinhamento horizontal, estão disponíveis por meio dos atributos a seguir.
| Atributo | Identificador |
|---|---|
| HorizontalTextAlignment | UIA_HorizontalTextAlignmentAttributeId |
| IndentationFirstLine | UIA_IndentationFirstLineAttributeId |
| Recuo à esquerda | UIA_IndentationLeadingAttributeId |
| IndentationTrailing | UIA_IndentationTrailingAttributeId |
| Guias | UIA_TabsAttributeId |
Atributos de cor de texto
As cores de texto em primeiro plano e plano de fundo estão disponíveis por meio dos atributos de texto a seguir. Ambas as cores são especificadas como um tipo de dados COLORREF .
| Atributo | Identificador |
|---|---|
| BackgroundColor | UIA_BackgroundColorAttributeId |
| ForegroundColor | UIA_ForegroundColorAttributeId |
Atributos de decoração de texto
As decorações de texto incluem áreas como marcadores, sublinhados e animações. Se o texto incluir marcadores ou números à esquerda, o símbolo ou texto usado para o marcador ou número deverá ser incluído no fluxo de texto, se aplicável.
Informações sobre decorações de texto estão disponíveis por meio dos atributos a seguir.
| Atributo | Identificador |
|---|---|
| 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 |
Atributos de estilo de texto
As informações sobre estilos de texto estão disponíveis nos atributos a seguir.
| Atributo | Identificador |
|---|---|
| Capstyle | UIA_CapStyleAttributeId |
| IsHidden | UIA_IsHiddenAttributeId |
| Isitalic | UIA_IsItalicAttributeId |
| IsReadOnly | UIA_IsReadOnlyAttributeId |
| IsSuperscript | UIA_IsSuperscriptAttributeId |
| IsSubscript | UIA_IsSubscriptAttributeId |
Atributos de interação e seleção
As informações sobre a seleção de texto atual no intervalo e no estado de foco estão disponíveis nos atributos a seguir.
| Atributo | Identificador |
|---|---|
| IsActive | UIA_IsActiveAttributeId |
| SelectionActiveEnd | UIA_SelectionActiveEndAttributeId |
| CaretPosition | UIA_CaretPositionAttributeId |
| CaretBidiMode | UIA_CaretBidiModeAttributeId |
Tópicos relacionados