IGridProvider::GetItem-Methode (uiautomationcore.h)

Ruft den Microsoft-Benutzeroberflächenautomatisierungsanbieter für die angegebene Zelle ab.

Syntax

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

Parameter

[in] row

Typ: int

Die Ordinalzahl der betreffenden Zeile.

[in] column

Typ: int

Die Ordinalzahl der betreffenden Spalte.

[out, retval] pRetVal

Typ: IRawElementProviderSimple**

Empfängt einen Zeiger auf einen Benutzeroberflächenautomatisierungsanbieter für die angegebene Zelle oder einen NULL-Verweis (Nothing in Microsoft Visual Basic .NET), wenn die Zelle leer ist.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Rasterkoordinaten sind nullbasiert, wobei die obere linke (oder obere rechte Zelle je nach Gebietsschema) Koordinaten (0,0) aufweist.

Wenn eine Zelle leer ist, muss weiterhin ein Benutzeroberflächenautomatisierungsanbieter zurückgegeben werden, um die ContainingGrid-Eigenschaft für diese Zelle zu unterstützen. Dies ist möglich, wenn das Layout untergeordneter Elemente im Raster einem unregelmäßigen Array ähnelt.

Ausgeblendete Zeilen und Spalten können je nach Anbieterimplementierung in die Benutzeroberflächenautomatisierungsstruktur geladen werden und werden daher in den Eigenschaften IGridProvider::RowCount und IGridProvider::ColumnCount widerspiegelt . Wenn die ausgeblendeten Zeilen und Spalten noch nicht geladen wurden, sollten sie nicht gezählt werden.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationcore.h (uiAutomation.h einschließen)
DLL	Uiautomationcore.dll

Weitere Informationen

IGridProvider

Übersicht über die Benutzeroberflächenautomatisierungs-Anbieter