Identificadores de propiedad de elemento automation

En este tema se describen las constantes con nombre que identifican las propiedades de los elementos de Automatización de la interfaz de usuario de Microsoft.

Constante o valor Descripción
UIA_AcceleratorKeyPropertyId
30006
Identifica la propiedad AcceleratorKey , que es una cadena que contiene las combinaciones de teclas de aceleración (también denominada tecla de método abreviado) para el elemento de automatización.
Las combinaciones de teclas de método abreviado invocan una acción. Por ejemplo, CTRL+O se usa a menudo para invocar el cuadro de diálogo Común abrir archivo. Un elemento de automatización que tiene la propiedad AcceleratorKey puede implementar el patrón de control Invoke para la acción equivalente al comando de método abreviado.
Tipo de variante: VT_BSTR
Valor predeterminado: cadena vacía.
UIA_AccessKeyPropertyId
30007
Identifica la propiedad AccessKey , que es una cadena que contiene el carácter de clave de acceso para el elemento de automatización.
Una tecla de acceso (a veces denominada mnemonic) es un carácter en el texto de un menú, un elemento de menú o una etiqueta de un control como un botón, que activa la función de menú asociada. Por ejemplo, para abrir el menú Archivo, para el que la tecla de acceso suele ser F, el usuario presionaría ALT+F.
Tipo de variante: VT_BSTR
Valor predeterminado: cadena vacía.
UIA_AnnotationObjectsPropertyId
30156
Identifica la propiedad AnnotationObjects , que es una lista de objetos de anotación en un documento, como comentario, encabezado, pie de página, etc.
Tipo de variante: VT_I4 VT_ARRAY |
Valor predeterminado: matriz vacía
UIA_AnnotationTypesPropertyId
30155
Identifica la propiedad AnnotationTypes , que es una lista de los tipos de anotaciones de un documento, como comentario, encabezado, pie de página, etc.
Tipo de variante: VT_I4 VT_ARRAY |
Valor predeterminado: matriz vacía
UIA_AriaPropertiesPropertyId
30102
Identifica la propiedad AriaProperties , que es una cadena con formato que contiene la información de la propiedad Aplicación de Internet enriquecida accesible (ARIA) para el elemento de automatización. Para obtener más información sobre la asignación de estados y propiedades de ARIA a las propiedades y funciones de automatización de la interfaz de usuario, vea Ui Automation for W3C Accessible Rich Internet Applications Specification.
AriaProperties es una colección de pares Nombre/Valor con delimitadores de = (iguales) y ; (punto y coma), por ejemplo, "checked=true;disabled=false". La \ (barra diagonal inversa) se usa como carácter de escape cuando estos caracteres delimitador o \ aparecen en los valores. Por motivos de seguridad y otros motivos, la implementación del proveedor de esta propiedad puede tomar medidas para validar las propiedades originales de ARIA; sin embargo, no es necesario.
Tipo de variante: VT_BSTR
Valor predeterminado: cadena vacía.
UIA_AriaRolePropertyId
30101
Identifica la propiedad AriaRole , que es una cadena que contiene la información del rol Aplicación de Internet enriquecida accesible (ARIA) para el elemento de automatización. Para obtener más información sobre cómo asignar roles de ARIA a los tipos de control de automatización de la interfaz de usuario, consulte Ui Automation for W3C Accessible Rich Internet Applications Specification.

Nota:
Como opción, el agente de usuario también puede ofrecer una descripción localizada del rol ARIA de W3C en la propiedad LocalizedControlType . Cuando no se especifica la cadena localizada, el sistema proporcionará la cadena LocalizedControlType predeterminada para el elemento.



Tipo de variante: VT_BSTR
Valor predeterminado: cadena vacía.

