LVM_SETGROUPINFO Nachricht

Legt Gruppeninformationen fest. Senden Sie diese Nachricht explizit oder mithilfe des makros ListView_SetGroupInfo .

Parameter

wParam [in]

ID, die die Gruppe angibt, deren Informationen festgelegt werden sollen.

lParam [in, out]

Zeiger auf eine LVGROUP-Struktur , die die festzulegenden Informationen enthält.

Rückgabewert

Gibt bei erfolgreicher Ausführung die ID der Gruppe zurück, andernfalls -1.

Bemerkungen

Um eine Gruppen-ID einer vorhandenen Gruppe zu ändern, fügen Sie LVGROUP.maskLVGF_GROUPID hinzu, und legen Sie LVGROUP.iGroupId auf die neue ID fest. Der Aufruf schlägt fehl, wenn LVGROUP.iGroupId die ID einer vorhandenen Gruppe enthält.

Zum Aktualisieren anderer Eigenschaften einer vorhandenen Gruppe (z. B. Aktualisieren einer Ausrichtung des Kopf- oder Fußzeilentexts für die Gruppe, uAlign) darf LVGROUP.mask keine LVGF_GROUPID enthalten, andernfalls schlägt die Aktualisierung fehl.

Hinweis

Um diese Meldung verwenden zu können, müssen Sie ein Manifest angeben, das Comclt32.dll Version 6.0 angibt. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.

Anforderungen

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