IRawElementProviderFragment.GetRuntimeId Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Récupère l’identificateur d’exécution d’un élément.
public:
cli::array <int> ^ GetRuntimeId();
public int[] GetRuntimeId ();
abstract member GetRuntimeId : unit -> int[]
Public Function GetRuntimeId () As Integer()
Retours
Identificateur d’exécution unique de l’élément.
Exemples
L’exemple de code suivant montre une implémentation de cette méthode par un élément dans un fragment, tel qu’un élément dans une zone de liste. L’élément a son propre identificateur unique dans cette instance du fragment, et la AppendRuntimeId valeur garantit que l’identificateur retourné par la méthode est unique dans l’arborescence UI Automation.
/// <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
Remarques
Les implémentations doivent retourner null
pour un élément qui correspond à un handle de fenêtre. D’autres éléments doivent retourner un tableau qui contient AppendRuntimeId, suivi d’une valeur unique dans le fragment.
Il incombe au fournisseur de garantir l’unicité au sein du fragment; par exemple, chaque élément d’une liste doit être numéroté individuellement. Le moteur UI Automation garantit que l’identificateur est unique parmi toutes les instances, en traduisant la AppendRuntimeId valeur.