AutomationElement.AutomationIdProperty フィールド

定義

名前空間:

System.Windows.Automation

アセンブリ:

UIAutomationClient.dll

要素を識別するために使用される AutomationId プロパティを識別します。

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 

フィールド値

AutomationProperty

例

次の例では、 プロパティの現在の値を取得します。 要素に指定されていない場合は、既定値が返されます。

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

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

次の例では、 プロパティの現在の値を取得しますが、要素自体がプロパティの値を提供しない場合は、 NotSupported 既定値ではなく を返すように指定します。

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

注釈

この識別子は、UI オートメーション クライアント アプリケーションで使用されます。 UI オートメーション プロバイダーでは、 で AutomationElementIdentifiers同等の識別子を使用する必要があります。

このプロパティは、 または Cached プロパティからCurrent取得することもできます。

プロパティの戻り値は 型 Stringです。 プロパティの既定値は空の文字列です。

使用できる AutomationIdProperty 場合、 要素の は、ローカル言語に関係なく、アプリケーションの任意のインスタンスで常に同じである必要があります。 値は兄弟要素間で一意である必要がありますが、必ずしもデスクトップ全体で一意であるとは限りません。 たとえば、アプリケーションの複数のインスタンス、または Microsoft Windows エクスプローラーの複数のフォルダー ビューには、"SystemMenuBar" などの同じ AutomationIdPropertyを持つ要素が含まれている場合があります。

テストの容易性を AutomationId 高めるには、 のサポートが常に推奨されますが、このプロパティは必須ではありません。 サポートされている場合、 は、 AutomationId UI 言語に関係なく実行されるテスト自動化スクリプトを作成するのに役立ちます。 クライアントは、他のアプリケーションによって公開される に AutomationId関して何も想定しないでください。 AutomationIdは、アプリケーションの異なるリリースまたはビルド間で安定するとは限りません。

ユーザー インターフェイス (UI) 要素のインスタンスは、そのプロパティによって RuntimeIdProperty デスクトップ上で一意に識別されます。

Note

AutomationIdProperty をサポートしているのは、最上位のアプリケーション ウィンドウ以外のコントロール ビューにあるすべての UI オートメーション要素、ID または x:Uid を持たない Windows Presentation Foundation (WPF) コントロールから派生した UI オートメーション要素、およびコントロール ID を持たない Win32 コントロールから派生した UI オートメーション要素です。

こちらもご覧ください

• RuntimeIdProperty
• UI オートメーション プロパティの概要
• UI オートメーション要素の取得