LVTILEVIEWINFO structure (commctrl.h)

Provides information about a list-view control when it is displayed in tile view.

Syntax

typedef struct tagLVTILEVIEWINFO {
  UINT  cbSize;
  DWORD dwMask;
  DWORD dwFlags;
  SIZE  sizeTile;
  int   cLines;
  RECT  rcLabelMargin;
} LVTILEVIEWINFO, *PLVTILEVIEWINFO;

Members

cbSize

Type: UINT

Size of the LVTILEVIEWINFO structure.

dwMask

Type: DWORD

Mask that determines which members are valid. This member may be one of the following values.

Value	Meaning
LVTVIM_TILESIZE	sizeTile is valid.
LVTVIM_COLUMNS	cLines is valid.
LVTVIM_LABELMARGIN	rcLabelMargin is valid.

dwFlags

Type: DWORD

Flags that determines how the tiles are sized in tile view. This member may be one of the following values.

Value	Meaning
LVTVIF_AUTOSIZE	Size the tiles automatically.
LVTVIF_EXTENDED	This flag is not supported and should not be used.
LVTVIF_FIXEDWIDTH	Apply a fixed width to the tiles.
LVTVIF_FIXEDHEIGHT	Apply a fixed height to the tiles.
LVTVIF_FIXEDSIZE	Apply a fixed height and width to the tiles.

sizeTile

Type: SIZE

Size of an individual tile. Values for dimensions not specified as fixed in dwFlags are ignored.

cLines

Type: int

Maximum number of text lines in each item label, not counting the title.

rcLabelMargin

Type: RECT

RECT that contains coordinates of the label margin.

Remarks

By default, the dimensions of tiles are determined automatically. To apply a fixed size, supply the correct value or values in sizeTile and set the appropriate flag in dwFlags. Allow enough vertical space for all lines of the label to be displayed. If a line does not fit in the allowed horizontal space, it is terminated with an ellipsis.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	commctrl.h

See also

Conceptual

ListView_GetTileViewInfo

ListView_SetTileViewInfo

Reference

Using List-View Controls