4D v14.3

ST SET OPTIONS

Home

 
4D v14.3
ST SET OPTIONS

ST SET OPTIONS 


 

ST SET OPTIONS ( {* ;} object ; option ; value {; option2 ; value2 ; ... ; optionN ; valueN} ) 
Parameter Type   Description
Operator in If specified, object is an object name (string) If omitted, object is a field or variable
object  Form object in Object name (if * is specified) or Field or variable (if * is omitted)
option  Longint in Option to set
value  Longint in New value of option

The ST SET OPTIONS command modifies one or more operating options for the styled text field or variable designated by the object parameter.

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).

Pass the code of the option to modify in option and its new value in value. For both of these parameters, you can use the following constants from the "Multistyle Text" theme:

Constant Type Value Comment
ST Expressions display mode Longint 1 The value parameter can contain:
  • ST Values: displays computed values of expressions (default)
  • ST References: displays source strings of expressions
ST References Longint 1 Display source strings of expressions
ST Values Longint 0 Display computed values of expressions

Display of values:

Display of expressions:

Example  

The following code lets you switch the display mode of the area:

 ST GET OPTIONS(*;"StyledText_t";ST Expressions display mode;$exprValue)
 If($exprValue=1)
    ST SET OPTIONS(*;"StyledText_t";ST Expressions display mode;ST Values)
 Else
    ST SET OPTIONS(*;"StyledText_t";ST Expressions display mode;ST References)
 End if

 
PROPERTIES 

Product: 4D
Theme: Styled Text
Number: 1289

 
HISTORY 

New
Created: 4D v14

 
SEE ALSO 

ST GET OPTIONS

 
ARTICLE USAGE

4D Language Reference ( 4D v14 R2)
4D Language Reference ( 4D v14 R3)
4D Language Reference ( 4D v14.3)
4D Language Reference ( 4D v14 R4)