Edit

LVTILEVIEWINFO structure (commctrl.h)

  • Article

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