List-View Window Styles

The following window styles are specific to list-view controls.

ConstantDescription
LVS_ALIGNLEFT

Items are left-aligned in icon and small icon view.

LVS_ALIGNMASK

The control's current alignment.

LVS_ALIGNTOP

Items are aligned with the top of the list-view control in icon and small icon view.

LVS_AUTOARRANGE

Icons are automatically kept arranged in icon and small icon view.

LVS_EDITLABELS

Item text can be edited in place. The parent window must process the LVN_ENDLABELEDIT notification code.

LVS_ICON

This style specifies icon view.

LVS_LIST

This style specifies list view.

LVS_NOCOLUMNHEADER

Column headers are not displayed in report view. By default, columns have headers in report view.

LVS_NOLABELWRAP

Item text is displayed on a single line in icon view. By default, item text may wrap in icon view.

LVS_NOSCROLL

Scrolling is disabled. All items must be within the client area. This style is not compatible with the LVS_LIST or LVS_REPORT styles. See Knowledge Base Article Q137520 for further discussion.

LVS_NOSORTHEADER

Column headers do not work like buttons. This style can be used if clicking a column header in report view does not carry out an action, such as sorting.

LVS_OWNERDATA

Version 4.70. This style specifies a virtual list-view control. For more information about this list control style, see About List-View Controls.

LVS_OWNERDRAWFIXED

The owner window can paint items in report view. The list-view control sends a WM_DRAWITEM message to paint each item; it does not send separate messages for each subitem. The iItemData member of the DRAWITEMSTRUCT structure contains the item data for the specified list-view item.

LVS_REPORT

This style specifies report view. When using the LVS_REPORT style with a list-view control, the first column is always left-aligned. You cannot use LVCFMT_RIGHT to change this alignment. See LVCOLUMN for further information on column alignment.

LVS_SHAREIMAGELISTS

The image list will not be deleted when the control is destroyed. This style enables the use of the same image lists with multiple list-view controls.

LVS_SHOWSELALWAYS

The selection, if any, is always shown, even if the control does not have the focus.

LVS_SINGLESEL

Only one item at a time can be selected. By default, multiple items may be selected.

LVS_SMALLICON

This style specifies small icon view.

LVS_SORTASCENDING

Item indexes are sorted based on item text in ascending order.

LVS_SORTDESCENDING

Item indexes are sorted based on item text in descending order.

LVS_TYPEMASK

Determines the control's current window style.

LVS_TYPESTYLEMASK

Determines the window styles that control item alignment and header appearance and behavior.

Remarks

For the LVS_SORTASCENDING and LVS_SORTDESCENDING styles, item indexes are sorted based on item text in ascending or descending order, respectively. Because the LVS_LIST and LVS_REPORT views display items in the same order as their indexes, the results of sorting are immediately visible to the user. The LVS_ICON and LVS_SMALLICON views do not use item indexes to determine the position of icons. With those views, the results of sorting are not visible to the user.

You can use the LVS_TYPEMASK mask to isolate the window styles that correspond to the current view: LVS_ICON, LVS_LIST, LVS_REPORT, and LVS_SMALLICON.

You can use the LVS_ALIGNMASK mask to isolate the window styles that specify the alignment of items: LVS_ALIGNLEFT and LVS_ALIGNTOP.

You can use the LVS_TYPESTYLEMASK mask to isolate the window styles that control item alignment (LVS_ALIGNLEFT and LVS_ALIGNTOP) and those that control header appearance and behavior (LVS_NOCOLUMNHEADER and LVS_NOSORTHEADER).

Requirements

Header

CommCtrl.h

See also

List-View Styles and Views

 

 

Show: