ListView_SetColumnWidth Makro (commctrl.h)

Wird verwendet, um die Breite einer Spalte in der Berichtsansicht oder die Breite aller Spalten im Listenansichtsmodus zu ändern. Sie können dieses Makro verwenden oder die LVM_SETCOLUMNWIDTH Nachricht explizit senden.

Syntax

BOOL ListView_SetColumnWidth(
   HWND hwnd,
   int  iCol,
   int  cx
);

Parameter

hwnd

Typ: HWND-

Ein Handle für das Listenansicht-Steuerelement.

iCol

Typ: int

Der nullbasierte Index einer gültigen Spalte. Für den Listenansichtsmodus muss dieser Parameter auf Null festgelegt werden.

cx

Typ: int

Die neue Breite der Spalte in Pixel. Für den Berichtsansichtsmodus werden die folgenden speziellen Werte unterstützt:

Wert	Bedeutung
LVSCW_AUTOSIZE	Passt die Größe der Spalte automatisch an.
LVSCW_AUTOSIZE_USEHEADER	Passt die Spalte automatisch an den Kopfzeilentext an. Wenn Sie diesen Wert mit der letzten Spalte verwenden, wird die Breite so festgelegt, dass die verbleibende Breite des Listenansicht-Steuerelements ausgefüllt wird.

Rückgabewert

Typ: BOOL-

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

Bemerkungen

Angenommen, Sie verfügen über ein 2spaltiges Listenansicht-Steuerelement mit einer Breite von 500 Pixeln. Wenn die Breite der Spalte Null auf 200 Pixel festgelegt ist und Sie den folgenden Aufruf ausführen.

ListView_SetColumnWidth(hwnd, 1, LVSCW_AUTOSIZE_USEHEADER)

Die zweite (und letzte) Spalte ist 300 Pixel breit.

Beachten Sie, dass ListView_SetColumnWidth den parameter cx in einen 16-Bit-Wert konvertiert.

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