AutomationProperties.NameProperty Propriedade

Definição

Namespace:

Microsoft.UI.Xaml.Automation

Identifica o AutomationProperties.Name propriedade anexada, que é uma cadeia de caracteres que contém o nome do elemento de automação.

public:
 static property DependencyProperty ^ NameProperty { DependencyProperty ^ get(); };

static DependencyProperty NameProperty();

public static DependencyProperty NameProperty { get; }

var dependencyProperty = AutomationProperties.nameProperty;

Public Shared ReadOnly Property NameProperty As DependencyProperty

Valor da propriedade

DependencyProperty

O identificador da propriedade anexada AutomationProperties.Name .

Comentários

A propriedade Name 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 propriedade Name 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 propriedade Name 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 propriedade Name 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 propriedade Name não deve incluir a função de controle ou as informações de tipo, como "button" ou "list"; caso contrário, ele entrará em conflito com o texto da propriedade LocalizedControlType quando essas duas propriedades forem acrescentadas (muitas tecnologias adaptativas existentes fazem isso).

A propriedade Name 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 valor de Nome pode ser suportado entre 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 fazer com que a propriedade Name seja idêntica ao texto exibido dentro do controle, desde que o padrão Text também tenha suporte.