EM_SETTABSTOPS

Version 3.0

This message sets the tab-stop positions in a multiline edit control.

Parameter

Description

 

wParam

Is an integer that specifies the number of tab stops in the edit control.

 

lParam

Is a long pointer to the first member of an array of integers containing the tab stop positions in dialog units. (A dialog unit is a horizontal or vertical distance. One horizontal dialog unit is equal to 1/4 of the current dialog base width unit. The dialog base units are computed based on the height and width of the current system font. The GetDialogBaseUnits function returns the current dialog base units in pixels.) The tab stops must be sorted in increasing order; back tabs are not allowed.

 

Return Value

The return value is TRUE if all the tabs were set. Otherwise, the return value is FALSE.

Comments

If wParam is zero and lParam is NULL, the default tab stops are set at every 32 dialog units.

If wParam is 1, the edit control will have tab stops separated by the distance specified by lParam.

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