AutomationProperties.NameProperty Propiedad

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Automation

Identifica la propiedad adjunta AutomationProperties.Name , que es una cadena que contiene el nombre del elemento de automatización.

public:
 static property DependencyProperty ^ NameProperty { DependencyProperty ^ get(); };

static DependencyProperty NameProperty();

public static DependencyProperty NameProperty { get; }

var dependencyProperty = AutomationProperties.nameProperty;

Public Shared ReadOnly Property NameProperty As DependencyProperty

Valor de propiedad

DependencyProperty

Identificador de la propiedad adjunta AutomationProperties.Name .

Comentarios

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, con ">>" para un botón que agrega un elemento de izquierda a derecha), la propiedad Name se debe invalidar 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 .