UIA_AutomationIdPropertyId
30011
Identifica la propiedad AutomationId , que es una cadena que contiene el identificador (ID) de automatización de la interfaz de usuario para el elemento de automatización.
Cuando está disponible, automationId de un elemento debe ser el mismo en cualquier instancia de la aplicación, independientemente del idioma local. El valor debe ser único entre los elementos del mismo nivel, pero no necesariamente únicos en todo el escritorio. Por ejemplo, varias instancias de una aplicación o varias vistas de carpeta en el Explorador de Microsoft Windows pueden contener elementos con la misma propiedad AutomationId , como "SystemMenuBar".
Aunque la compatibilidad con AutomationId siempre se recomienda para mejorar la compatibilidad con las pruebas automatizadas, esta propiedad no es obligatoria. Cuando se admite, AutomationId es útil para crear un script de automatización de pruebas que se ejecute independientemente del lenguaje de la interfaz de usuario. Los clientes no deben realizar suposiciones con respecto a los valores automationId expuestos por otras aplicaciones. AutomationId no se garantiza que sea estable en distintas versiones o compilaciones de una aplicación.
Tipo de variante: VT_BSTR
Valor predeterminado: cadena vacía.
UIA_BoundingRectanglePropertyId
30001
Identifica la propiedad BoundingRectangle , que especifica las coordenadas del rectángulo que incluye completamente el elemento de automatización. El rectángulo se expresa en coordenadas de pantalla físicas. Puede contener puntos que no se pueden hacer clic si la forma o la región en la que se puede hacer clic del elemento de interfaz de usuario es irregular o si el elemento está oculto por otros elementos de la interfaz de usuario.
Tipo de variante: VT_R8 VT_ARRAY |
Valor predeterminado: [0,0,0,0]

Nota:
Esta propiedad es NULL si el elemento no muestra actualmente una interfaz de usuario.



UIA_CenterPointPropertyId
30165
Identifica la propiedad CenterPoint , que especifica las coordenadas de punto X e Y central del elemento de automatización. El espacio de coordenadas es lo que el proveedor considera lógicamente una página.
Tipo de variante: VT_R8 VT_ARRAY |
Valor predeterminado: VT_EMPTY
UIA_ClassNamePropertyId
30012
Identifica la propiedad ClassName , que es una cadena que contiene el nombre de clase para el elemento de automatización asignado por el desarrollador del control.
El nombre de clase depende de la implementación del proveedor de automatización de la interfaz de usuario y, por lo tanto, no siempre está en un formato estándar. Sin embargo, si se conoce el nombre de clase, se puede usar para comprobar que una aplicación funciona con el elemento de automatización esperado.
Tipo de variante: VT_BSTR
Valor predeterminado: cadena vacía.
UIA_ClickablePointPropertyId
30014
Identifica la propiedad ClickablePoint , que es un punto del elemento de automatización en el que se puede hacer clic. No se puede hacer clic en un elemento si está completamente o parcialmente oculto por otra ventana.
Tipo de variante: VT_R8 VT_ARRAY |
Valor predeterminado: VT_EMPTY
UIA_ControllerForPropertyId
30104
Identifica la propiedad ControllerFor , que es una matriz de elementos de automatización que manipula el elemento de automatización que admite esta propiedad.
ControllerFor se usa cuando un elemento de automatización afecta a uno o varios segmentos de la interfaz de usuario de la aplicación o el escritorio; de lo contrario, es difícil asociar el impacto de la operación de control con los elementos de la interfaz de usuario.
Este identificador se usa normalmente para la accesibilidad de sugerencias automáticas.
Tipo de variante para proveedores: VT_UNKNOWN | VT_ARRAY
Tipo de variante para clientes: VT_UNKNOWN (IUIAutomationElementArray )
Valor predeterminado: matriz vacía
UIA_ControlTypePropertyId
30003
Identifica la propiedad ControlType , que es una clase que identifica el tipo del elemento de automatización. ControlType define las características de los elementos de la interfaz de usuario por primitivos de control de interfaz de usuario conocidos, como botón o casilla.
Tipo de variante: VT_I4
Valor predeterminado: UIA_CustomControlTypeId

Nota:
Use el valor predeterminado solo si el elemento de automatización representa un tipo de control completamente nuevo.



