AutomationElement.AutomationIdProperty Campo
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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 de Campo
Exemplos
O exemplo seguinte recupera o valor atual da propriedade. O valor padrão é devolvido 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 seguinte recupera o valor atual da propriedade, mas especifica que, se o próprio elemento não fornecer um valor para a propriedade, NotSupported deve ser devolvido 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
Observações
Este identificador é utilizado por aplicações clientes de Automatização da Interface de Utilizador. Automatização da Interface de Utilizador fornecedores devem usar o identificador equivalente em AutomationElementIdentifiers.
Esta propriedade também pode ser recuperada das Current propriedades ou.Cached
Os valores de retorno da propriedade são do tipo String. O valor padrão da propriedade é uma cadeia vazia.
Quando está disponível, espera-se que AutomationIdProperty o de um elemento seja sempre o mesmo em qualquer instância da aplicação, independentemente da língua local. O valor deve ser único entre os elementos irmãos, mas não necessariamente único em todo o ambiente de trabalho. Por exemplo, múltiplas instâncias de uma aplicação, ou múltiplas vistas de pastas no Explorador Microsoft Windows, podem conter elementos com o mesmo AutomationIdProperty, como "SystemMenuBar".
Embora o suporte de um AutomationId seja sempre recomendado para uma melhor teabilidade, esta propriedade não é obrigatória. Quando é suportado, o an AutomationId é útil para criar scripts de automação de testes que correm independentemente da linguagem de interface. Os clientes não devem fazer suposições relativamente aos AutomationIds expostos por outras aplicações. O An AutomationId não é necessariamente garantido que seja estável em diferentes versões ou builds de uma aplicação.
As instâncias de elementos da interface de utilizador (UI) são identificadas de forma única no ambiente de trabalho pelas suas RuntimeIdProperty propriedades.
Note
AutomationIdProperty é suportado por todos os elementos de Automação da UI na vista de controlo, exceto por janelas de aplicação de nível superior, elementos de Automação da UI derivados de controlos Windows Presentation Foundation (WPF) que não têm ID ou x:Uid, e elementos de Automação da UI derivados de controlos Win32 que não têm ID de controlo.
