AutomationElement.AutomationIdProperty Campo
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.
Identifica a AutomationId propriedade, que é usada para identificar elementos.
public: static initonly System::Windows::Automation::AutomationProperty ^ AutomationIdProperty;public static readonly System.Windows.Automation.AutomationProperty AutomationIdProperty; staticval mutable AutomationIdProperty : System.Windows.Automation.AutomationPropertyPublic Shared ReadOnly AutomationIdProperty As AutomationProperty Valor do campo
Exemplos
O exemplo a seguir recupera o valor atual da propriedade. O valor padrão será retornado se o elemento não fornecer um.
string autoId =
autoElement.GetCurrentPropertyValue(AutomationElement.AutomationIdProperty) as string;
Dim autoId As String = _
CStr(autoElement.GetCurrentPropertyValue(AutomationElement.AutomationIdProperty))
O exemplo a seguir recupera o valor atual da propriedade, mas especifica que, se o elemento em si não fornecer um valor para a propriedade, NotSupported será retornado em vez de um valor padrão.
string autoIdString;
object autoIdNoDefault =
autoElement.GetCurrentPropertyValue(AutomationElement.AutomationIdProperty, true);
if (autoIdNoDefault == AutomationElement.NotSupported)
{
// TODO Handle the case where you do not wish to proceed using the default value.
}
else
{
autoIdString = autoIdNoDefault as string;
}
Dim autoIdString As String
Dim autoIdNoDefault As Object = autoElement.GetCurrentPropertyValue(AutomationElement.AutomationIdProperty, True)
If autoIdNoDefault Is AutomationElement.NotSupported Then
' TODO Handle the case where you do not wish to proceed using the default value.
Else
autoIdString = CStr(autoIdNoDefault)
End If
Comentários
Esse identificador é usado por aplicativos cliente Automação da Interface do Usuário. Automação da Interface do Usuário provedores devem usar o identificador equivalente em AutomationElementIdentifiers.
Essa propriedade também pode ser recuperada das propriedades ou Current das Cached propriedades.
Os valores retornados da propriedade são do tipo String. O valor padrão da propriedade é uma cadeia de caracteres vazia.
Quando estiver disponível, espera-se que o AutomationIdProperty elemento seja sempre o mesmo em qualquer instância do aplicativo, independentemente do idioma local. O valor deve ser exclusivo entre elementos irmãos, mas não necessariamente exclusivo em toda a área de trabalho. Por exemplo, várias instâncias de um aplicativo ou várias exibições de pasta no Gerenciador de Microsoft Windows podem conter elementos com o mesmo AutomationIdProperty, como "SystemMenuBar".
Embora o suporte a um AutomationId seja sempre recomendado para melhor capacidade de teste, essa propriedade não é obrigatória. Quando há suporte, é AutomationId útil criar scripts de automação de teste que são executados independentemente da linguagem da interface do usuário. Os clientes não devem fazer suposições sobre os AutomationIds expostos por outros aplicativos. Não AutomationId é necessariamente garantido que um aplicativo seja estável entre versões ou builds diferentes de um aplicativo.
Instâncias de elementos de interface do usuário (interface do usuário) são identificadas exclusivamente na área de trabalho por suas RuntimeIdProperty propriedades.
Note
AutomationIdProperty é compatível com todos os elementos de Automação da Interface do Usuário na exibição de controle, exceto janelas de aplicativo de nível superior, elementos de Automação de Interface do Usuário derivados de controles do Windows Presentation Foundation (WPF) que não têm uma ID ou x:Uid e elementos de Automação de Interface do Usuário derivados de controles Win32 que não têm uma ID de controle.
