AutomationProperties.Name Propiedad adjunta

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Automation

Obtiene o establece el nombre Automatización de la interfaz de usuario del elemento.

see GetName, and SetName

see GetName, and SetName

see GetName, and SetName

Comentarios

La Name propiedad 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 Name propiedad 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 Name propiedad 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, con ">>" para un botón que agrega un elemento de izquierda a derecha), la Name propiedad 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 Name propiedad 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 se anexan estas dos propiedades (muchas tecnologías de asistencia existentes lo hacen).

La Name propiedad 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 Name valor 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 Name propiedad sea idéntica al texto que se muestra dentro del control, siempre y cuando también se admita el patrón Text .

De las distintas propiedades adjuntas, probablemente la más importante es Name. Esto se debe a que es la propiedad a la Name que se accede con más frecuencia y se notifica mediante la tecnología de asistencia cuando los usuarios interactúan con una aplicación en un escenario de accesibilidad. Name actúa como identificador legible para el elemento de interfaz de usuario.

Varios elementos de la interfaz de usuario tienen reenvío del mismo nivel que puede proporcionar un valor predeterminado Name basado en otras propiedades de elemento. Por ejemplo, el reenvío del mismo nivel para la clase Button reenviará la ToString evaluación del contenido de Button y usará esta cadena como valor predeterminado Name. Para invalidar ese valor predeterminado, o para proporcionar un Name valor para cualquier caso de elemento de interfaz de usuario en el que no haya ningún Automatización de la interfaz de usuario de Microsoft Name disponible, establezca la Name propiedad adjunta en ese elemento en XAML. Para obtener más información sobre por qué un Automatización de la interfaz de usuario Name de Microsoft es importante, consulte Información de accesibilidad básica. Para obtener más información sobre cómo probar si un elemento ya tiene un elemento proporcionado Name por el mismo nivel que es útil, consulte Pruebas de accesibilidad.

Por motivos de localización, debes evitar los valores de cadena codificados de forma rígida para en Name XAML. Si establece la directiva x:Uid en el elemento, puede usar recursos RESW para dirigirse a la propiedad y proporcionar valores diferentes para la localización. Para las propiedades adjuntas, el formulario de identificador de recursos requiere una calificación completa de la propiedad adjunta en formato XAML, incluido su espacio de nombres y un valor using: prefijo. Por ejemplo, para establecer como destino el valor de la AutomationProperties.Name propiedad adjunta en un recurso que tiene el valor de directiva x:Uid de "sendButton", el Name valor del elemento de datos de los recursos RESW es sendButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name

• Type: cadena
• Campo identificador: NameProperty
• Métodos de descriptor de acceso: GetName, SetName

Consulte también

• Propiedades adjuntas xaml