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
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.
