LV_COLUMN

The LV_COLUMN structure contains information about a column in a list view control. This structure is also used to receive information about a column.

typedef struct _LV_COLUMN {

UINT mask;

int fmt;

int cx;

LPTSTR pszText;

int cchTextMax;

int iSubItem;

} LV_COLUMN;

Members

mask

Specifies which members of this structure contain valid information. This member can be zero, or one or more of the following values:

Value Meaning
LVCF_FMT The fmt 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

Specifies the alignment of the column heading and the subitem text in the column. This member can be one of the following values:

Value Meaning
LVCFMT_CENTER Text is centered.
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

Specifies the width, in pixels, of the column.

pszText

Pointer to a null-terminated string that contains the column heading if the structure contains information about a column. If the structure is receiving information about a column, this member specifies the address of the buffer that receives the column heading.

cchTextMax

Specifies the size, in characters, of the buffer pointed to by the pszText member. If the structure is not receiving information about a column, this member is ignored.

iSubItem

Specifies the index of subitem associated with column.

Remarks

This structure is used with the LVM_GETCOLUMN, LVM_SETCOLUMN, LVM_INSERTCOLUMN, and LVM_DELETECOLUMN messages.

See Also

LVM_DELETECOLUMN, LVM_GETCOLUMN, LVM_INSERTCOLUMN, LVM_SETCOLUMN