AutomationElement.AutomationIdProperty Campo

Definizione

Spazio dei nomi:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

Identifica la proprietà AutomationId usata per identificare elementi.

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 

Valore del campo

AutomationProperty

Esempio

Nell'esempio seguente viene recuperato il valore corrente della proprietà. Il valore predefinito viene restituito se l'elemento non ne fornisce uno.

string autoId =
    autoElement.GetCurrentPropertyValue(AutomationElement.AutomationIdProperty) as string;

Dim autoId As String = _
    CStr(autoElement.GetCurrentPropertyValue(AutomationElement.AutomationIdProperty))

L'esempio seguente recupera il valore corrente della proprietà, ma specifica che se l'elemento stesso non fornisce un valore per la proprietà, NotSupported deve essere restituito anziché un valore predefinito.

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

Commenti

Questo identificatore viene usato dalle applicazioni client Automazione interfaccia utente. Automazione interfaccia utente provider devono usare l'identificatore equivalente in AutomationElementIdentifiers.

Questa proprietà può essere recuperata anche dalle Current proprietà o Cached .

I valori restituiti della proprietà sono di tipo String. Il valore predefinito per la proprietà è una stringa vuota.

Quando è disponibile l'oggetto AutomationIdProperty di un elemento, è previsto che sia sempre lo stesso in qualsiasi istanza dell'applicazione indipendentemente dalla lingua locale. Il valore deve essere univoco tra gli elementi di pari livello, ma non necessariamente univoco nell'intero desktop. Ad esempio, più istanze di un'applicazione o più visualizzazioni di cartelle in Microsoft Windows Explorer possono contenere elementi con lo stesso AutomationIdProperty, ad esempio "SystemMenuBar".

Anche se il supporto di un AutomationId oggetto è sempre consigliato per migliorare la testability, questa proprietà non è obbligatoria. Dove è supportato, un AutomationId oggetto è utile per la creazione di script di automazione di test eseguiti indipendentemente dal linguaggio dell'interfaccia utente. I client non devono prendere presupposti relativi all'oggetto AutomationIdesposto da altre applicazioni. Un AutomationId oggetto non è necessariamente garantito essere stabile tra versioni diverse o compilazioni di un'applicazione.

Le istanze degli elementi dell'interfaccia utente vengono identificate in modo univoco sul desktop dalle relative RuntimeIdProperty proprietà.

Nota

AutomationIdPropertyè supportato da tutti gli elementi Automazione interfaccia utente nella visualizzazione controllo, ad eccezione delle finestre dell'applicazione di primo livello, Automazione interfaccia utente elementi derivati dai controlli Windows Presentation Foundation (WPF) che non hanno un ID o x:Uid e Automazione interfaccia utente elementi derivati dai controlli Win32 che non hanno un ID controllo.

Vedi anche

• RuntimeIdProperty
• Cenni preliminari sulle proprietà di automazione interfaccia utente
• Ottenere elementi di automazione interfaccia utente