The CISFO:REPLACE2 is very similar to CISFO:TEXTREPLACE2. It outputs variable text in the same way as CISFO:TEXTREPLACE2. The only difference: CISFO:TEXTREPLACE2 represents a piece of text within a text block - CISFO:REPLACE2 itself represents a whole text block.
The most important definition of the TEXTREPLACE2 control is the
definition which Java Property is bound to obtain the text at runtime. The Java
property is part of the data object - the counter part of the page (see
property objectclass of control FOPPAGE2).
For some data types, you can customize the rendering via additional
properties such as decimaldigitsprop and
booleantextprop.
For example, to render the value of a CHECKBOX control as "YES" or "NO", proceed as follows:
In the CISFO:REPLACE2 control, set the property
booleantextprop.
<cisfo:replace2 valueprop="myvalue" booleantextprop="mytextprop" datatype="boolean"></cisfo:replace2>
At runtime, provide a comma-separated list of values for the rendering of the Boolean value in the "mytextprop" field. The values for this example would be "YES;NO".
For example, to render a float value with no decimal digits, proceed as follows:
In the CISFO:REPLACE2 control, set the property
decimaldigitsprop.
<cisfo:replace2 valueprop="myvalue" decimaldigitsprop="mydigitsprop" datatype="float"></cisfo:replace2>
At runtime, provide the number of digits in the "mydigitsprop" field. The value for this example would be "0".
| Basis | |||
| valueprop |
Adapter property that provides the value that is output within the control. |
Obligatory | |
| datatype |
Data type of the output. Some valid values are "date, float, int, time, timestamp". Dependent from the data type the text may be converted before being rendered. Example: If specifying "date" then the output will be transferred from "YYYYMMDD" into a date display dependent format, e.g. "DD.MM.YYYY" or "MM/DD/YYYY". |
Optional |
date float int boolean time timestamp |
| decimaldigitsprop |
Adapter property that passes back information how many decimal digits are to be displayed. Only used with the datat type "float". |
Optional | |
| booleantextprop |
Adapter property that passes back text displayed for "boolean" values. Only use this with the datatype "boolean". The property must provide a string containing the text for "true" and "false" separated by a comma. Example: "Yes |
Optional | |
| stylename |
Name of a CISFO style. The style must exist within the form definition. |
Optional | |
| backgroundcolor |
This attribute sets the background color of an element, either a andlt;colorandgt; value or the keyword "transparent", to make the underlying colors shine through. |
Optional |
#000000 #808080 #FFFFFF #FF0000 |
| columnsspanned |
A positive integer, specifying the number of columns spanned. |
Optional |
2 3 |
| color |
Color in which the element is output. |
Optional |
#000000 #808080 #FFFFFF #FF0000 |
| rowsspanned |
A positive integer, specifying the number of rows taht this cell spans. |
Optional |
2 3 |
| textalign |
The alignment of the text. Valid values are 'center', 'left' or 'right'. |
Optional |
left center right |
| textdecoration |
Different values for printing the text, so as underline, overline or line-through. |
Optional |
overline line-through underline |
| Border | |||
| bordercolor |
Color for all borders (bottom, top, left, right). Values are any valid color specification. |
Optional |
#000000 #808080 #FFFFFF #FF0000 |
| borderstyle |
This attribute specifies the line style of all box's border. Some valid values are "solid", "double" or "dashed". |
Optional |
solid none |
| borderwidth |
The border width attribute specifies the width of all borders. Some valid values are "thin", "medium", "thick" or a concrete size (e.g. "2pt"). |
Optional |
1pt 5pt 1mm 5mm |
| bordertopcolor |
Color for the border on the top. Values are any valid color specification. |
Optional |
#000000 #808080 #FFFFFF #FF0000 |
| bordertopstyle |
This attribute specifies the line style of a box's top border. Some valid values are "solid", "double" or "dashed". |
Optional |
solid none |
| bordertopwidth |
The border width attribute specifies the width of the top border. Some valid values are "thin", "medium", "thick" or a concrete size (e.g. "2pt"). |
Optional |
1pt 5pt 1mm 5mm |
| borderleftcolor |
Color for the border on the left side. Values are any valid color specification. |
Optional |
#000000 #808080 #FFFFFF #FF0000 |
| borderleftstyle |
This attribute specifies the line style of a box's left border. Some valid values are "solid", "double" or "dashed". |
Optional |
solid none |
| borderleftwidth |
The border width attribute specifies the width of the left border. Some valid values are "thin", "medium", "thick" or a concrete size (e.g. "2pt"). |
Optional |
1pt 5pt 1mm 5mm |
| borderbottomcolor |
Color for the border on the bottom. Values are any valid color specification. |
Optional |
#000000 #808080 #FFFFFF #FF0000 |
| borderbottomstyle |
This attribute specifies the line style of a box's bottom border. Valid values are 'solid', 'double' or 'dashed'. |
Optional |
solid none |
| borderbottomwidth |
The border width attribute specifies the width of the bottom border. Valid values are "thin", "medium", "thick" or a concrete size (e.g. "2pt"). |
Optional |
1pt 5pt 1mm 5mm |
| borderrightcolor |
Color for the border on the right side. Values are any valid color specification. |
Optional |
#000000 #808080 #FFFFFF #FF0000 |
| borderrightstyle |
This attribute specifies the line style of a box's right border. Some valid values are "solid", "double" or "dashed". |
Optional |
solid none |
| borderrightwidth |
The border width attribute specifies the width of the right border. Some valid values are "thin", "medium", "thick" or a concrete size (e.g. "2pt"). |
Optional |
1pt 5pt 1mm 5mm |
| Font | |||
| fontfamily |
This attribute specifies a priorized list of font family names and/or generic family names. To deal with the problem that a single font may not contain glyphs to display all the characters in a document, or that not all fonts are available on all systems, this property allows authors to specify a list of fonts, all of the same style and size, that are tried in sequence to see if they contain a glyph for a certain character. This list is called a "font set". |
Optional |
Helvetica Times Courier Symbol ZapfDingbats |
| fontsize |
This attribute describes the size of the font when set as "solid". The font size corresponds to the em square, a concept used in typography. Note that certain glyphs may bleed outside their em squares. Some valid values are "xxsmall", "medium", "smaller" or a concrete size, e.g. "110%". |
Optional |
8pt 10pt 16pt |
| fontstyle |
This attribute requests normal (sometimes referred to as "roman" or "upright"), italic, and oblique faces within a font family. Valid values are "normal", "italic" and "oblique". |
Optional |
normal italic oblique |
| fontvariant |
In a small-caps font, the glyphs for lowercase letters look similar to the uppercase ones, but in a smaller size and with slightly different proportions. The "font-variant" property requests such a font for bicameral (having two cases, as with Roman script). This property has no visible effect for scripts that are unicameral (having only one case, as with most of the world's writing systems). Valid values are "normal" and "small-caps". |
Optional |
normal small-caps |
| fontweight |
This attribute specifies the weight of the font. Some valid values are 'normal', 'bold', 'bolder', 'lighter', '100' or '900', where 'normal' is the same as '400', 'bold' is the same as '700'. |
Optional |
normal bold 100 200 300 400 500 600 700 800 900 |
| Margin | |||
| margin |
Sets the margin of a box. Negative values for margin properties are allowed, but there may be implementation-specific limits. |
Optional |
1pt 5pt 1mm 5mm |
| margintop |
Sets the top margin of a box. Negative values for margin properties are allowed, but there may be implementation-specific limits. |
Optional |
1pt 5pt 1mm 5mm |
| marginleft |
Sets the left margin of a box. Negative values for margin properties are allowed, but there may be implementation-specific limits. |
Optional |
1pt 5pt 1mm 5mm |
| marginbottom |
Sets the bottom margin of a box. Negative values for margin properties are allowed, but there may be implementation-specific limits. |
Optional |
1pt 5pt 1mm 5mm |
| marginright |
Sets the right margin of a box. Negative values for margin properties are allowed, but there may be implementation-specific limits. |
Optional |
1pt 5pt 1mm 5mm |
| Padding | |||
| padding |
Specifies the width of the padding of a block-area or inline-area. Unlike margin properties, values for padding properties cannot be negative. |
Optional |
1pt 5pt 1mm 5mm |
| paddingtop |
Specifies the width of the padding on the top of a block-area or inline-area. Unlike margin properties, values for padding properties cannot be negative. |
Optional |
1pt 5pt 1mm 5mm |
| paddingleft |
Specifies the width of the padding on the left of a block-area or inline-area. Unlike margin properties, values for padding properties cannot be negative. |
Optional |
1pt 5pt 1mm 5mm |
| paddingbottom |
Specifies the width of the padding on the bottom of a block-area or inline-area. Unlike margin properties, values for padding properties cannot be negative. |
Optional |
1pt 5pt 1mm 5mm |
| paddingright |
Specifies the width of the padding on the right of a block-area or inline-area. Unlike margin properties, values for padding properties cannot be negative. |
Optional |
1pt 5pt 1mm 5mm |