4D Doc Center : OBJECT SET STYLED TEXT

4D v12.4

OBJECT SET STYLED TEXT


OBJECT SET STYLED TEXT ( {* ;} object ; newText {; startSel {; endSel}} )

Parameter	Type	Description
*	Operator	If specified, object is an object name (string) If omitted, object is a variable or a field
object	Form object	Object name (if * is specified) or Text field or variable (if * is omitted)
newText	Text	Text to insert
startSel	Longint	Start of selection
endSel	Longint	End of selection

Description

The OBJECT SET STYLED TEXT command inserts the text passed in the newText parameter into the styled text field or variable designated by the object parameter. This command only applies to the plain text of the object parameter, without modifying any style tags that it contains. It can be used to modify, by programming, styled text displayed on screen.

If you pass the optional * parameter, you indicate that the object parameter is an object name (string). If you do not pass this parameter, you indicate that the object parameter is a field or a variable. In this case, you pass a field or variable reference instead of a string.

In newText, pass the text to be inserted. The OBJECT SET STYLED TEXT command is intended for working with rich text (multistyle) containing <span> type tags. In all other cases (more particularly, when working with plain text that contains the <, > or & characters), you must use the OBJECT SET PLAIN TEXT command. If you pass plain text containing the <, > or & characters to the OBJECT SET STYLED TEXT command, it does nothing. This is necessary behavior because if you insert a string such as "a>b" directly into rich text, it will distort the internal analysis of the <span> tags. In this case, "<" characters must be encoded beforehand as "<", which can be done using the OBJECT SET PLAIN TEXT command (see also the example of this command).

The optional startSel and endSel parameters let you designate a selection of text in object. The startSel and endSel values give a selection of plain text, without taking any style tags found in the text into account. The action of the command varies according to the optional startSel and endSel parameters:

If you omit startSel and endSel, OBJECT SET STYLED TEXT replaces all the text of the object by newText,
If you only pass startSel or if the values of startSel and endSel are equal, OBJECT SET STYLED TEXT inserts the newText text into object beginning at startSel,
If you pass both startSel and endSel, OBJECT SET STYLED TEXT replaces the plain text set by these limits with the newText text.

If startSel is greater than endSel, the text is not modified and the OK variable is set to 0.

Example 1

You want to replace the styled text selected by the user with the contents of a variable.

Here is the selected text:

The following contents are stored in the field:

After executing this code:

 vtempo:="Demonstration"

 GET HIGHLIGHT([Products]Notes;vStart;vEnd)

 OBJECT SET STYLED TEXT([Products]Notes;vtemp;vStart;vEnd)

The field and its contents are as follows:

Example 2

Refer to the example of the OBJECT SET PLAIN TEXT command.

System variables and sets

After this command is executed, the OK variable is set to 1 if no error occurred; otherwise, it is set to 0. This is the case more particularly when style tags are not evaluated properly (incorrect or missing tags).

In the case of an error, the variable is not changed. When an error occurs on a variable when text is being evaluated, 4D transforms the text into plain text; as a result, the <, > and & characters are converted into HTML entities.