LVCOLUMNW-Struktur (commctrl.h)

  • Artikel

Enthält Informationen zu einer Spalte in der Berichtsansicht. Diese Struktur wird sowohl zum Erstellen als auch zum Bearbeiten von Spalten verwendet. Diese Struktur ersetzt die LV_COLUMN-Struktur.

Syntax

typedef struct tagLVCOLUMNW {
  UINT   mask;
  int    fmt;
  int    cx;
  LPWSTR pszText;
  int    cchTextMax;
  int    iSubItem;
  int    iImage;
  int    iOrder;
  int    cxMin;
  int    cxDefault;
  int    cxIdeal;
} LVCOLUMNW, *LPLVCOLUMNW;

Member

mask

Typ: UINT

Variable, die angibt, welche Member gültige Informationen enthalten. Dieser Member kann null oder ein oder mehrere der folgenden Werte sein:

Wert Bedeutung
LVCF_FMT
 Der fmt-Member ist gültig.
LVCF_WIDTH
 Der cx-Member ist gültig.
LVCF_TEXT
 Das pszText-Element ist gültig.
LVCF_SUBITEM
 Das iSubItem-Element ist gültig.
LVCF_IMAGE

Version 4.70. Das iImage-Element ist gültig.
LVCF_ORDER

Version 4.70. Das iOrder-Element ist gültig.
LVCF_MINWIDTH

Version 6.00 und Windows Vista.Das cxMin-Element ist gültig.
LVCF_DEFAULTWIDTH

Version 6.00 und Windows Vista.Das cxDefault-Element ist gültig.
LVCF_IDEALWIDTH

Version 6.00 und Windows Vista.Das cxIdeal-Element ist gültig.

fmt

Typ: int

Ausrichtung der Spaltenüberschrift und des Unterelementtexts in der Spalte. Die Ausrichtung der am weitesten links stehenden Spalte ist immer LVCFMT_LEFT; sie kann nicht geändert werden. Dieser Member kann eine Kombination der folgenden Werte sein. Beachten Sie, dass nicht alle Kombinationen gültig sind.

Wert Bedeutung
LVCFMT_LEFT
 Text ist linksbündig ausgerichtet.
LVCFMT_RIGHT
 Text ist rechtsbündig ausgerichtet.
LVCFMT_CENTER
 Der Text wird zentriert.
LVCFMT_JUSTIFYMASK
 Eine Bitmaske, die verwendet wird, um die Fmt-Bits auszuwählen, die die Feldausrichtung steuern. Um das Format einer Spalte zu überprüfen, verwenden Sie ein logisches "und", um LCFMT_JUSTIFYMASK mit fmt zu kombinieren. Anschließend können Sie eine switch-Anweisung verwenden, um zu bestimmen, ob die LVCFMT_LEFT, LVCFMT_RIGHT oder LVCFMT_CENTER Bits festgelegt sind.
LVCFMT_IMAGE

Version 4.70. Das Element zeigt ein Bild aus einer Bildliste an.
LVCFMT_BITMAP_ON_RIGHT

Version 4.70. Die Bitmap wird rechts neben dem Text angezeigt. Dies wirkt sich nicht auf ein Bild aus einer Bildliste aus, die dem Headerelement zugewiesen ist.
LVCFMT_COL_HAS_IMAGES

Version 4.70. Das Kopfzeilenelement enthält ein Bild in der Bildliste.
LVCFMT_FIXED_WIDTH

Version 6.00 und Windows Vista. Die Größe der Spalte kann nicht geändert werden. identisch mit HDF_FIXEDWIDTH.
LVCFMT_NO_DPI_SCALE

Version 6.00 und Windows Vista. Wenn diese Einstellung nicht festgelegt ist, steuert CCM_DPISCALE das Hochskalieren der festen Breite.
LVCFMT_FIXED_RATIO

Version 6.00 und Windows Vista. Die Breite wird mit der Zeilenhöhe erweitert.
LVCFMT_SPLITBUTTON

Version 6.00 und Windows Vista. Spalte ist eine geteilte Schaltfläche (identisch mit HDF_SPLITBUTTON). In der Kopfzeile der Spalte wird eine geteilte Schaltfläche angezeigt (identisch mit HDF_SPLITBUTTON).

cx

Typ: int

Breite der Spalte in Pixel.

pszText

Typ: LPTSTR

Wenn Spalteninformationen festgelegt werden, ist dieser Member die Adresse einer Zeichenfolge mit NULL-Beendigung, die den Spaltenheadertext enthält. Wenn die Struktur Informationen zu einer Spalte empfängt, gibt dieses Element die Adresse des Puffers an, der den Spaltenheadertext empfängt.

cchTextMax

Typ: int

Größe in TCHARs des Puffers, auf den der pszText-Member verweist. Wenn die Struktur keine Informationen zu einer Spalte empfängt, wird dieser Member ignoriert.

iSubItem

Typ: int

Index des der Spalte zugeordneten Unterelements.

iImage

Typ: int

Version 4.70. Nullbasierter Index eines Bilds innerhalb der Bildliste. Das angegebene Bild wird in der Spalte angezeigt.

iOrder

Typ: int

Version 4.70. Nullbasierter Spaltenoffset. Der Spaltenoffset befindet sich in der Reihenfolge von links nach rechts. Beispielsweise gibt 0 die spalte ganz links an.

cxMin

Typ: int

Windows Vista. Mindestbreite der Spalte in Pixel.

cxDefault

Typ: int

Windows Vista. Anwendungsdefinierter Wert, der in der Regel zum Speichern der Standardbreite der Spalte verwendet wird. Dieses Element wird vom Listenansichtssteuerelement ignoriert.

cxIdeal

Typ: int

Windows Vista. Schreibgeschützt. Die ideale Breite der Spalte in Pixel, da die Spalte derzeit möglicherweise in eine geringere Breite autosisiert wird.

Hinweise

Wenn eine Spalte einem Listenansichtssteuerelement mit Index 0 (der linken Spalte) hinzugefügt wird, wird sie immer LVCFMT_LEFT. Wenn Sie andere Flags für Spalte 0 festlegen, wird diese Ausrichtung nicht außer Kraft gesetzt. Wenn Sie also weiterhin Spalten mit Index 0 einfügen, ist der Text in allen Spalten linksbündig. Wenn die erste Spalte rechtsbündig oder zentriert sein soll, können Sie eine Dummyspalte erstellen, dann eine oder mehrere Spalten mit Index 1 oder höher einfügen und die gewünschte Ausrichtung angeben. Löschen Sie schließlich die Dummyspalte.

Hinweis

Der commctrl.h-Header definiert LVCOLUMN als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile commctrl.h

Weitere Informationen

LVM_DELETECOLUMN

LVM_GETCOLUMN

LVM_INSERTCOLUMN

LVM_SETCOLUMN

Referenz