• Reference Guide


add_pformat(rtxt, rpf)
add_pformat(rtxt, par, rpf)
rtxt_var <- add_pformat(rpf)
rtxt_var <- add_pformat(par, rpf)
The functions set the rpf paragraph format to one or all paragraphs of a text. The value of format attributes unspecified by the parameter rpf remain unchanged (i.e. the function merges the format rpf to the original format of the paragraph). The first two versions of the function return the modified text, while the parameter rtxt is retained unchanged. The other two variants take a variable or data item rtxt_var, which they modify in place. If the parameter par is specified, it contains the index of the paragraph to be changed. In that case, only the format of the specified paragraph is altered. If the paragraph index is not specified, all the paragraphs in the text are affected.
rtxt <- add_pformat(0, rpf_align(ALIGN_CENTER) |
The example centers the first paragraph and forces it to be placed on the same page with the next paragraph.


The text in which the format is to be set (the type Rich_text).
The variable (an l-value of the type Rich_text), containing the text in which the format is to be set.
The index of the paragraph in which the format is to be set. The paragraphs are indexed from 0. If the index is negative or beyond the end of the text, an error is returned.
The paragraph format to be set (the type Rich_text).

Return Value

The first two versions return the modified text (Rich_text). The other return the l-value referring to the variable containing the modified text.

See Also