CISFO:REPLACE2

#### Search Results

Search

# CISFO:REPLACE2

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:

1. In the CISFO:REPLACE2 control, set the property `booleantextprop`.

       <cisfo:replace2 valueprop="myvalue" booleantextprop="mytextprop"
        datatype="boolean"></cisfo:replace2>

2. 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:

1. In the CISFO:REPLACE2 control, set the property `decimaldigitsprop`.

       <cisfo:replace2 valueprop="myvalue" decimaldigitsprop="mydigitsprop"
        datatype="float"></cisfo:replace2>

2. At runtime, provide the number of digits in the "mydigitsprop" field. The value for this example would be "0".

## Properties

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
whitespacepreserve | If set to true, white spaces like blanks and line breaks are preserved. If you want tabs to be replaced with more than one blank, also set the property tabspaces correspondingly. | Optional | true false
tabspaces | Set this property if you want to customize the number of blanks used for tabs in controls with whitespacepreserve=true. | Optional | 1 2 4 8
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