Version 8.3.3
 —  PDF and FOP Services  —

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

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

Top of page