ListView_SetCallbackMask Makro (commctrl.h)

  • Artikel

Ändert die Rückrufmaske für ein Listenansichtssteuerelement. Sie können dieses Makro verwenden oder die LVM_SETCALLBACKMASK Nachricht explizit senden.

Syntax

void ListView_SetCallbackMask(
   hwnd,
   mask
);

Parameter

hwnd

Typ: HWND

Ein Handle für das Listenansichtssteuerelement.

mask

Typ: UINT

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

Wert Bedeutung
LVIS_CUT
 Das Element wird für einen Ausschneiden- 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 Imagelistenindex des aktuellen Zustandsimages für jedes Element.

Rückgabewert

Keine

Bemerkungen

Die Rückrufmaske eines Listenansichtssteuerelements ist eine Gruppe von Bitflags, die die Elementzustände angeben, für die die Anwendung anstelle des Steuerelements die aktuellen Daten speichert. Die Rückrufmaske gilt für alle Elemente des Steuerelements, im Gegensatz zur Rückrufelementbezeichnung, die für ein bestimmtes Element gilt. Die Rückrufmaske ist standardmäßig null, was bedeutet, dass das Listenansicht-Steuerelement alle Elementstatusinformationen speichert. Nachdem Sie ein Listenansicht-Steuerelement erstellt und dessen Elemente initialisiert haben, können Sie das ListView_SetCallbackMask-Makro oder LVM_SETCALLBACKMASK Nachricht verwenden, um die Rückrufmaske zu ändern. Um die aktuelle Rückrufmaske abzurufen, senden Sie die LVM_GETCALLBACKMASK Nachricht.

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

Weitere Informationen zu Rückrufen in der Listenansicht finden Sie unter Rückrufelemente und Rückrufmaske.

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

Weitere Informationen

LVN_GETDISPINFO