Freigeben über

LVCOLUMNA-Struktur (commctrl.h)

  • Artikel

Enthält Informationen zu einer Spalte in der Berichtsansicht. Diese Struktur wird sowohl zum Erstellen und 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;

Angehörige

mask

Typ: UINT-

Variable, die angibt, welche Elemente gültige Informationen enthalten. Dieses Element kann null oder mindestens eins der folgenden Werte sein:

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

Version 4.70. Das iImage Member ist gültig.
LVCF_ORDER

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

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

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

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

fmt

Typ: int

Ausrichtung der Spaltenüberschrift und des Unterelementtexts in der Spalte. Die Ausrichtung der spalte ganz links ist immer LVCFMT_LEFT; sie kann nicht geändert werden. Dieses Element kann eine Kombination aus den folgenden Werten 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 zum Auswählen dieser Bits von fmt verwendet wird, diese Steuerelementfeldbeschriftung. Verwenden Sie zum Überprüfen des Formats einer Spalte ein logisches "und" zum Kombinieren LCFMT_JUSTIFYMASK mit fmt-. Sie können dann 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 Kopfzeilenelement 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 nicht festgelegt, steuert CCM_DPISCALE die Skalierung der festen Breite.
LVCFMT_FIXED_RATIO

Version 6.00 und Windows Vista. 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 mit Null beendeten Zeichenfolge, die den Spaltenüberschrifttext enthält. Wenn die Struktur Informationen zu einer Spalte empfängt, gibt dieses Element die Adresse des Puffers an, der den Spaltenüberschrifttext empfängt.

cchTextMax

Typ: int

Größe in TCHAR-des Puffers, auf den das pszText--Element verweist. Wenn die Struktur keine Informationen zu einer Spalte empfängt, wird dieses Element ignoriert.

iSubItem

Typ: int

Index des Teilelements, das der Spalte zugeordnet ist.

iImage

Typ: int

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

iOrder

Typ: int

Version 4.70. Nullbasierter Spaltenoffset. Der Spaltenversatz befindet sich in der Reihenfolge von links nach rechts. Null gibt beispielsweise die Spalte ganz links an.

cxMin

Typ: int

Windows Vista. Mindestbreite der Spalte in Pixel.

cxDefault

Typ: int

Windows Vista. Anwendungsdefinierter Wert wird in der Regel verwendet, um die Standardbreite der Spalte zu speichern. Dieses Element wird vom Listenansicht-Steuerelement ignoriert.

cxIdeal

Typ: int

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

Bemerkungen

Wenn einer Spalte ein Listenansicht-Steuerelement mit Index 0 (die spalte ganz links) hinzugefügt wird, wird sie immer LVCFMT_LEFT. Das Festlegen anderer Flags für Spalte 0 überschreibt diese Ausrichtung nicht. Wenn Sie daher weiterhin Spalten mit Index 0 einfügen, wird der Text in allen Spalten linksbündig ausgerichtet. Wenn die erste Spalte rechtsbündig oder zentriert ausgerichtet werden 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 Dummy-Spalte.

Anmerkung

Der commctrl.h-Header definiert LVCOLUMN als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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

Anforderung Wert
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Header- commctrl.h

Siehe auch

LVM_DELETECOLUMN

LVM_GETCOLUMN

LVM_INSERTCOLUMN

LVM_SETCOLUMN

Referenz-