ListView_SetCallbackMask Makro (commctrl.h)

Artikel
10/24/2024

Ändert das Rückrufformat für ein Listenansicht-Steuerelement. Sie können dieses Makro verwenden oder die LVM_SETCALLBACKMASK Nachricht explizit senden.

Syntax

BOOL ListView_SetCallbackMask(
   HWND hwnd,
   UINT mask
);

Parameter

hwnd

Typ: HWND-

Ein Handle für das Listenansicht-Steuerelement.

mask

Typ: UINT-

Der Wert des Rückrufformats. Die Bits der Maske geben die Elementzustände oder Bilder an, für die die Anwendung die aktuellen Statusdaten speichert. Dieser Wert kann eine beliebige Kombination der folgenden Konstanten sein:

Wert	Bedeutung
LVIS_CUT	Das Element wird für einen Ausschneide- und Einfügevorgang markiert.
LVIS_DROPHILITED	Das Element wird als Drag-and-Drop-Ziel hervorgehoben.
LVIS_FOCUSED	Das Element hat den Fokus.
LVIS_SELECTED	Das Element ist ausgewählt.
LVIS_OVERLAYMASK	Die Anwendung speichert den Bildlistenindex des aktuellen Überlagerungsbilds für jedes Element.
LVIS_STATEIMAGEMASK	Die Anwendung speichert den Bildlistenindex des aktuellen Zustandsbilds für jedes Element.

Rückgabewert

Typ: BOOL-

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

Bemerkungen

Das Rückrufformat eines Listenansichtssteuerelements ist eine Reihe von Bitkennzeichnungen, die die Elementzustände angeben, für die die Anwendung anstelle des Steuerelements die aktuellen Daten speichert. Das Rückrufformat gilt für alle Elemente des Steuerelements, anders als bei der Rückrufelementbezeichnung, die für ein bestimmtes Element gilt. Das Rückrufformat ist standardmäßig null, d. h., das Listenansicht-Steuerelement speichert alle Elementstatusinformationen. Nachdem Sie ein Listenansichtssteuerelement erstellt und die zugehörigen Elemente initialisiert haben, können Sie das ListView_SetCallbackMask Makro oder LVM_SETCALLBACKMASK Nachricht verwenden, um das Rückrufformat zu ändern. Um das aktuelle Rückrufformat abzurufen, senden Sie die LVM_GETCALLBACKMASK Nachricht.

Weitere Informationen zu Überlagerungsbildern und Zustandsbildern finden Sie unter List-View Bildlisten.

Weitere Informationen zu Rückrufen in listenansichten finden Sie unter Rückrufelemente und dem

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

Siehe auch

LVN_GETDISPINFO

Freigeben über