Atributos de texto de automatización de la interfaz de usuario
En este tema se describe cómo Microsoft UI Automation expone las propiedades de formato y estilo (atributos de texto) del contenido textual y proporciona una lista de atributos de texto admitidos.
Los proveedores de automatización de la interfaz de usuario exponen atributos de texto a través de los métodos de GetAttributeValue y FindAttribute del patrón de control TextRange de. Las aplicaciones cliente usan el método IUIAutomationTextRange::GetAttributeValue para recuperar el valor de un atributo de texto determinado para un intervalo de texto. Los clientes pueden usar el método IUIAutomationTextRange::FindAttribute para buscar un intervalo de texto para el texto que tiene un atributo determinado. Si se encuentra texto coincidente, el método crea un nuevo intervalo de texto que contiene el texto coincidente.
Los atributos de texto de la lista siguiente son compatibles con el patrón de control TextRange. Los nombres de atributo se derivan de los identificadores de atributo de texto de Automatización de la interfaz de usuario. Por ejemplo, el atributo animationStyle de se identifica mediante clientes como UIA_AnimationStyleAttributeId (definidos en Uiautomationclient.h) y por proveedores como Text_AnimationStyle_Attribute_GUID (definidos en Uiautomationcoreapi.h). Para obtener más información sobre cada atributo de texto admitido, vea identificadores de atributo de texto.
Nota
Algunos de los atributos enumerados se admiten a partir de Windows 8. Consulte identificadores de atributos de texto para obtener notas sobre la compatibilidad con versiones.
Este tema contiene las secciones siguientes:
- atributos de anotación de
- atributos de fuente de
- atributos de lenguaje de
- de atributos de vínculo de
- atributos de margen de página de
- atributos de alineación de texto
- atributos de color de texto
- atributos de decoración de texto
- atributos de estilo de texto
- atributos de interacción y selección
- temas relacionados
Atributos de anotación
Los objetos de anotación y los tipos de anotación están disponibles a través de los atributos siguientes.
| Atributo | Identificador |
|---|---|
| AnnotationObjects de | UIA_AnnotationObjectsAttributeId |
| AnnotationTypes de | UIA_AnnotationTypesAttributeId |
Atributos de fuente
El nombre, el tamaño y el peso de una fuente están disponibles a través de los atributos siguientes.
| Atributo | Identificador |
|---|---|
| FontName | UIA_FontNameAttributeId |
| FontSize | UIA_FontSizeAttributeId |
| FontWeight | UIA_FontWeightAttributeId |
Atributos de lenguaje
La información sobre el idioma del texto está disponible a través de los siguientes atributos.
| Atributo | Identificador |
|---|---|
| cultural de | UIA_CultureAttributeId |
| TextFlowDirections | UIA_TextFlowDirectionsAttributeId |
Atributo de vínculo
El atributo siguiente proporciona el intervalo de texto que es el destino de un vínculo de un documento.
| Atributo | Identificador |
|---|---|
| link | UIA_LinkAttributeId |
Atributos de margen de página
Los rectángulos delimitadores de un intervalo de texto no exponen las coordenadas del texto de la página. Sin embargo, un proveedor puede exponer la información del margen de página mediante los siguientes atributos de texto.
| Atributo | Identificador |
|---|---|
| MarginBottom | UIA_MarginBottomAttributeId |
| marginLeading | UIA_MarginLeadingAttributeId |
| MarginTop | UIA_MarginTopAttributeId |
| marginTrailing de | UIA_MarginTrailingAttributeId |
Atributos de alineación de texto
La información sobre la alineación de texto, como la sangría, la configuración de tabulación y la alineación horizontal, está disponible a través de los atributos siguientes.
| Atributo | Identificador |
|---|---|
| HorizontalTextAlignment | UIA_HorizontalTextAlignmentAttributeId |
| indentationFirstLine | UIA_IndentationFirstLineAttributeId |
| indentationLeading | UIA_IndentationLeadingAttributeId |
| de sangríaTrailing | UIA_IndentationTrailingAttributeId |
| pestañas | UIA_TabsAttributeId |
Atributos de color de texto
Los colores de texto en primer plano y de fondo están disponibles a través de los siguientes atributos de texto. Ambos colores se especifican como un tipo de datos COLORREF.
| Atributo | Identificador |
|---|---|
| BackgroundColor | UIA_BackgroundColorAttributeId |
| ForegroundColor | UIA_ForegroundColorAttributeId |
Atributos de decoración de texto
Las decoraciones de texto incluyen áreas como viñetas, subrayado y animaciones. Si el texto incluye viñetas o números iniciales, el símbolo o texto usado para la viñeta o el número deben incluirse en la secuencia de texto, si procede.
La información sobre las decoraciones de texto está disponible a través de los siguientes atributos.
| Atributo | Identificador |
|---|---|
| AnimationStyle | UIA_AnimationStyleAttributeId |
| bulletStyle | UIA_BulletStyleAttributeId |
| outlineStyles | UIA_OutlineStylesAttributeId |
| OverlineColor | UIA_OverlineColorAttributeId |
| overlineStyle | UIA_OverlineStyleAttributeId |
| strikethroughColor de | UIA_StrikethroughColorAttributeId |
| strikethroughStyle | UIA_StrikethroughStyleAttributeId |
| UnderlineColor | UIA_UnderlineColorAttributeId |
| UnderlineStyle | UIA_UnderlineStyleAttributeId |
Atributos de estilo de texto
La información sobre los estilos de texto está disponible aunque los atributos siguientes.
| Atributo | Identificador |
|---|---|
| CapStyle | UIA_CapStyleAttributeId |
| IsHidden | UIA_IsHiddenAttributeId |
| isItalic | UIA_IsItalicAttributeId |
| isReadOnly | UIA_IsReadOnlyAttributeId |
| IsSuperscript | UIA_IsSuperscriptAttributeId |
| IsSubscript | UIA_IsSubscriptAttributeId |
Atributos de interacción y selección
La información sobre la selección de texto actual en el intervalo y el estado de foco está disponible a pesar de los siguientes atributos.
| Atributo | Identificador |
|---|---|
| IsActive | UIA_IsActiveAttributeId |
| SelectionActiveEnd | UIA_SelectionActiveEndAttributeId |
| CaretPosition | UIA_CaretPositionAttributeId |
| CaretBidiMode | UIA_CaretBidiModeAttributeId |
Temas relacionados
-
conceptual de
-
Acerca de los patrones de control Text y TextRange de automatización de la interfaz de usuario