IRawElementProviderFragment.GetRuntimeId Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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.