Partilhar via


AutomationElement.AutomationIdProperty Campo

Definição

Identifica a propriedade AutomationId, 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.AutomationProperty
Public 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 próprio elemento não fornecer um valor para a propriedade, NotSupported deverá 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 da Automação da Interface do Usuário. Os provedores de Automação da Interface do Usuário devem usar o identificador equivalente em AutomationElementIdentifiers.

Essa propriedade também pode ser recuperada das Current propriedades ou Cached .

Os valores retornados da propriedade são do tipo String. O valor padrão da propriedade é uma cadeia de caracteres vazia.

Quando ele está disponível, espera-se que o AutomationIdProperty de um 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 Microsoft Windows Explorer, podem conter elementos com o mesmo AutomationIdProperty, como "SystemMenuBar".

Embora o suporte de um AutomationId seja sempre recomendado para melhor capacidade de teste, essa propriedade não é obrigatória. Quando há suporte, um AutomationId é útil para criar scripts de automação de teste executados independentemente da linguagem de 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 seja estável em diferentes versões ou builds de um aplicativo.

Instâncias de elementos de interface do usuário são identificadas exclusivamente na área de trabalho por suas RuntimeIdProperty propriedades.

Observação

AutomationIdProperty é compatível com todos os elementos Automação da Interface do Usuário no modo de exibição de controle, exceto janelas de aplicativos 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 da automação da interface do usuário derivados de controles Win32 que não têm uma ID de controle.

Aplica-se a

Confira também