Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure contains information about a column in report view. This structure is used both for creating columns and manipulating them using messages. The structure was extended to support new mask values. Two new members, iOrderand iImage, were added to support the new mask values.

Syntax 

typedef struct _LVCOLUMN { 
  UINT 
mask; 
  int 
fmt; 
  int 
cx; 
  LPTSTR 
pszText; 
  int 
cchTextMax; 
  int 
iSubItem; 
  int 
iOrder;
  int 
iImage;
} LVCOLUMN;

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 fmtmember is valid.

LVCF_IMAGE

The iImagemember is valid.

LVCF_ORDER

The iOrdermember is valid.

LVCF_SUBITEM

The iSubItemmember is valid.

LVCF_TEXT

The pszTextmember is valid.

LVCF_WIDTH

The cxmember 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

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_IMAGE

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 pszTextmember. If the structure is not receiving information about a column, this member is ignored.

iSubItem

Index of subitem associated with the column.

iOrder

Zero-based column offset. Column offset is with left-to-right order. For example, zero indicates the leftmost column.

iImage

Zero-based index of an image within the image list. The specified image will appear within the column.

Remarks

This structure supersedes the LV_COLUMNstructure.

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

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also