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

BOOL ListView_SetItemPosition(
   HWND hwndLV,
   int  i,
   int  x,
   int  y
);

Parameter

hwndLV

Typ: HWND-

Ein Handle für das Listenansicht-Steuerelement.

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

Typ: BOOL-

Gibt TRUE zurück, wenn dies erfolgreich ist, oder FALSE andernfalls.

Bemerkungen

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

Unter Windows Vista bewirkt das Aufrufen dieses Makros für ein Listenansicht-Steuerelement mit dem LVS_AUTOARRANGE Stil nichts, und der Rückgabewert ist FALSE.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	commctrl.h