4D v16.3

OBJECT Get list reference

Home

 
4D v16.3
OBJECT Get list reference

OBJECT Get list reference 


 

OBJECT Get list reference ( {* ;} object {; listType} ) -> 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)
listType  Longint in Type of list: Choice list, Required list or Excluded list
Function result  ListRef in List reference number

The OBJECT Get list reference command returns the reference number (ListRef) of the hierarchical list associated with the object or group of objects designated by object and *.

Passing the optional * parameter indicates that the object parameter is an object name (string). If you do not pass this parameter, this 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).

By default, if you omit the listType parameter, the command returns the name of the choice list (list of values) associated with the object. You can also get the reference number for required lists or excluded lists by passing, in listType, one of the following constants found in the "Form Objects (Properties)" theme:

Constant Type Value Comment
Choice list Longint 0 Simple list of values to choose from ("Choice List" option in the Property List) (default)
Excluded list Longint 2 Lists values not accepted for entry ("Excluded List" option in the Property List)
Required list Longint 1 Lists only values accepted for entry ("Required List" option in the Property List)

If there is no hierarchical list associated with the object for the listType defined, the command returns 0.



See also 

OBJECT Get list name
OBJECT SET LIST BY REFERENCE

 
PROPERTIES 

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

 
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)