Méthode IGridProvider::GetItem (uiautomationcore.h)

Récupère le fournisseur Microsoft UI Automation pour la cellule spécifiée.

Syntaxe

HRESULT GetItem(
  [in]          int                       row,
  [in]          int                       column,
  [out, retval] IRawElementProviderSimple **pRetVal
);

Paramètres

[in] row

Type : int

Numéro ordinal de la ligne concernée.

[in] column

Type : int

Numéro ordinal de la colonne concernée.

[out, retval] pRetVal

Type : IRawElementProviderSimple**

Reçoit un pointeur vers un fournisseur UI Automation pour la cellule spécifiée ou une référence Null (Nothing dans Microsoft Visual Basic .NET) si la cellule est vide.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Les coordonnées de grille sont de base zéro, la cellule supérieure gauche (ou la cellule supérieure droite selon les paramètres régionaux) ayant des coordonnées (0,0).

Si une cellule est vide, un fournisseur UI Automation doit toujours être retourné pour prendre en charge la propriété ContainingGrid pour cette cellule. Cela est possible lorsque la disposition des éléments enfants dans la grille est similaire à un tableau en lambeaux.

Les lignes et colonnes masquées, en fonction de l’implémentation du fournisseur, peuvent être chargées dans l’arborescence UI Automation et sont donc répercutées dans les propriétés IGridProvider::RowCount et IGridProvider::ColumnCount . Si les lignes et colonnes masquées n’ont pas encore été chargées, elles ne doivent pas être comptabilisées.

Configuration requise

Client minimal pris en charge	Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible	Windows
En-tête	uiautomationcore.h (incluez UIAutomation.h)
DLL	Uiautomationcore.dll

Voir aussi

IGridProvider

Vue d'ensemble des fournisseurs UI Automation