Compartir a través de


AutomationProperties.Name Propiedad adjunta

Definición

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 del 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 Creating Text Equivalents for Images( 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 Name propiedad debe invalidarse mediante una alternativa de texto adecuada (por ejemplo, "Agregar"). Sin embargo, no se recomienda 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 y cuando sea coherente con la presentación de la interfaz de usuario, se puede admitir el mismo valor entre elementos del mismo Name nivel. 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 notifica 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 la 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 del botón y usará esta cadena como valor predeterminado Name. Para invalidar ese valor predeterminado, o para proporcionar de otro modo 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 Name de Microsoft disponible, establezca la Name propiedad adjunta en ese elemento en XAML. Para obtener más información sobre por qué es importante un Automatización de la interfaz de usuario Name de Microsoft, consulta Información de accesibilidad básica. Para obtener más información sobre cómo probar si un elemento ya tiene un elemento proporcionado por Name el mismo nivel que es útil, consulta Pruebas de accesibilidad.

Por motivos de localización, debes evitar 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 establecer como destino la propiedad y proporcionar valores diferentes para la localización. En el caso de 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 tener como destino el valor de propiedad AutomationProperties.Name adjunta en un recurso que tiene el valor de directiva x:Uid de "sendButton", el Name valor del elemento de datos en los recursos de RESW es . sendButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name

Se aplica a

Consulte también