AutomationPeer.GetNameCore Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
protected:
virtual Platform::String ^ GetNameCore() = GetNameCore;winrt::hstring GetNameCore();protected virtual string GetNameCore();function getNameCore()Protected Overridable Function GetNameCore () As StringRetornos
O nome 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.