List Box Styles

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The following table shows the styles that are supported by Windows Embedded CE.

List box style Description

LBS_DISABLENOSCROLL

Shows a disabled vertical scroll bar for the list box when the box does not contain enough items to scroll. If you do not specify this style, the scroll bar is hidden when the list box does not contain enough items.

LBS_EXTENDEDSEL

Enables the user to select multiple items by using the SHIFT key and the mouse or hot keys.

LBS_HASSTRINGS

Specifies that a list box contains items consisting of strings. The list box maintains the memory and addresses for the strings so that the application can use the LB_GETTEXT message to retrieve the text for a particular item. By default, all list boxes except owner-drawn list boxes have this style. You can create an owner-drawn list box either with or without this style.

LBS_MULTICOLUMN

Specifies a multicolumn list box that the user scrolls through horizontally. You set the width of the columns by using the LB_SETCOLUMNWIDTH message.

LBS_MULTIPLESEL

Turns string selection on or off each time a user taps or double-taps a string in the list box. A user can select any number of strings simultaneously.

LBS_NOINTEGRALHEIGHT

Specifies that the list box will be exactly the size specified by the application when it created the list box. Usually, Windows Embedded CE sizes a list box so that it does not display partial items.

LBS_NOREDRAW

Ensures that the list box appearance is not automatically updated when changes are made. You can change this style by sending a WM_SETREDRAW message.

LBS_NOSEL

Specifies that the user can view list box strings but cannot select them.

LBS_NOTIFY

Notifies the parent window when the user taps or double-taps a string in the list box.

LBS_OWNERDRAWFIXED

Specifies that the owner of the list box is responsible for drawing its contents and that the items in the list box are the same height. The owner window receives a WM_MEASUREITEM message when the list box is created and a WM_DRAWITEM message when a visual aspect of the list box has changed.

LBS_OWNERDRAWVARIABLE

Specifies that the owner of the list box is responsible for drawing its contents and that the items in the list box are variable in height. The owner window receives a WM_MEASUREITEM message for each item in the list box when the list box is created and a WM_DRAWITEM message when a visual aspect of the list box has changed.

LBS_SORT

Sorts strings in the list box alphabetically.

LBS_STANDARD

Sorts strings in the list box alphabetically. The parent window receives an input message when the user taps or double-taps a string. The list box has borders on all sides.

LBS_USETABSTOPS

Enables a list box to recognize and expand tab characters when drawing its strings. The default tab positions are 32 dialog box units. A dialog box unit is equal to one-fourth of the current dialog box base-width unit. Windows Embedded CE calculates these units based on the height and width of the current system font.

LBS_WANTKEYBOARDINPUT

Specifies that the owner of the list box receives WM_VKEYTOITEM messages when the user presses a key and the list box has the input focus. This enables an application to perform special processing on the keyboard input.

WS_TABSTOP

Turns the control into a tab stop, which enables the user to select the control by tabbing through the controls in a dialog box.

See Also

Reference

List Boxes Reference

Concepts

Control Styles
Window and Message Box Styles