4D Doc Center : WR ADD TAB

Home

4D Write v14

WR ADD TAB


WR ADD TAB ( area ; position ; justification ; fillCharacter )

Parameter	Type	Description
area	Longint	4D Write area
position	Longint	Tab location
justification	Integer	Justification value
fillCharacter	Alpha	Selected fill character

Description

The WR ADD TAB command allows you to add a new tab at the location passed in position, measured from the left margin of the document. It also allows you to to define the fill character and the justification of the new tab stop.

This tab stop will be added to all the paragraphs of the selection. If a tab stop already exist at this location, it will be replaced by the one you just created.

position is the distance from the left margin (expressed in the document's default unit).

The justification optional parameter determines the tab stop type. You can use the following constants, found in the “WR Tabs” theme:

Constant	Type	Value	Comment
wr left tab	Longint	1	Left aligned
wr centered tab	Longint	2	Centered
wr right tab	Longint	3	Right aligned
wr decimal tab	Longint	4	Decimal
wr vertical separator tab	Longint	5	Vertical separator

If justification is omitted, a left aligned tab is created.

The fillCharacter optional parameter can be any character whose code is between 33 and 127. This character will be added using the same font as the tab stop.

If fillCharacter is omitted or if you pass an empty string, no fill character will be inserted.

Example

The following example create a left tab stop, 50 units away from the left margin with a dot as fill character.

WR ADD TAB(area;50;wr left tab;".")