OBJECT Is styled text

Home

4D v16.3


OBJECT Is styled text ( {* ;} object ) -> Function result

Parameter	Type	Description
*	Operator	If specified, object is an object name (string) If omitted, object is a field or variable
object	Form object	Object name (if * is specified) or Field or variable (if * is omitted)
Function result	Boolean	True if object is a multi-style text, False otherwise

Description

The OBJECT Is styled text command returns True when the "Multi-style" option is checked for the object(s) designated by the object and * parameters.

The "Multi-style" option lets you use rich test areas including individual style variations. For more information, refer to Multi-style (Rich text area) in the Design Reference manual.

Multi-style objects can be managed by programming using the commands of the "Styled Text" theme.

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

Note: The OBJECT Is styled text command returns True when it is applied to a 4D Write Pro area.

Example

A form contains a field represented by two different objects; one of the objects has the "Multi-style" property checked, and the other one does not. You can write:

 $Style:=OBJECT Is styled text(*;"Styled_text")

  // returns True ("Multi-style" option is checked)

 

 $Style:=OBJECT Is styled text(*;"Plain_text")

  // returns False ("Multi-style" option is not checked)