LISTVIEW Control Styles



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


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


Icons are automatically kept arranged.


Item text can be edited by the user.  The parent window must process notification messages.


This style specifies icon view.


This style specifies list view.


In report view, there are no headers on the columns.


Item text is displayed on a single line in icon view.


No scroll bars are provided.  Incompatible with list view and report view.


Report view column headers are flat, not like buttons.  User can not click on the header to generate a column click notification.


Creates a virtual listview control.


The owner window can paint items in report view.


This style specifies report view. The first column is always left-aligned and columns have headers.


The image list will not be deleted when the control is destroyed.


Selections are always shown, even without the focus.


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


This style specifies small icon view.


Item indexes are sorted as added in ascending order.


Item indexes are sorted as added in descending order.


Create a control that is initially disabled. A disabled control cannot receive input from the user.


Define the start of a group of controls. The first control in each group should also use %WS_TABSTOP style. The next %WS_GROUP control in the tab order defines the end of this group and the start of a new group. Groups configured this way permit the arrow keys to shift focus between the controls within the group, and focus can jump from group to groups with the usual TAB and SHIFT+TAB keys. Both tab stops and groups are permitted to wrap from the end of the tab order back to the start.


Allow the list box control to receive keyboard focus when the user presses the TAB and SHIFT+TAB keys. The TAB key shifts keyboard focus to the next control with the %WS_TABSTOP style, and SHIFT+TAB shifts focus to the previous control with %WS_TABSTOP. (default)


Add a thin line border around the control.


Extended Styles


Apply a sunken edge border to the control.


The control has generic "left-aligned" properties. (default)


The control has generic "right-aligned" properties. This style has an effect only if the shell language is Hebrew, Arabic, or another language that supports reading order alignment.


Controls/windows beneath the dialog are drawn before the dialog is drawn. The dialog is deemed transparent because elements behind the dialog have already been painted - the dialog itself is not drawn differently. True transparency is achieved by using Regions - see MSDN and/or the Platform SDK documentation for more information.


Apply a raised edge border to the control.


See Also

Styles reference


LISTVIEW statement