IRawElementProviderFragment.GetRuntimeId Metoda

Definice

Načte identifikátor modulu runtime elementu.Retrieves the runtime identifier of an element.

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

Návraty

Int32[]

Jedinečný identifikátor runtime elementu.The unique run-time identifier of the element.

Příklady

Následující příklad kódu ukazuje implementaci této metody prvkem v rámci fragmentu, jako je například položka v rámci seznamu.The following example code shows an implementation of this method by an element within a fragment, such as an item within a list box. Položka má svůj vlastní jedinečný identifikátor v rámci této instance fragmentu a AppendRuntimeId hodnota zajistí, že identifikátor vrácený metodou je jedinečný ve stromu automatizace uživatelského rozhraní.The item has its own unique identifier within this instance of the fragment, and the AppendRuntimeId value ensures that the identifier returned by the method is unique in the UI Automation tree.

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

Poznámky

Implementace by měly vracet null pro prvek, který odpovídá popisovači okna.Implementations should return null for an element that corresponds to a window handle. Ostatní elementy by měly vracet pole, které obsahuje AppendRuntimeId , následované hodnotou, která je v rámci fragmentu jedinečná.Other elements should return an array that contains AppendRuntimeId, followed by a value that is unique within the fragment.

Je zodpovědností poskytovatele zajistit jedinečnost v rámci fragmentu. například každá položka v seznamu musí být individuálně očíslována.It is the provider's responsibility to ensure uniqueness within the fragment; for example, each item in a list must be individually numbered. Modul pro automatizaci uživatelského rozhraní zajišťuje, aby byl identifikátor jedinečný mezi všemi instancemi, překládáním AppendRuntimeId hodnoty.The UI Automation engine ensures that the identifier is unique among all instances, by translating the AppendRuntimeId value.

Platí pro