Share via


ListView_SetItemPosition Makro (commctrl.h)

Verschiebt ein Element an eine angegebene Position in einem Listenansichtssteuerelement (in der Symbol- oder kleinen Symbolansicht). Sie können dieses Makro verwenden oder die LVM_SETITEMPOSITION Nachricht explizit senden.

Syntax

void ListView_SetItemPosition(
   hwndLV,
   i,
   x,
   y
);

Parameter

hwndLV

Typ: HWND

Ein Handle für das Listenansichtssteuerelement.

i

Typ: int

Der Index des Listenansichtselements.

x

Typ: int

Die neue x-Position der oberen linken Ecke des Elements in Ansichtskoordinaten.

y

Typ: int

Die neue y-Position der oberen linken Ecke des Elements in Ansichtskoordinaten.

Rückgabewert

Keine

Bemerkungen

Wenn das Listenansicht-Steuerelement die LVS_AUTOARRANGE-Format aufweist, wird das Listenansicht-Steuerelement nach der Position des Elements angeordnet.

Unter Windows Vista führt das Aufrufen dieses Makros in einem Listenansichtssteuerelement mit der LVS_AUTOARRANGE-Format nicht zu einem Fehler, und der Rückgabewert ist FALSE.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile commctrl.h