IRawElementProviderFragment.GetRuntimeId Methode

Definition

Ruft den Laufzeitbezeichner eines Elements ab.

public:
 cli::array <int> ^ GetRuntimeId();
public int[] GetRuntimeId();
abstract member GetRuntimeId : unit -> int[]
Public Function GetRuntimeId () As Integer()

Gibt zurück

Int32[]

Der eindeutige Laufzeitbezeichner des Elements.

Beispiele

Der folgende Beispielcode zeigt eine Implementierung dieser Methode durch ein Element innerhalb eines Fragments, z. B. ein Element innerhalb eines Listenfelds. Das Element verfügt über einen eigenen eindeutigen Bezeichner in dieser Instanz des Fragments, und der wert AppendRuntimeId stellt sicher, dass der von der Methode zurückgegebene Bezeichner in der Benutzeroberflächenautomatisierung Struktur eindeutig ist.

/// <summary>
/// Gets the runtime identifier of the UI Automation element.
/// </summary>
/// <remarks>
/// myID is a unique identifier for the item within this instance of the list.
/// </remarks>
public int[] GetRuntimeId()
{
    return new int[] { AutomationInteropProvider.AppendRuntimeId, myID };
}
''' <summary>
''' Gets the runtime identifier of the UI Automation element.
''' </summary>
''' <remarks>
''' myID is a unique identifier for the item within this instance of the list.
''' </remarks>
Public Function GetRuntimeId() As Integer() _
    Implements IRawElementProviderFragment.GetRuntimeId

    Return New Integer() {AutomationInteropProvider.AppendRuntimeId, myID}

End Function 'GetRuntimeId

Hinweise

Implementierungen sollten für ein Element zurückgegeben werden null , das einem Fensterhandle entspricht. Andere Elemente sollten ein Array zurückgeben, das gefolgt von einem Wert enthält AppendRuntimeId, der innerhalb des Fragments eindeutig ist.

Es liegt in der Verantwortung des Anbieters, die Eindeutigkeit innerhalb des Fragments zu gewährleisten; Beispielsweise muss jedes Element in einer Liste einzeln nummeriert werden. Das Benutzeroberflächenautomatisierung Modul stellt sicher, dass der Bezeichner zwischen allen Instanzen eindeutig ist, indem der wert AppendRuntimeId übersetzt wird.

Gilt für:

Weitere Informationen