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

void ListView_SetColumnWidth(
   hwnd,
   iCol,
   cx
);

Parameter

hwnd

Typ: HWND

Ein Handle für das Listenansichtssteuerelement.

iCol

Typ: int

Der nullbasierte Index einer gültigen Spalte. Für den Listenansichtsmodus muss dieser Parameter auf 0 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	Die Spalte wird automatisch groß formatiert.
LVSCW_AUTOSIZE_USEHEADER	Die Spalte wird automatisch so groß formatiert, dass sie dem Kopfzeilentext entspricht. Wenn Sie diesen Wert mit der letzten Spalte verwenden, wird seine Breite so festgelegt, dass die verbleibende Breite des Listenansichtssteuerelements ausgefüllt wird.

Rückgabewert

Keine

Bemerkungen

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

ListView_SetColumnWidth(hwnd, 1, LVSCW_AUTOSIZE_USEHEADER)

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

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

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