UIA_CulturePropertyId
30015
Identifica la propiedad Culture, que contiene un identificador de configuración regional para el elemento de automatización (por ejemplo, 0x0409 para "en-US" o inglés (Estados Unidos)).
Cada configuración regional tiene un identificador único, un valor de 32 bits que consta de un identificador de idioma y un identificador de criterio de ordenación. El identificador de configuración regional es una abreviatura numérica internacional estándar y tiene los componentes necesarios para identificar de forma única una de las configuraciones regionales definidas por el sistema operativo instaladas. Para obtener más información, vea Constantes y cadenas de identificador de idioma.
Esta propiedad puede existir por control, pero normalmente solo está disponible en un nivel de aplicación.
Tipo de variante: VT_I4
Valor predeterminado: 0
UIA_DescribedByPropertyId
30105
Identifica la propiedad DescribedBy , que es una matriz de elementos que proporcionan más información sobre el elemento de automatización.
Se describeBy se usa cuando otro segmento de la interfaz de usuario de la aplicación explica un elemento de automatización. Por ejemplo, la propiedad puede apuntar a un elemento de texto de "2529 elementos en 85 grupos, 10 elementos seleccionados" de un objeto de lista personalizado complejo. En lugar de usar el modelo de objetos para que los clientes resumen información similar, la propiedad DescribedBy puede ofrecer acceso rápido al elemento de la interfaz de usuario que puede ofrecer información útil del usuario final que describe el elemento de la interfaz de usuario.
Tipo de variante para proveedores: VT_UNKNOWN | VT_ARRAY
Tipo de variante para clientes: VT_UNKNOWN (IUIAutomationElementArray)
Valor predeterminado: matriz vacía
UIA_FillColorPropertyId
30160
Identifica la propiedad FillColor , que especifica el color utilizado para rellenar el elemento de automatización. Este atributo se especifica como COLORREF, un valor de 32 bits que se usa para especificar un color RGB o RGBA.
Tipo de variante: VT_I4
Valor predeterminado: 0
UIA_FillTypePropertyId
30162
Identifica la propiedad FillType , que especifica el patrón utilizado para rellenar el elemento de automatización, como ninguno, color, degradado, imagen, patrón, etc.
Tipo de variante: VT_I4
Valor predeterminado: 0
UIA_FlowsFromPropertyId
30148
Identifica la propiedad FlowsFrom , que es una matriz de elementos de automatización que sugiere el orden de lectura antes del elemento de automatización actual. Se admite a partir de Windows 8.
La propiedad FlowsFrom especifica el orden de lectura cuando los elementos de automatización no se exponen ni estructuran en el mismo orden de lectura que percibe el usuario. Aunque la propiedad FlowsFrom puede especificar varios elementos anteriores, normalmente solo contiene el elemento anterior en el orden de lectura.
Tipo de variante para proveedores: VT_UNKNOWN | VT_ARRAY
Tipo de variante para clientes: VT_UNKNOWN (IUIAutomationElementArray)
Valor predeterminado: matriz vacía
UIA_FlowsToPropertyId
30106
Identifica la propiedad FlowsTo , que es una matriz de elementos de automatización que sugiere el orden de lectura después del elemento de automatización actual.
La propiedad FlowsTo especifica el orden de lectura cuando los elementos de automatización no se exponen ni estructuran en el mismo orden de lectura que percibe el usuario. Aunque la propiedad FlowsTo puede especificar varios elementos correctos, normalmente solo contiene el siguiente elemento en el orden de lectura.
Tipo de variante para proveedores: VT_UNKNOWN | VT_ARRAY
Tipo de variante para clientes: VT_UNKNOWN (IUIAutomationElementArray)
Valor predeterminado: matriz vacía
UIA_FrameworkIdPropertyId
30024
Identifica la propiedad FrameworkId , que es una cadena que contiene el nombre del marco de interfaz de usuario subyacente al que pertenece el elemento de automatización.
FrameworkId permite que las aplicaciones cliente procesen elementos de automatización de forma diferente en función del marco de interfaz de usuario concreto. Algunos ejemplos de valores de propiedad son "Win32", "WinForm" y "DirectUI".
Tipo de variante: VT_BSTR
Valor predeterminado: cadena vacía.
UIA_FullDescriptionPropertyId
30159
La propiedad FullDescription expone una cadena localizada que puede contener texto de descripción extendido para un elemento. FullDescription puede contener una descripción más completa de un elemento que puede ser adecuado para el elemento Name.
Tipo de variante: VT_BSTR
Valor predeterminado: cadena vacía.
UIA_HasKeyboardFocusPropertyId
30008
Identifica la propiedad HasKeyboardFocus , que es un valor booleano que indica si el elemento de automatización tiene el foco del teclado.
Tipo de variante: VT_BOOL
Valor predeterminado: FALSE
UIA_HeadingLevelPropertyId
30173
Identifica la propiedad HeadingLevel , que indica el nivel de encabezado de un elemento de Automatización de la interfaz de usuario.
Tipo de variante: VT_I4
Valor predeterminado: HeadingLevel_None
UIA_HelpTextPropertyId
30013
Identifica la propiedad HelpText , que es una cadena de texto de ayuda asociada al elemento de automatización.
La propiedad HelpText se puede admitir con el texto de marcador de posición que aparece en los controles de edición o lista. Por ejemplo, "Escribir texto aquí para la búsqueda" es un buen candidato a la propiedad HelpText para un control de edición que coloca el texto antes de la entrada real del usuario. Sin embargo, no es adecuado para la propiedad name del control de edición.
Cuando se admite HelpText , la cadena debe coincidir con el idioma de la interfaz de usuario de la aplicación o el idioma predeterminado de la interfaz de usuario del sistema operativo.
Tipo de variante: VT_BSTR
Valor predeterminado: cadena vacía.
UIA_IsContentElementPropertyId
30017
Identifica la propiedad IsContentElement , que es un valor booleano que especifica si el elemento aparece en la vista de contenido del árbol de elementos de automatización. Para obtener más información, consulte Ui Automation Tree Overview.

