AutomationPeer.GetName Método

Definição

Namespace:

Microsoft.UI.Xaml.Automation.Peers

Obtém o texto que descreve o elemento associado a esse par de automação. O valor nome do Automação da Interface do Usuário da Microsoft é o identificador principal usado pela tecnologia mais adaptativa quando eles representam a interface do usuário do aplicativo interagindo com a estrutura do Microsoft Automação da Interface do Usuário.

public:
 virtual Platform::String ^ GetName() = GetName;

winrt::hstring GetName();

public string GetName();

function getName()

Public Function GetName () As String

Retornos

String

Platform::String

winrt::hstring

O nome do elemento que é o proprietário do par, conforme usado pela tecnologia adaptativa e outros clientes do Microsoft Automação da Interface do Usuário.

Comentários

FrameworkElementAutomationPeer apresenta o comportamento para GetName fornecendo uma implementação intermediária de GetNameCore . Se um elemento tiver um valor para a propriedade Automação da Interface do Usuário Da Microsoft LabeledBy, o valor Name do elemento de rotulagem será usado como o Nome.

FrameworkElementAutomationPeer também introduz o comportamento por meio de um método GetPlainText interno que outras classes pares padrão podem substituir para acessar o modelo de conteúdo desse controle e retornar um padrão útil para Name. Por exemplo, qualquer classe derivada contentControl usará uma representação de cadeia de caracteres de seu valor Content como o Nome padrão. Isso está habilitado porque, internamente, o ContentControl implementa GetPlainText e transmite esse comportamento a todas as classes derivadas de ContentControl . É assim que você obtém um padrão de Nome útil do valor de cadeia de caracteres de um Botão, por exemplo.

Outros pares específicos também podem ter uma implementação intermediária de GetNameCore que fornece uma maneira útil para esse controle de Windows Runtime específico fornecer valores internos para Name. A origem desses valores vem de outras propriedades de interface do usuário que normalmente são definidas em XAML ou como código de usuário do aplicativo. Por exemplo, TextBoxAutomationPeer implementa o comportamento que usa o valor da propriedade Text do proprietário TextBox como o Nome padrão. Da perspectiva do código do usuário, o comportamento padrão pode ser substituído aplicando um valor de AutomationProperties.Name diferente. Da perspectiva do implementador/provedor de pares, o comportamento padrão do par pode ser alterado derivando uma nova classe par do par existente, substituindo GetNameCore e dando a ele uma nova implementação que não chamaria a implementação base em pelo menos alguns casos.

Para saber mais sobre o possível comportamento padrão de classes par específicas para controles de Windows Runtime padrão, consulte o tópico de referência dessa classe par específica e procure notas de implementação na seção Comentários.

Confira também

• Pares de automação personalizados