ListView_SetIconSpacing Makro (commctrl.h)

Legt den Abstand zwischen Symbolen in Listenansicht-Steuerelementen fest, die auf die LVS_ICON Formatvorlage festgelegt sind. Sie können dieses Makro verwenden oder die LVM_SETICONSPACING Nachricht explizit senden.

Syntax

DWORD ListView_SetIconSpacing(
   HWND hwndLV,
   int  cx,
   int  cy
);

Parameter

hwndLV

Typ: HWND-

Ein Handle zu einem Listenansichtssteuerelement.

cx

Typ: int

Der Abstand in Pixel, der zwischen Symbolen auf der x-Achse festgelegt werden soll.

cy

Typ: int

Der Abstand in Pixel, der zwischen Symbolen auf der y-Achse festgelegt werden soll.

Rückgabewert

Typ: DWORD-

Gibt einen DWORD--Wert zurück, der den vorherigen enthält.

Bemerkungen

Die parameter cx und cy sind relativ zur oberen linken Ecke einer Symbolbitmap. Um den Abstand zwischen Nichtüberlappungssymbolen festzulegen, müssen die cx- oder cy- Werte die Größe des Symbols sowie den zwischen Symbolen gewünschten Leerraum enthalten. Werte, die die Breite des Symbols nicht enthalten, führen zu Überschneidungen.

Beim Definieren des Symbolabstands müssen cx- und cy- auf 4 oder größer festgelegt werden. Kleinere Werte liefern nicht das gewünschte Layout. Sie können cx- und cy- auf den Standardabstand zurücksetzen, indem Sie beide Werte auf -1 festlegen. Mit diesem Ansatz können Sie nur beide Standardeinstellungen zurücksetzen. Sie können nicht nur cx oder cy auf die Standardeinstellung zurücksetzen, indem Sie eine davon auf -1 festlegen.

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