Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
Der fmt-Member ist gültig. |
|
Der cx-Member ist gültig. |
|
Das pszText-Element ist gültig. |
|
Das iSubItem-Element ist gültig. |
|
Version 4.70. Das iImage-Element ist gültig. |
|
Version 4.70. Das iOrder-Element ist gültig. |
|
Version 6.00 und Windows Vista.Das cxMin-Element ist gültig. |
|
Version 6.00 und Windows Vista.Das cxDefault-Element ist gültig. |
|
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 |
|---|---|
|
Text ist linksbündig ausgerichtet. |
|
Text ist rechtsbündig ausgerichtet. |
|
Der Text wird zentriert. |
|
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. |
|
Version 4.70. Das Element zeigt ein Bild aus einer Bildliste an. |
|
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. |
|
Version 4.70. Das Kopfzeilenelement enthält ein Bild in der Bildliste. |
|
Version 6.00 und Windows Vista. Die Größe der Spalte kann nicht geändert werden. identisch mit HDF_FIXEDWIDTH. |
|
Version 6.00 und Windows Vista. Wenn diese Einstellung nicht festgelegt ist, steuert CCM_DPISCALE das Hochskalieren der festen Breite. |
|
Version 6.00 und Windows Vista. Die Breite wird mit der Zeilenhöhe erweitert. |
|
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
Referenz