LB_SETTABSTOPS

This message is sent by an application to set the tab-stop positions in a list box.

LB_SETTABSTOPS wParam = (WPARAM) cTabs; 
lParam = (LPARAM)(LPINT) lpnTabs;

Parameters

  • cTabs
    Specifies the number of tab stops in the list box.
  • lpnTabs
    Long pointer to the first member of an array of integers containing the tab stops, in dialog template units. The tab stops must be sorted in ascending order; backward tabs are not allowed.

Return Values

TRUE indicates that all the specified tabs are set. FALSE indicates otherwise.

Remarks

To respond to the LB_SETTABSTOPS message, the list box must have been created with the LBS_USETABSTOPS style.

If cTabs parameter is 0 and lpnTabs is NULL, the default tab stop is two dialog template units. If cTabs is 1, the list box will have tab stops separated by the distance specified by lpnTabs.

If lpnTabs points to more than a single value, a tab stop will be set for each value in lpnTabs, up to the number specified by cTabs.

The values specified by the lpnTabs parameter are in dialog template units, which are the device-independent units used in dialog box templates. To convert measurements from dialog template units to screen units (pixels), use the MapDialogRect function.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Winuser.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

GetDialogBaseUnits, MapDialogRect

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.