This structure contains information about a column in report view. This structure is also used to receive information about a column, and is superseded by the LVCOLUMN structure.
At a Glance
| Header file: | Commctrl.h |
| Windows CE versions: | 1.0 and later |
Syntax
typedef struct _LV_COLUMN {
UINT mask;
int fmt;
int cx;
LPSTR pszText;
int cchTextMax;
int iSubItem;
} LV_COLUMN;
Members
mask
Specifies which members contain valid information. It can be zero, or one or more of the following values:
| Value | Description |
| LVCF_FMT | The fmt member is valid. |
| LVCF_IMAGE | The iImage member is valid. |
| LVCF_ORDER | The iOrder member is valid. |
| LVCF_SUBITEM | The iSubItem member is valid. |
| LVCF_TEXT | The pszText member is valid. |
| LVCF_WIDTH | The cx member is valid. |
fmt
Alignment of the column heading and the subitem text in the column. It is one of the following values:
| Value | Description |
| LVCFMT_BITMAP_ON_RIGHT | Version 4.70. The bitmap appears to the right of text. This does not affect an image from an image list assigned to the header item. |
| LVCFMT_CENTER | Text is centered. |
| LVCFMT_COL_HAS_IMAGES | Version 4.70. The header item contains an image in the image list. |
| LVCFMT_IMAGE | Version 4.70. The item displays an image from an image list. |
| LVCFMT_LEFT | Text is left-aligned. |
| LVCFMT_RIGHT | Text is right-aligned. |
The leftmost column in a list view control must be left-aligned.
cx
Width of the column, in pixels.
pszText
If column information is being set, this member is the pointer to a null-terminated string that contains the column heading text. If the structure is receiving information about a column, this member specifies the address of the buffer that receives the column heading text.
cchTextMax
Size of the buffer pointed to by the pszText member. If the structure is not receiving information about a column, this member is ignored.
iSubItem
Index of subitem associated with the column.
iImage
Zero-based index of an image within the image list. The specified image will appear within the column.
iOrder
Zero-based column offset. Column offset is in left-to-right order. For example, zero indicates the leftmost column.
Remarks
This structure is used with the LVM_GETCOLUMN, LVM_SETCOLUMN, LVM_INSERTCOLUMN, and LVM_DELETECOLUMN messages.