4D v13.4
OBJECT Get plain text
- 4D Language Reference
-
- Object Properties
-
- Object Properties
- DISABLE BUTTON
- ENABLE BUTTON
- OBJECT DUPLICATE
- OBJECT Get auto spellcheckNew
- OBJECT GET BEST SIZE
- OBJECT Get choice list name
- OBJECT GET COORDINATES
- OBJECT GET DRAG AND DROP OPTIONSNew
- OBJECT Get enabled
- OBJECT Get enterable
- OBJECT Get filter
- OBJECT Get focus rectangle invisibleNew
- OBJECT Get font
- OBJECT Get font size
- OBJECT Get font style
- OBJECT Get format
- OBJECT Get help tipNew
- OBJECT Get horizontal alignment
- OBJECT Get keyboard layoutNew
- OBJECT Get plain text
- OBJECT GET RESIZING OPTIONSNew
- OBJECT GET RGB COLORS
- OBJECT GET SCROLL POSITION
- OBJECT GET SCROLLBAR
- OBJECT GET SHORTCUTNew
- OBJECT Get styled text
- OBJECT GET STYLED TEXT ATTRIBUTES
- OBJECT GET SUBFORM CONTAINER SIZENew
- OBJECT GET SUBFORMNew
- OBJECT Get title
- OBJECT Get vertical alignmentNew
- OBJECT Get visible
- OBJECT MOVE
- OBJECT SET AUTO SPELLCHECKNew
- OBJECT SET CHOICE LIST NAME
- OBJECT SET COLOR
- OBJECT SET DRAG AND DROP OPTIONSNew
- OBJECT SET ENABLED
- OBJECT SET ENTERABLE
- OBJECT SET FILTER
- OBJECT SET FOCUS RECTANGLE INVISIBLENew
- OBJECT SET FONT
- OBJECT SET FONT SIZE
- OBJECT SET FONT STYLE
- OBJECT SET FORMAT
- OBJECT SET HELP TIPNew
- OBJECT SET HORIZONTAL ALIGNMENT
- OBJECT SET KEYBOARD LAYOUTNew
- OBJECT SET PLAIN TEXT
- OBJECT SET RESIZING OPTIONSNew
- OBJECT SET RGB COLORS
- OBJECT SET SCROLL POSITION
- OBJECT SET SCROLLBAR
- OBJECT SET SHORTCUTNew
- OBJECT SET STYLED TEXT
- OBJECT SET STYLED TEXT ATTRIBUTES
- OBJECT SET SUBFORMNew
- OBJECT SET TITLE
- OBJECT SET VERTICAL ALIGNMENTNew
- OBJECT SET VISIBLE
OBJECT Get plain text
| OBJECT Get plain text ( {* ;} object ) -> Function result | ||||||||
| 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 Variable or field (if * is omitted) | |||||
| Function result | Text |
|
Text without tags | |||||
The OBJECT Get plain text command removes any style tags from the text variable or field designated by the * and object parameters and returns the plain text.
If you pass the optional * parameter, this indicates that the object parameter is an object name (string). During execution, if the object has the focus, the command returns information about the object being edited; however, when the object does not have the focus, the command returns information about the data source (field or variable) of the object.
If you omit the * parameter, this indicates that the object parameter is a field or a variable. In this case, you pass a field or variable reference instead of a string and during execution, the command returns information about this field or variable.
You are looking for the text "very nice" among the values of a multistyle text field. The value was stored in the following form: "The weather is very nice today".
QUERY BY FORMULA([Comments];OBJECT Get plain text([Comments]Weather)="@very nice@")
Note: In this context, the following statement will not give the desired result because the text is saved with style tags:
QUERY([Comments];[Comments]Weather="@very nice@")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.
Product: 4D
Theme: Object Properties
Number:
1092
Created: 4D v12
Modified: 4D v12.1
OBJECT Get styled text
OBJECT SET PLAIN TEXT
OBJECT SET STYLED TEXT
TEXT TO ARRAY
multi-style, multistyle, multi style***
