LVCOLUMNA-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 tagLVCOLUMNA {
  UINT  mask;
  int   fmt;
  int   cx;
  LPSTR pszText;
  int   cchTextMax;
  int   iSubItem;
  int   iImage;
  int   iOrder;
  int   cxMin;
  int   cxDefault;
  int   cxIdeal;
} LVCOLUMNA, *LPLVCOLUMNA;

Member

mask

Typ: UINT

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

Wert Bedeutung
LVCF_FMT
 Der fmt-Member ist gültig.
LVCF_WIDTH
 Das cx-Element 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 linken 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.
LVCFMT_RIGHT
 Text ist rechtsbündig.
LVCFMT_CENTER
 Der Text wird zentriert.
LVCFMT_JUSTIFYMASK
 Eine Bitmaske, die verwendet wird, um die Fmt-Bits auszuwählen, die die Berechtigung des Steuerfelds enthalten. 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 mithilfe einer switch-Anweisung 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 Headerelement enthält ein Bild in der Bildliste.
LVCFMT_FIXED_WIDTH

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

Version 6.00 und Windows Vista. Wenn nicht festgelegt, 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). Die Kopfzeile der Spalte zeigt eine geteilte Schaltfläche an (identisch mit HDF_SPLITBUTTON).

cx

Typ: int

Breite der Spalte in Pixel.

pszText

Typ: LPTSTR

Wenn Spalteninformationen festgelegt werden, ist dieses Element die Adresse einer null-beendeten Zeichenfolge, 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 das pszText-Element 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. Null gibt z. B. die äußerst linke Spalte an.

cxMin

Typ: int

Windows Vista. Mindestbreite der Spalte in Pixel.

cxDefault

Typ: int

Windows Vista. Anwendungsdefinierter Wert, der normalerweise zum Speichern der Standardbreite der Spalte verwendet wird. Dieses Element wird vom Listenansicht-Steuerelement ignoriert.

cxIdeal

Typ: int

Windows Vista. Schreibgeschützt. Die ideale Breite der Spalte in Pixel, da die Spalte derzeit automatisch auf eine geringere Breite festgelegt werden kann.

Hinweise

Wenn eine Spalte einem Listenansichtssteuerelement mit Index 0 (der spalte am weitesten links) hinzugefügt wird, wird sie immer LVCFMT_LEFT. Das Festlegen anderer Flags für Spalte 0 überschreibt diese Ausrichtung nicht. Wenn Sie also weiterhin Spalten mit Index 0 einfügen, wird der Text in allen Spalten linksbündig ausgerichtet. 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 Code, der nicht Codierungsneutral ist, 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