Nota:
Para que un elemento aparezca en la vista de contenido, la propiedad IsContentElement y la propiedad IsControlElement deben ser TRUE.



Tipo de variante: VT_BOOL
Valor predeterminado: TRUE

UIA_IsControlElementPropertyId
30016
Identifica la propiedad IsControlElement , que es un valor booleano que especifica si el elemento aparece en la vista de control del árbol de elementos de automatización. Para obtener más información, consulte Ui Automation Tree Overview.
Tipo de variante: VT_BOOL
Valor predeterminado: TRUE
UIA_IsDataValidForFormPropertyId
30103
Identifica la propiedad IsDataValidForForm , que es un valor booleano que indica si el valor especificado o seleccionado es válido para la regla de formulario asociada al elemento de automatización. Por ejemplo, si el usuario escribió "425-555-5555" para un campo de código postal que requiere 5 o 9 dígitos, la propiedad IsDataValidForForm se puede establecer en FALSE para indicar que los datos no son válidos.
Tipo de variante: VT_BOOL
Valor predeterminado: FALSE
UIA_IsDialogPropertyId
30174
Identifica la propiedad IsDialog , que es un valor booleano que indica si el elemento de automatización es una ventana de diálogo. Por ejemplo, la tecnología de asistencia, como los lectores de pantalla, normalmente hablan el título del cuadro de diálogo, el control centrado en el diálogo y, a continuación, el contenido del diálogo hasta el control centrado ("¿Desea guardar los cambios antes de cerrarlo"). En el caso de las ventanas estándar, un lector de pantalla suele hablar el título de la ventana seguido del control centrado. La propiedad IsDialog se puede establecer en TRUE para indicar que la aplicación cliente debe tratar el elemento como una ventana de diálogo.
Tipo de variante: VT_BOOL
Valor predeterminado: FALSE
UIA_IsEnabledPropertyId
30010
Identifica la propiedad IsEnabled , que es un valor booleano que indica si el elemento de interfaz de usuario al que hace referencia el elemento de automatización está habilitado y se puede interactuar con él.
Cuando el estado habilitado de un control es FALSE, se supone que los controles secundarios tampoco están habilitados. Los clientes no deben esperar eventos modificados por propiedades de los elementos secundarios cuando cambia el estado del control primario.
Tipo de variante: VT_BOOL
Valor predeterminado: FALSE
UIA_IsKeyboardFocusablePropertyId
30009
Identifica la propiedad IsKeyboardFocusable , que es un valor booleano que indica si el elemento de automatización puede aceptar el foco del teclado.
Tipo de variante: VT_BOOL
Valor predeterminado: FALSE
UIA_IsOffscreenPropertyId
30022
Identifica la propiedad IsOffscreen , que es un valor booleano que indica si el elemento de automatización se desplaza completamente fuera de la vista (por ejemplo, un elemento de un cuadro de lista que está fuera de la ventanilla del objeto contenedor) o se contrae fuera de la vista (por ejemplo, un elemento en una vista de árbol o menú, o en una ventana minimizada). Si el elemento tiene un punto en el que se puede hacer clic que puede provocar que reciba el foco, se considera que el elemento está en pantalla mientras una parte del elemento está fuera de pantalla.
El valor de la propiedad no se ve afectado por la oclusión de otras ventanas o por si el elemento está visible en un monitor específico.
Si la propiedad IsOffscreen es TRUE, el elemento de la interfaz de usuario se desplaza fuera de la pantalla o se contrae. El elemento está temporalmente oculto, pero permanece en la percepción del usuario final y continúa incluyendo en el modelo de interfaz de usuario. El objeto se puede volver a ver desplazando, haciendo clic en una lista desplegable, etc.
Los objetos que el usuario final no percibe en absoluto o que están "ocultos mediante programación" (por ejemplo, un cuadro de diálogo que se ha descartado, pero la aplicación sigue almacenando en caché el objeto subyacente) no debe estar en el árbol de elementos de automatización en primer lugar (en lugar de establecer el estado de IsOffscreen en TRUE).
Tipo de variante: VT_BOOL
Valor predeterminado: FALSE
UIA_IsPasswordPropertyId
30019
Identifica la propiedad IsPassword , que es un valor booleano que indica si el elemento de automatización contiene contenido protegido o una contraseña.
Cuando la propiedad IsPassword es TRUE y el elemento tiene el foco del teclado, una aplicación cliente debe deshabilitar la eco del teclado o los comentarios de entrada del teclado que pueden exponer la información protegida del usuario. Si se intenta obtener acceso a la propiedad Value del elemento protegido (control de edición) se puede producir un error.
Tipo de variante: VT_BOOL
Valor predeterminado: FALSE
UIA_IsPeripheralPropertyId
30150
Identifica la propiedad IsPeripheral , que es un valor booleano que indica si el elemento de automatización representa la interfaz de usuario periférica. Aparece la interfaz de usuario de periféricos y admite la interacción del usuario, pero no toma el foco del teclado cuando aparece. Algunos ejemplos de interfaz de usuario periférica incluyen elementos emergentes, controles flotantes, menús contextuales o notificaciones flotantes. Se admite a partir de Windows 8.1.
Cuando la propiedad IsPeripheral es TRUE, una aplicación cliente no puede suponer que el elemento tomó el foco incluso si actualmente es interactivo con el teclado.
Esta propiedad es relevante para estos tipos de control:
  • UIA_GroupControlTypeId
  • UIA_MenuControlTypeId
  • UIA_PaneControlTypeId
  • UIA_ToolBarControlTypeId
  • UIA_ToolTipControlTypeId
  • UIA_WindowControlTypeId
  • UIA_CustomControlTypeId
