4D v16.3

OBJECT Get multiline

Home

 
4D v16.3
OBJECT Get multiline

OBJECT Get multiline 


 

OBJECT Get multiline ( {* ;} object ) -> Function result 
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)
Function result  Longint in Multiline status of object

The OBJECT Get multiline command returns the current state of the "Multiline" option for the object(s) designated by the object and * parameters.

You can set the "Multiline" option for an object using the Property List, or using the OBJECT SET MULTILINE command option. 

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

The value returned corresponds to one of the following constants, found in the "Form Objects (Properties)" theme:

Constant Type Value Comment
Multiline Auto Longint 0 In single-line areas, words located at the end of lines are truncated and there are no line returns.
In multiline areas, 4D carries out automatic line returns.
Multiline No Longint 2 There are never line returns: the text is always displayed on a single row. If the Alpha or Text field or variable contains carriage returns, the text located after the first carriage return is removed as soon as the area is modified.
Multiline Yes Longint 1 In single-line areas, the text is displayed up to the first carriage return or until the last word that can be displayed entirely. 4D inserts line returns; it is possible to scroll the contents of the area by pressing the down arrow key.
In multiline areas, 4D carries out automatic line returns.

Note: If you apply the OBJECT Get multiline command to an object that does not support the "Multiline" option, the command returns 0.



See also 

OBJECT SET MULTILINE

 
PROPERTIES 

Product: 4D
Theme: Objects (Forms)
Number: 1254

 
HISTORY 

Created: 4D v14

 
ARTICLE USAGE

4D Language Reference ( 4D v16)
4D Language Reference ( 4D v16.1)
4D Language Reference ( 4D v16.2)
4D Language Reference ( 4D v16.3)