Tag Definition: placeXPre

Generated by rlextra version 5.0.0.2

Attributes

Name	Required?	Default_Value	Values
actualText	implied	None	text for screen reader
alignment	implied	None
allowOrphans	implied	None	['yes', 'no', '0', '1', 'true', 'false']
allowWidows	implied	None	['yes', 'no', '0', '1', 'true', 'false']
altText	implied	None	text for screen reader
anchor	implied	None	['nw', 'n', 'ne', 'nwl', 'nl', 'nel', 'nwb', 'nb', 'neb', 'e', 'c', 'w', 'swt', 'st', 'set', 'swl', 'sl', 'sel', 'sw', 's', 'se']
autoLeading	implied	None	['min', 'max', 'off']
backColor	implied	None
borderColor	implied	None
borderPadding	implied	None
borderRadius	implied	None
borderWidth	implied	None
bulletAnchor	implied	None	['start', 'middle', 'end', 'numeric']
bulletColor	implied	None
bulletFontName	implied	None
bulletFontSize	implied	None
bulletIndent	implied	None
bulletOffsetY	implied	None
bulletText	implied	None
drawOnce	implied	None
embeddedHyphenation	implied	None	['yes', 'no', '0', '1', 'true', 'false']
endDots	implied	None
endDotsBackColor	implied	None
endDotsColor	implied	None
endDotsDy	implied	None
endDotsFontName	implied	None
endDotsFontSize	implied	None
firstLineIndent	implied	None
fontName	implied	None
fontSize	implied	None
frameBreakBefore	implied	None
hyphenationLang	implied	None
hyphenationMinWordLength	implied	None
justifyBreaks	implied	None	['yes', 'no', '0', '1', 'true', 'false']
justifyLastLine	implied	None
keepWithNext	implied	None
leading	implied	None
leftIndent	implied	None
origin	implied	None	['page', 'frame', 'local']
pageBreakBefore	implied	None
rightIndent	implied	None
shaping	implied	None	['yes', 'no', '0', '1', 'true', 'false']
spaceAfter	implied	None
spaceBefore	implied	None
spaceShrinkage	implied	None
splitLongWords	implied	None	['yes', 'no', '0', '1', 'true', 'false']
strikeColor	implied	None
strikeOffset	implied	None
strikeWidth	implied	None
style	none	xpre.defaultStyle
tagType	implied	None
textColor	implied	None
textTransform	implied	None	['none', 'lowercase', 'uppercase', 'capitalize']
underlineColor	implied	None
underlineOffset	implied	None
underlineWidth	implied	None
uriWasteReduce	implied	None
width	implied	None
wordWrap	implied	None	['normal', 'CJK', 'RTL']
x	required	None
y	required	None
Can contain (#PCDATA | b | a | u | greek | font | span | sup | super | sub | br | strike | pageNumber | evalString | seq | seqDefault | seqReset | seqFormat | seqChain | img | index | name | getName | i | bullet | unichar | link | setLink | onDraw | nobr | loop_i | switch_i | assign_i | if_i | expr)*

Purpose

This lets you declare a preformatted paragraph of text at a fixed position in the page.

This can be controlled with the x, y, width, origin, anchor, and alignment attributes.

Please note the default styling for pre tags is Code which comes with a base leftIndent of 36.

Example usage

<story>
    <placeXPre x="57" y="230" width="481" borderColor="red" borderWidth="1">Example Text</placeXPre>
</story>

Note: Only relevant sections are used in this snippet. Some tags were not included. See some of our samples for further insight of how you may go about setting up a full document using rml.

Example of nesting path from the parent tags to the current tag

<document> ➔ <story> ➔ <placeXPre>

Advanced usage

drawOnce - avoid overlapping placeXPre making text appear bold

If placeXPre runs repeatedly in the same spot, it can make text appear bolder. To avoid this you can use the drawOnce attribute added in rlextra 4.4.5.1.

e.g. You have a multi-page table and want to draw a footnote on a page dynamically based on the rows of data within that page.

The requirements for using this attribute are:

• drawOnce only has an effect if it's given a non-empty string
• it only works when the placeXPre is at the same x y
• it only works if the origin attribute is set to 'page'

This would likely come up when using preppy to iterate through large amounts of data.

This usage also applies to the placePara tag