Header_SetHotDivider Makro (commctrl.h)

Ändert die Farbe einer Trennlinie 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

int Header_SetHotDivider(
   HWND  hwnd,
   BOOL  fPos,
   DWORD dw
);

Parameter

hwnd

Typ: HWND-

Ein Handle für ein Kopfzeilensteuerelement.

fPos

Typ: BOOL-

Ein Wert, der angibt, wie dw- interpretiert werden soll. Der Wert in diesem Feld kann eine der folgenden Sein:

dw

Typ: DWORD-

Der hier gespeicherte Wert wird abhängig vom Wert von fPosinterpretiert.

Wenn fPos-TRUEist, stellt dw- die x- und y-Clientkoordinaten des Zeigers dar. Die X-Koordinate befindet sich im unteren Wort, und die Y-Koordinate befindet sich im hohen Wort. Beim Empfangen der Nachricht hebt das Kopfzeilensteuerelement die entsprechende Trennlinie basierend auf den dw- Koordinaten hervor.

Wenn fPosFALSEist, stellt dw den ganzzahligen Index der Hervorgehobenen Trennlinie dar.

Rückgabewert

Typ: int

Gibt den Index der Trennlinie zurück, die das Steuerelement hervorgehoben hat.

Bemerkungen

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

Anforderungen