Compartir a través de


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

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

 

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

 

conceptual de

Acerca de los patrones de control Text y TextRange de automatización de la interfaz de usuario

patrones de control Text y TextRange

trabajar con controles basados en texto