AutomationPeer.GetName Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene el texto que describe el elemento que está asociado a este mismo nivel de automatización. El valor nombre de automatización de la interfaz de usuario de Microsoft es el identificador principal que usa la mayoría de la tecnología de asistencia cuando representan la interfaz de usuario de la aplicación mediante la interacción con el marco de automatización de la interfaz de usuario de Microsoft.
public:
virtual Platform::String ^ GetName() = GetName;winrt::hstring GetName();public string GetName();function getName()Public Function GetName () As StringDevoluciones
Nombre del elemento que es el propietario del mismo nivel, tal como lo usa la tecnología de asistencia y otros clientes de Automatización de la interfaz de usuario de Microsoft.
Comentarios
FrameworkElementAutomationPeer presenta el comportamiento a GetName proporcionando una implementación intermedia de GetNameCore . Si un elemento tiene un valor para la propiedad LabeledByMicrosoft UI Automation, el valor name del elemento de etiquetado se usa como nombre.
FrameworkElementAutomationPeer también presenta el comportamiento a través de un método GetPlainText interno que otras clases del mismo nivel predeterminadas pueden invalidar para tener acceso al modelo de contenido de ese control y devolver un valor predeterminado útil para Name. Por ejemplo, cualquier clase derivada de ContentControl usará una representación de cadena de su valor Content como nombre predeterminado. Esto se habilita porque ContentControl implementa Internamente GetPlainText e imparte ese comportamiento a todas las clases derivadas de ContentControl . Así es como se obtiene un valor predeterminado de Name útil del valor de cadena de un Button, por ejemplo.
Otros elementos del mismo nivel específicos también pueden tener una implementación intermedia de GetNameCore que proporciona una manera útil de que ese control de Windows Runtime concreto proporcione valores integrados para Name. El origen de estos valores procede de otras propiedades de la interfaz de usuario que normalmente se establecen en XAML o como código de usuario de la aplicación. Por ejemplo, TextBoxAutomationPeer implementa el comportamiento que usa el valor de la propiedad Text del propietario TextBox como nombre predeterminado. Desde la perspectiva del código de usuario, el comportamiento predeterminado se puede invalidar aplicando un valor de AutomationProperties.Name diferente. Desde la perspectiva del implementador o proveedor del mismo nivel, el comportamiento predeterminado del mismo nivel se puede cambiar derivando una nueva clase del mismo nivel del mismo nivel existente, reemplazando GetNameCore y dándole una nueva implementación que no llamaría a la implementación base en al menos algunos casos.
Para obtener más información sobre el posible comportamiento predeterminado de clases específicas del mismo nivel para los controles de Windows Runtime predeterminados, consulte el tema de referencia de esa clase del mismo nivel en particular y busque notas de implementación en la sección Comentarios.