CharPlacement

<< Click to Display Table of Contents >>

Navigation:  Text Functions >

CharPlacement

Previous pageReturn to chapter overviewNext page

[Professional Edition and above]

Allows to specify a constant offset from one character cell to another for text objects (not RTF). This is very useful for filling in forms that have pre-printed columns for each letter. The provided offset is understood as a "character cell width", VPE will print each character centered within this "cell".

property VpeCoord VPE.CharPlacement

write; runtime only

Possible Values:

the distance from one character cell to the next

Default:

0 (= no character placement)

Remarks:

When using CharPlacement, the TextAlignment must be either ALIGN_LEFT or ALIGN_RIGHT.

Example:

Doc.CharPlacement = 0.5

Doc.Print(1, 1, "123")

VPE will generate for each character in the given string internally a cell of 5 mm width. Each number of the string "123" will be printed centered within a cell. The first cell will be placed with the "1" at x-position 1.0 (1cm from the left paper margin), "2" at x-position 1.5 and "3" at x-position 2.0.