Method XbpListBox():setTabstops() Foundation

Sets the tab stops of the listbox.

Syntax
:setTabstops( <anTabstops> ) --> lSuccess
Parameters
<anTabstops>
<anTabstops> is a one dimensional array of numeric values specifying the tab stop positions for a listbox object. The values for tab stops are measured in quarters of the average character width of the listbox object.
Return

This method returns the value .T. (true) if the tab stops array could be set, otherwise it returns .F. (false).

Description

The :setTabstops() method sets the tab stop positions of the listbox object. When items are added to a listbox, they may be separated by tab stop characters (Chr(9)). The values for tab stops are measured in quarters of the average character width of the listbox object. This unit depends on the size of the font set for the listbox object and corresponds with the value stored in the instance variable :width of an XbpFont() object.

The following code shows how the listbox items may be separated with tab stops:

oListbox:addItem( "Col1" + Chr(9) + "Col2" + Chr(9) + "Col3" ) 

An empty array passed as <anTabstops> resets the tab stops to their default values.

If an array with only one element is passed, the single numeric value in this element is used to define the distance between adjacent tab stops. This leads to the same width for all columns displayed by the XbpListbox object.

The method :setTabStops() is not supported for the listbox part of an XbpCombobox object.

Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.