Tipo de variante: VT_BOOL
Valor predeterminado: FALSE
UIA_IsRequiredForFormPropertyId
30025
Identifica la propiedad IsRequiredForForm , que es un valor booleano que indica si es necesario rellenar el elemento de automatización en un formulario.
Tipo de variante: VT_BOOL
Valor predeterminado: FALSE
UIA_ItemStatusPropertyId
30026
Identifica la propiedad ItemStatus , que es una cadena de texto que describe el estado de un elemento de automatización.
ItemStatus permite a un cliente determinar si un elemento transmite el estado de un elemento, así como cuál es el estado. Por ejemplo, un elemento asociado a un contacto en una aplicación de mensajería podría ser "Ocupado" o "Conectado".
Cuando se admite ItemStatus , la cadena debe coincidir con el idioma de la interfaz de usuario de la aplicación o el idioma predeterminado de la interfaz de usuario del sistema operativo.
Tipo de variante: VT_BSTR
Valor predeterminado: cadena vacía.
UIA_ItemTypePropertyId
300021
Identifica la propiedad ItemType , que es una cadena de texto que describe el tipo del elemento de automatización.
ItemType se usa para obtener información sobre los elementos de una lista, vista de árbol o cuadrícula de datos. Por ejemplo, un elemento de una vista de directorio de archivos podría ser "Archivo de documento" o "Carpeta".
Cuando se admite ItemType , la cadena debe coincidir con el idioma de la interfaz de usuario de la aplicación o el idioma predeterminado de la interfaz de usuario del sistema operativo.
Tipo de variante: VT_BSTR
Valor predeterminado: cadena vacía.
UIA_LabeledByPropertyId
30018
Identifica la propiedad LabeledBy , que es un elemento de automatización que contiene la etiqueta de texto de este elemento.
Esta propiedad se puede usar para recuperar, por ejemplo, la etiqueta de texto estático de un cuadro combinado.
Tipo de variante: VT_UNKNOWN
Valor predeterminado: NULL
UIA_LandmarkTypePropertyId
30157
Identifica la propiedad LandmarkType , que es un identificador de tipo de punto de referencia asociado a un elemento .
La propiedad LandmarkType describe un elemento que representa un grupo de elementos. Por ejemplo, un punto de referencia de búsqueda podría representar un conjunto de controles relacionados para la búsqueda.
Si se usa UIA_CustomLandmarkTypeId , se requiere UIA_LocalizedLandmarkTypePropertyId para describir el punto de referencia personalizado.
Tipo de variante: VT_I4
Valor predeterminado: 0
UIA_LevelPropertyId
30154
Identifica la propiedad Level , que es un entero basado en 1 asociado a un elemento de automatización.
La propiedad Level describe la ubicación de un elemento dentro de una estructura jerárquica o jerárquica rota. Por ejemplo, una lista numerada o con viñetas, encabezados u otros elementos de datos estructurados puede tener varias relaciones primarias o secundarias. Nivel describe dónde se encuentra el elemento en la estructura.
Se recomienda usar el patrón de control CustomNavigation junto con Level.
Tipo de variante: VT_I4
Valor predeterminado: 0
UIA_LiveSettingPropertyId
30135
Identifica la propiedad LiveSetting , que es compatible con un elemento de automatización que representa una región activa. La propiedad LiveSetting indica el nivel de "cortesía" que un cliente debe usar para notificar al usuario los cambios en la región activa. Esta propiedad puede ser uno de los valores de la enumeración LiveSetting . Se admite a partir de Windows 8.
Tipo de variante: VT_I4
Valor predeterminado: 0
UIA_LocalizedControlTypePropertyId
30004
Identifica la propiedad LocalizedControlType , que es una cadena de texto que describe el tipo de control que representa el elemento de automatización. La cadena solo debe contener caracteres en minúsculas:
  • Correcto: "botón"
  • Incorrecto: "Button"

