Partilhar via


AutomationPeer.GetName Método

Definição

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

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 da Automação da Interface do Usuário da Microsoft.

Comentários

FrameworkElementAutomationPeer apresenta o comportamento para GetName fornecendo uma implementação intermediária do GetNameCore . Se um elemento tiver um valor para a propriedade LabeledByMicrosoft UI Automation, 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 par 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 de 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 da cadeia de caracteres de um Botão, por exemplo.

Outros pares específicos também podem ter uma implementação intermediária do 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 da 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. Do ponto de vista do código do usuário, o comportamento padrão pode ser substituído aplicando um valor de AutomationProperties.Name diferente. Na perspectiva do implementador/provedor de pares, o comportamento padrão do par pode ser alterado derivando uma nova classe de par do par existente, substituindo GetNameCore e dando-lhe 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.

Aplica-se a

Confira também