List-View Window Styles

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

Constant Description
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

Requirement Value
Header
CommCtrl.h

See also

List-View Styles and Views