Header_SetHotDivider Makro (commctrl.h)

Artikel
02/24/2024

Ändert die Farbe eines Trenners zwischen Kopfzeilenelementen, um das Ziel eines externen Drag-and-Drop-Vorgangs anzugeben. Sie können dieses Makro verwenden oder die HDM_SETHOTDIVIDER Nachricht explizit senden.

Syntax

void Header_SetHotDivider(
   hwnd,
   fPos,
   dw
);

Parameter

hwnd

Typ: HWND

Ein Handle für ein Headersteuerelement.

fPos

Typ: BOOL

Ein Wert, der angibt, wie dwInputValue interpretiert werden soll. Der Wert in diesem Feld kann einer der folgenden sein:

Wert	Bedeutung
STIMMT	Gibt an, dass dwInputValue Clientkoordinaten des Zeigers enthält.
FALSE	Gibt an, dass dwInputValue einen Dividatorindexwert enthält.

dw

Typ: DWORD

Der hier gespeicherte Wert wird abhängig vom Wert des Flags interpretiert.

Wenn das FlagTRUE ist, stellt dwInputValue die x- und y-Clientkoordinaten des Zeigers dar. Die x-Koordinate befindet sich im niedrigen Wort und die y-Koordinate im hohen Wort. Beim Empfang der Nachricht hebt das Headersteuerelement den entsprechenden Teiler basierend auf den dwInputValue-Koordinaten hervor.

Wenn das FlagFALSE ist, stellt dwInputValue den ganzzahligen Index des dividiert dar, der hervorgehoben wird.

Rückgabewert

Keine

Bemerkungen

Ein Headersteuerelement, das auf die HDS_DRAGDROP-Format festgelegt ist, erzeugt diesen Effekt automatisch. Diese Nachricht soll verwendet werden, wenn der Besitzer des Steuerelements Drag-and-Drop-Vorgänge manuell verarbeitet.

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

Share via