IRawElementProviderFragment.GetRuntimeId Methode

  • Referenz

Definition

Namespace:
System.Windows.Automation.Provider
Assembly:
UIAutomationProvider.dll

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[]

Ruft den Laufzeitbezeichner eines Elements ab.

Beispiele

Der folgende Beispielcode zeigt eine Implementierung dieser Methode durch ein Element innerhalb eines Fragments, z. B. ein Element in einem Listenfeld. Das Element verfügt über einen eigenen eindeutigen Bezeichner innerhalb dieses instance des Fragments, und der AppendRuntimeId Wert stellt sicher, dass der von der -Methode zurückgegebene Bezeichner in der Benutzeroberflächenautomatisierungsstruktur 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 null werden, das einem Fensterhandle entspricht. Andere Elemente sollten ein Array zurückgeben, das enthält AppendRuntimeId, gefolgt von einem Wert, der innerhalb des Fragments eindeutig ist.

Es liegt in der Verantwortung des Anbieters, die Eindeutigkeit innerhalb des Fragments sicherzustellen; Beispielsweise muss jedes Element in einer Liste einzeln nummeriert werden. Die Benutzeroberflächenautomatisierungs-Engine stellt sicher, dass der Bezeichner für alle Instanzen eindeutig ist, indem der AppendRuntimeId Wert übersetzt wird.

Gilt für:

Weitere Informationen