atributos de texto de Automatización de la interfaz de usuario

En este tema se describe cómo Microsoft Automatización de la interfaz de usuario expone las propiedades de formato y estilo (atributos de texto) del contenido textual y proporciona una lista de atributos de texto admitidos.

Automatización de la interfaz de usuario proveedores exponen atributos de texto a través de los métodos GetAttributeValue y FindAttribute del patrón de control TextRange. 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 que tenga un atributo determinado. Si se encuentra algún 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 Automatización de la interfaz de usuario. Por ejemplo, los clientes identifican el atributo AnimationStyle como UIA_AnimationStyleAttributeId (definido 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 atributos 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 siguientes secciones:

• Atributos de anotación
• Atributos de fuente
• Atributos de lenguaje
• Atributo de vínculo
• Atributos de margen de página
• 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 siguientes atributos.

Atributo	Identificador
AnnotationObjects	UIA_AnnotationObjectsAttributeId
AnnotationTypes	UIA_AnnotationTypesAttributeId

 

Atributos de fuente

El nombre, el tamaño y el peso de una fuente están disponibles a través de los siguientes atributos.

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
Referencia cultural	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
Vínculo	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 de margen de página mediante los siguientes atributos de texto.

Atributo	Identificador
MarginBottom	UIA_MarginBottomAttributeId
MarginLeading	UIA_MarginLeadingAttributeId
MarginTop	UIA_MarginTopAttributeId
MarginTrailing	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
SangríaLeading	UIA_IndentationLeadingAttributeId
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, esquematización 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	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 a través de los siguientes atributos.

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 través de los siguientes atributos.

Atributo	Identificador
IsActive	UIA_IsActiveAttributeId
SelectionActiveEnd	UIA_SelectionActiveEndAttributeId
CaretPosition	UIA_CaretPositionAttributeId
CaretBidiMode	UIA_CaretBidiModeAttributeId

 

Temas relacionados

Conceptual

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