Place Function

Modified on Fri, Mar 15 at 12:18 PM

!place embedded command

Normally used inside a paragraph command to place block values together separated by other strings or <nextline>.

Syntax

!place Blocks Segment %% Number of Blocks to Apply Separator 1%%Separator 1 Segment %% Separator 2 Segment %% Separator 3 segment place!

!place
		Blocks Segment
	%%	Number of Blocks to Apply Separator 1	Default: 2
	%%	Separator 1	Default: empty
	%%	Separator 2	Default: <nextline>
	%%	Separator 3	Default: does not exist
place!

USING REVERSE NEXTLINE

!place
		Blocks Segment
	%%	Number of Blocks to Apply Separator 1	Default: 2
	%%	Separator 1	Default: empty
	%%	Separator 2	Default: <nextline>
	%%	Separator 3	Default: does not exist
	%%	Reverse or Bottom aligned	Default: does not exist
place!

Block Segment: Any number of Embedded {Blocks} separated by ^^. Example: {Phone 1}^^{Phone 2}^^{Phone 3}

Separator 1: is set to empty if not specified

Separator 2: is set to <nextline> if not specified

Separator 3: if not specified then Separator 2 is used instead. It is usually used to add a different string after the very last Block (with value), or cancel it (by adding the last %% with nothing after it)

%% is the segment separator while ^^ is the Blocks separator.

Example:

!place {Block1}^^{Block2}^^{Block3}%%Blocks Number in a line %%separator1%%separator2 place!

Usage:

Suppose there are four Phone numbers to appear in two lines, the condition is each two should appear in a line but if one is missing then the following one takes its place keeping the separators intact. In addition, a pipe character | is to be used separating the two phones in a line. Suppose that the block names are {Phone} {Fax} {Toll Free} {Mobile}

!place {Phone}^^{Fax}^^{Toll Free}^^{Mobile}%%2%% | %%<nextline> place!

If <nextline> is not required as the very last separator then use:

!place {Phone}^^{Fax}^^{Toll Free}^^{Mobile}%%2%% | %%<nextline>%% place!

Adding a third %% with nothing afterwards will cancel the <nextline>.

!place {Block1}^^{Block2}^^{Block3}%%2%%%% place!

is meaningless and equivalent to {Block1}{Block2}{Block3}

!place {Block1}^^{Block2}^^{Block3}%%2%%%%<nextline> place!

is the same as

!place {Block1}^^{Block2}^^{Block3} place!

More examples below:

EXAMPLE 1

!place {Phone}^^{Direct Line}^^{Fax}^^{Toll Free}^^{Mobile}%%2%% | %%<nextline>%% place!

No of Blocks separated by the first separator

Separator 1

In the above Separator 3 also exists but empty as nothing was entered after the last %% other than the end of command statement place! This technique is used to overwrite Separator 2 after the very last block. If left out, a <nextline> will always print after the last block.

In the above example if all phone numbers exist then it prints the following:

Phone | Direct Line
Fax | Toll Free
Mobile

If {Direct Line} was not entered then

Phone | Fax
Toll Free | Mobile

If {Phone} and {Mobile} have values only then

Phone | Mobile

EXAMPLE 2

!place {Phone}^^{Direct Line}^^{Fax}^^{Toll Free}^^{Mobile}%%3%% - %%<nextline>%% place!

If all phone numbers have values then the following will be printed:

Phone - Direct Line - Fax
Toll Free - Mobile

Prefixes and Postfixes of each block should be added within the block definition. Embedded blocks are recognized inside the separators.

REVERSE or Bottom Aligned Place

IMPORTANT

When using the Reverse parameter (make the block bottom aligned), the third separator must be entered, by default it is the same as Separator 2 but when the fifth parameter is used then the third separator must be entered (duplicate Separator 2 for Default).

!place {Phone}^^{Fax}^^{Cell}%%2%% | %%<nextline>%%%%Bottom aligned place!

is the same as

!place {Phone}^^{Fax}^^{Dell}%%2%% | %%<nextline>%%%% place!

is the same as

!place {Phone}^^{Fax}^^{Cell}%%2%% | %%<nextline>%%%%Reverse place!