Share via

CEdit::SetTabStops

  • Article

voidSetTabStops();

BOOLSetTabStops(constint&cxEachStop);

BOOLSetTabStops(intnTabStops**,LPINTrgTabStops);**

Return Value

Nonzero if the tabs were set; otherwise 0.

Parameters

cxEachStop

Specifies that tab stops are to be set at every cxEachStop dialog units.

nTabStops

Specifies the number of tab stops contained in rgTabStops. This number must be greater than 1.

rgTabStops

Points to an array of unsigned integers specifying the tab stops in dialog units. A dialog unit is a horizontal or vertical distance. One horizontal dialog unit is equal to one-fourth of the current dialog base width unit, and 1 vertical dialog unit is equal to one-eighth of the current dialog base height unit. The dialog base units are computed based on the height and width of the current system font. The GetDialogBaseUnits Windows function returns the current dialog base units in pixels.

Remarks

Call this function to set the tab stops in a multiple-line edit control. When text is copied to a multiple-line edit control, any tab character in the text will cause space to be generated up to the next tab stop.

To set tab stops to the default size of 32 dialog units, call the parameterless version of this member function. To set tab stops to a size other than 32, call the version with the cxEachStop parameter. To set tab stops to an array of sizes, use the  version with two parameters.

This member function is only processed by multiple-line edit controls.

SetTabStops does not automatically redraw the edit window. If you change the tab stops for text already in the edit control, call CWnd::InvalidateRect to redraw the edit window.

For more information, see and in the Win32 documentation.

Example

See the example for CEditView::SetTabStops.

CEdit Overview |  Class Members |  Hierarchy Chart

See Also   CWnd::InvalidateRect