AutomationProperties.Name Propriedade anexada
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.
Obtém ou define o nome Automação da Interface do Usuário do elemento.
see GetName, and SetNamesee GetName, and SetNamesee GetName, and SetNameComentários
A Name propriedade deve ser igual ao texto do rótulo na tela. Por exemplo, Name deve ser "Procurar" para um elemento de botão com o rótulo "Procurar". A Name propriedade não deve incluir o caractere mnemônico para as chaves de acesso (ou seja, "&"), que é sublinhado na apresentação de texto da interface do usuário. Além disso, a Name propriedade não deve ser uma versão estendida ou modificada do rótulo na tela porque a inconsistência entre o nome e o rótulo pode causar confusão entre aplicativos cliente e usuários.
Quando o texto do rótulo correspondente não estiver visível na tela ou quando for substituído por elementos gráficos, o texto alternativo deverá ser escolhido. O texto alternativo deve ser conciso, intuitivo e localizado para o idioma da interface do usuário do aplicativo ou para a linguagem de interface do usuário padrão do sistema operacional. O texto alternativo não deve ser uma descrição detalhada dos detalhes visuais, mas uma descrição concisa da função ou recurso da interface do usuário como se tivesse sido rotulado por texto simples. Por exemplo, o botão de menu Iniciar do Windows é chamado de "Iniciar" (botão) em vez de "Logotipo do Windows em elementos gráficos de esfera redonda azul" (botão). Para obter mais informações, consulte Criando equivalentes de texto para imagens.
Quando um rótulo de interface do usuário usa gráficos de texto (por exemplo, usando ">>" para um botão que adiciona um item da esquerda para a direita), a Name propriedade deve ser substituída por uma alternativa de texto apropriada (por exemplo, "Adicionar"). No entanto, a prática de usar elementos gráficos de texto como um rótulo de interface do usuário é desencorajada devido a preocupações de localização e acessibilidade.
A Name propriedade não deve incluir a função de controle ou as informações de tipo, como "button" ou "list"; caso contrário, entrará em conflito com o texto da propriedade LocalizedControlType quando essas duas propriedades forem acrescentadas (muitas tecnologias adaptativas existentes fazem isso).
A Name propriedade não pode ser usada como um identificador exclusivo entre irmãos. No entanto, desde que seja consistente com a apresentação da interface do usuário, o mesmo Name valor pode ser suportado entre os pares. Para a automação de teste, os clientes devem considerar o uso da propriedade AutomationId ou RuntimeId .
Os controles de texto nem sempre precisam que a Name propriedade seja idêntica ao texto exibido dentro do controle, desde que o padrão Text também tenha suporte.
Das várias propriedades anexadas, provavelmente a mais importante é Name. Isso ocorre porque é a Name propriedade mais acessada e relatada pela tecnologia adaptativa quando os usuários interagem com um aplicativo em um cenário de acessibilidade. O Name serve como o identificador legível por humanos para o elemento de interface do usuário.
Vários elementos de interface do usuário têm encaminhamento de pares que podem fornecer um valor padrão Name com base em outras propriedades de elemento. Por exemplo, o encaminhamento de pares para a classe Button encaminhará a ToString avaliação do conteúdo do Botão e usará essa cadeia de caracteres como o padrão Name. Para substituir esse padrão ou fornecer um Name valor para qualquer caso de elemento de interface do usuário em que não haja nenhum microsoft Automação da Interface do Usuário Name disponível, defina a Name propriedade anexada nesse elemento em XAML. Para obter mais informações sobre por que um microsoft Automação da Interface do Usuário Name é importante, consulte Informações básicas de acessibilidade. Para obter mais informações sobre como testar se um elemento já tem um fornecido por Name pares que seja útil, consulte Teste de acessibilidade.
Por motivos de localização, você deve evitar valores de cadeia de caracteres embutidos em código para o Name em XAML. Se você definir a diretiva x:Uid no elemento , poderá usar recursos RESW para direcionar a propriedade e fornecer valores diferentes para localização. Para propriedades anexadas, o formulário do identificador de recurso requer qualificação completa da propriedade anexada no formato XAML, incluindo seu namespace e um prefixo using: . Por exemplo, para direcionar o valor da AutomationProperties.Name propriedade anexada em um recurso que tem o valor da diretiva x:Uid de "sendButton", o Name valor do item de dados nos recursos RESW é sendButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name
- Type: string
- Campo Identificador: NameProperty
- Métodos do acessador: GetName, SetName