Cuando el proveedor de elementos no especifica LocalizedControlType , el marco proporciona la cadena localizada predeterminada, según el tipo de control del elemento (por ejemplo, "button" para el tipo de control Button ). Un elemento de automatización con el tipo de control Personalizado debe admitir una cadena de tipo de control localizada que represente el rol del elemento (por ejemplo, "selector de colores" para un control personalizado que permita a los usuarios elegir y especificar colores).
Cuando se proporciona un valor personalizado, la cadena debe coincidir con el idioma de la interfaz de usuario de la aplicación o el idioma predeterminado de la interfaz de usuario del sistema operativo.
Tipo de variante: VT_BSTR
Valor predeterminado: cadena vacía.
UIA_LocalizedLandmarkTypePropertyId
30158
Identifica localizedLandmarkType, que es una cadena de texto que describe el tipo de punto de referencia que representa el elemento de automatización.
Sin embargo, debe usarse junto con UIA_CustomLandmarkTypeId , LocalizedLandmarkType siempre debe tener prioridad sobre LandmarkType y usarse para describir el punto de referencia antes de LandmarkType.
La cadena debe coincidir con el idioma de la interfaz de usuario de la aplicación o el idioma predeterminado de la interfaz de usuario del sistema operativo.
Tipo de variante: VT_BSTR
Valor predeterminado: cadena vacía.
UIA_NamePropertyId
30005
Identifica la propiedad Name , que es una cadena que contiene el nombre del elemento de automatización.
La propiedad Name debe ser la misma que el texto de la etiqueta en pantalla. Por ejemplo, Name debe ser "Examinar" para un elemento de botón con la etiqueta "Examinar". La propiedad Name no debe incluir el carácter mnemónico para las teclas de acceso (es decir, "&"), que se subraya en la presentación de texto de la interfaz de usuario. Además, la propiedad Name no debe ser una versión extendida o modificada de la etiqueta en pantalla porque la incoherencia entre el nombre y la etiqueta puede causar confusión entre las aplicaciones cliente y los usuarios.
Cuando el texto de la etiqueta correspondiente no está visible en la pantalla o cuando se reemplaza por gráficos, se debe elegir texto alternativo. El texto alternativo debe ser conciso, intuitivo y localizado en el idioma de la interfaz de usuario de la aplicación o en el idioma predeterminado de la interfaz de usuario del sistema operativo. El texto alternativo no debe ser una descripción detallada de los detalles visuales, sino una descripción concisa de la función o característica de la interfaz de usuario como si estuviera etiquetada por texto simple. Por ejemplo, el botón de menú Inicio de Windows se denomina "Inicio" (botón) en lugar de "Logotipo de Windows en gráficos de esfera redonda azul" (botón). Para obtener más información, vea Crear equivalentes de texto para imágenes.
Cuando una etiqueta de interfaz de usuario usa gráficos de texto (por ejemplo, mediante ">>" para un botón que agrega un elemento de izquierda a derecha), la propiedad Name debe invalidarse mediante una alternativa de texto adecuada (por ejemplo, "Agregar"). Sin embargo, se desaconseja la práctica de usar gráficos de texto como etiqueta de interfaz de usuario debido a problemas de localización y accesibilidad.
La propiedad Name no debe incluir la información de tipo o rol de control, como "button" o "list"; de lo contrario, entrará en conflicto con el texto de la propiedad LocalizedControlType cuando estas dos propiedades se anexan (muchas tecnologías de asistencia existentes lo hacen).
La propiedad Name no se puede usar como identificador único entre los elementos del mismo nivel. Sin embargo, siempre que sea coherente con la presentación de la interfaz de usuario, se puede admitir el mismo valor name entre pares. Para la automatización de pruebas, los clientes deben considerar el uso de la propiedad AutomationId o RuntimeId .
Los controles de texto no siempre tienen que hacer que la propiedad Name sea idéntica al texto que se muestra en el control, siempre y cuando también se admita el patrón Text .
Tipo de variante: VT_BSTR
Valor predeterminado: cadena vacía.
UIA_NativeWindowHandlePropertyId
30020
Identifica la propiedad NativeWindowHandle , que es un entero que representa el identificador (HWND) de la ventana del elemento de automatización, si existe; de lo contrario, esta propiedad es 0.
Tipo de variante: VT_I4
Valor predeterminado: 0
UIA_OptimizeForVisualContentPropertyId
30111
Identifica la propiedad OptimizeForVisualContent , que es un valor booleano que indica si el proveedor expone solo los elementos visibles. Un proveedor puede usar esta propiedad para optimizar el rendimiento cuando se trabaja con fragmentos de contenido muy grandes. Por ejemplo, como las páginas del usuario a través de una gran parte de contenido, el proveedor puede destruir elementos de contenido que ya no son visibles. Cuando se destruye un elemento de contenido, el proveedor debe devolver el código de error UIA_E_ELEMENTNOTAVAILABLE . Se admite a partir de Windows 8.
Tipo de variante: VT_BOOL
Valor predeterminado: FALSE
UIA_OrientationPropertyId
300023
Identifica la propiedad Orientation , que indica la orientación del control representado por el elemento de automatización. La propiedad se expresa como un valor del tipo enumerado OrientationType .
La propiedad Orientation es compatible con controles, como barras de desplazamiento y controles deslizantes, que pueden tener una orientación vertical o horizontal. De lo contrario, siempre puede ser OrientationType_None, lo que significa que el control no tiene orientación.
Tipo de variante: VT_I4
Valor predeterminado: 0 (OrientationType_None)
UIA_OutlineColorPropertyId
30161
Identifica la propiedad OutlineColor , que especifica el color utilizado para el contorno del elemento de automatización. Este atributo se especifica como COLORREF, un valor de 32 bits que se usa para especificar un color RGB o RGBA.
Tipo de variante: VT_I4 VT_ARRAY |
Valor predeterminado: 0
UIA_OutlineThicknessPropertyId
30164
Identifica la propiedad OutlineThickness , que especifica el ancho del contorno del elemento de automatización.
Tipo de variante: VT_R8 VT_ARRAY |
Valor predeterminado: VT_EMPTY
UIA_PositionInSetPropertyId
30152
Identifica la propiedad PositionInSet , que es un entero basado en 1 asociado a un elemento de automatización. PositionInSet describe la ubicación ordinal del elemento dentro de un conjunto de elementos que se consideran relacionados.
PositionInSet funciona en coordinación con la propiedad SizeOfSet para describir la ubicación ordinal del conjunto.
Tipo de variante: VT_I4
Valor predeterminado: 0
UIA_ProcessIdPropertyId
30002
Identifica la propiedad ProcessId , que es un entero que representa el identificador de proceso (ID) del elemento de automatización.
El sistema operativo asigna el identificador de proceso (ID). Se puede ver en la columna PID de la pestaña Procesos del Administrador de tareas.
Tipo de variante: VT_I4
Valor predeterminado: 0
UIA_ProviderDescriptionPropertyId
30107
Identifica la propiedad ProviderDescription , que es una cadena con formato que contiene la información de origen del proveedor de automatización de la interfaz de usuario para el elemento de automatización, incluida la información de proxy.
Tipo de variante: VT_BSTR
Valor predeterminado: cadena vacía.
UIA_RotationPropertyId
30166
Identifica la propiedad Rotation , que especifica el ángulo de rotación en unidades no especificadas.
Tipo de variante: VT_R8
Valor predeterminado: 0
UIA_RuntimeIdPropertyId
30000
Identifica la propiedad RuntimeId , que es una matriz de enteros que representa el identificador de un elemento de automatización.
El identificador es único en el escritorio, pero se garantiza que solo es único dentro de la interfaz de usuario del escritorio en el que se generó. Los identificadores se pueden reutilizar con el tiempo.
El formato de RuntimeId puede cambiar. El identificador devuelto debe tratarse como un valor opaco y solo se usa para la comparación; por ejemplo, para determinar si un elemento de automatización está en la memoria caché.
Tipo de variante: VT_I4 VT_ARRAY |
Valor predeterminado: VT_EMPTY
UIA_SizePropertyId
30167
Identifica la propiedad Size , que especifica el ancho y el alto del elemento de automatización.
Tipo de variante: VT_R8 VT_ARRAY |
Valor predeterminado: VT_EMPTY
UIA_SizeOfSetPropertyId
30153
Identifica la propiedad SizeOfSet , que es un entero basado en 1 asociado a un elemento de automatización. SizeOfSet describe el recuento de elementos de automatización de un grupo o conjunto que se consideran relacionados.
SizeOfSet funciona en coordinación con la propiedad PositionInSet para describir el recuento de elementos del conjunto.
Tipo de variante: VT_I4
Valor predeterminado: 0
UIA_VisualEffectsPropertyId
30163
Identifica la propiedad VisualEffects , que es un campo de bits que especifica efectos en el elemento de automatización, como sombra, reflexión, iluminado, bordes suaves o bisel.
VisualEffects:
  • VisualEffects_Shadow: 0x1
  • VisualEffects_Reflection: 0x2
  • VisualEffects_Glow: 0x4
  • VisualEffects_SoftEdges: 0x8
  • VisualEffects_Bevel: 0x10
Tipo de variante: VT_I4
Valor predeterminado: 0

Requisitos

Requisito Value
Cliente mínimo compatible
Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible
Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Encabezado
UIAutomationClient.h

Consulte también

Conceptual

Información general acerca de las propiedades de UI Automation

Recuperación de propiedades de elementos de automatización de la interfaz de usuario