<replace> tag
The <replace> tag specifies the text replacement values in a project.
The attributes of the <replace> tag are:
- caseSensitive
- Specifies whether the case of text replacement values must match
before text replacement occurs. Valid values are
true
andfalse
. The default isfalse
. - from
- Specifies the text you want to replace. The text on the from attribute must be enclosed in quotes.
- to
- When replacing text with text or HTML coding (Web only), specifies the replacement string you want to insert in place of the value specified on the from attribute. The replacement string on the to attribute must be enclosed in quotes. If you want to replace the text with a button or a link, the code for the button or link must be added inside the quotes.
- regularExpression
- Specifies whether Java™ regular
expression support is used as part of the text replacement algorithm.
A regular expression is a pattern of characters that describes a set
of strings. You can use regular expressions to find and modify occurrences
of a pattern. Valid values are
true
andfalse
. The default isfalse
. - toImage
- When replacing text with an image, specifies the path and name of the image you want to insert in place of the value specified on the from attribute. The path and name of the image on the toImage attribute must be enclosed in quotes.
- matchLTR
- When using a bidirectional code page, specifies whether the
value specified on the from attribute
is replaced on left-to-right screens. Valid values are
true
andfalse
. The default istrue
. - matchRTL
- When using a bidirectional code page, specifies whether the
value specified on the from attribute
is replaced on right-to-left screens. Valid values are
true
andfalse
. The default isfalse
. - matchReverse
- When using a bidirectional code page, specifies whether the
value specified on the from attribute
is replaced when the section of the screen in which it appears has
been reversed from the original direction of the page. Valid values
are
true
andfalse
. The default isfalse
.
Note: Care should be taken when using text replacement.
Text replacement with a disparate number of characters in the strings
can cause changes in the representation of the screen. Depending on
the widget used for presenting a region of a screen, text on a line
of the screen can be contracted, expanded, or forced to a new line.