LISTBOX control styles

Styles

%LBS_DISABLENOSCROLL

Show a disabled vertical scroll bar in the list box when the box does not contain enough items to scroll. Without this style, the scroll bar is hidden when the list box does not contain enough items. Used in conjunction with the %WS_VSCROLL style.

%LBS_EXTENDEDSEL

Allow selection of multiple items in the list box by using the SHIFT key with mouse and/or keyboard actions.

%LBS_MULTICOLUMN

List box has multiple columns, and can be scrolled horizontally. To set the width, send the %LB_SETCOLUMNWIDTH message to the list box control.

%LBS_MULTIPLESEL

Allow selection of multiple items in the list box (without needing to use the SHIFT key) with mouse and/or keyboard actions.

%LBS_NOINTEGRALHEIGHT

Force the size of the list box to be exactly the size specified when the control is created. Otherwise, Windows may resize the list box to ensure that items are not partially displayed (clipped).

%LBS_NOSEL

The list box can contain items that can be viewed but not selected.

%LBS_NOTIFY

Send the parent dialog callback (or control callback) a notification message whenever the user clicks or double-clicks a string in the list box.

%LBS_SORT

Automatically sort strings added to the list box in alphanumeric order.

%LBS_STANDARD

Equivalent to the combination of %LBS_SORT, %LBS_NOTIFY, %WS_VSCROLL and %WS_BORDER styles

%LBS_USETABSTOPS

Expand tab ($TAB, CHR$(9)) characters. The default tab positions are for every 32 dialog units. To change the tab stop positions, send the %LB_SETTABSTOPS message to the list box control.

%WS_DISABLED

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

%WS_HSCROLL

Allow the control to display a horizontal scroll bar. By default this is disabled unless the controls horizontal scroll width has been configured by sending a %LB_SETHORIZONTALEXTENT message to the control. Use in conjunction with %LBS_DISABLENOSCROLL to make the scroll bar(s) visible at all times.

%WS_GROUP

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.

%WS_TABSTOP

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)

%WS_VSCROLL

Allow the control to display a vertical scroll bar if the list is longer than the height of the list box. Use in conjunction with %LBS_DISABLENOSCROLL to make the scroll bar(s) visible at all times.

 

Extended Styles

%WS_EX_CLIENTEDGE

Apply a sunken edge border to the control.

%WS_EX_LEFT

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

%WS_EX_RIGHT

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.

%WS_EX_STATICEDGE

Apply a three-dimensional border style to the control (intended to be used for items that do not accept user input).

%WS_EX_TRANSPARENT

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.

%WS_EX_WINDOWEDGE

Apply a raised edge border to the control.

 

See Also

Styles reference

CONTROL ADD LISTBOX

LISTBOX statement