4D v16.3

LISTBOX GET ARRAYS

Home

 
4D v16.3
LISTBOX GET ARRAYS

LISTBOX GET ARRAYS 


 

LISTBOX GET ARRAYS ( {* ;} object ; arrColNames ; arrHeaderNames ; arrColVars ; arrHeaderVars ; arrColsVisible ; arrStyles {; arrFooterNames ; arrFooterVars} )  
Parameter Type   Description
Operator in If specified, object is an object name (string) If omitted, object is a variable
object  Form object in Object name (if * is specified) or Variable (if * is omitted)
arrColNames  String array in Column object names
arrHeaderNames  String array in Header object names
arrColVars  Pointer array in Pointers to column variables or Pointers to column fields or Nil
arrHeaderVars  Pointer array in Pointers to header variables
arrColsVisible  Boolean array in Visibility of each column
arrStyles  Pointer array in Pointers to arrays, or style, color and row control variables, or Nil
arrFooterNames  String array in Column footer object names
arrFooterVars  Pointer array in Pointers to column footer variables

The LISTBOX GET ARRAYS command returns a set of synchronized arrays providing information on each column (visible or invisible) in the list box set in the object and * parameters.

If you pass the optional * parameter, you indicate that the object parameter is an object name (string). If you do not pass this parameter, you indicate that the object parameter is a variable. In this case, you pass a variable reference instead of a string. For more information about object names, refer to the Object Properties section.

Once the command is executed:

  • The arrColNames array contains the list of object names for each column in the list box.
  • The arrHeaderNames array contains the list of object names for each column header in the list box.
  • The arrColVars array contains, for an array type list box, pointers toward variables (arrays) associated with each column of the list box. For a selection type list box, arrColVars contains:
    • For a column associated with a field, a pointer to the associated field,
    • For a column associated with a variable, a pointer to the variable,
    • For a column associated with an expression, a Nil pointer.
  • The arrHeaderVars array contains pointers toward variables associated with each column header of the list box.
  • The arrColsVisible array contains a Boolean value for each column, indicating whether the column is visible (True) or hidden (False) in the list box.
  • The arrStyles array contains, for an array type list box, four pointers to four arrays that allow the applying of a specific style, font color, background color and custom display control to each row of the list box. These arrays are associated with the list box in the Property List of the Design environment or using the LISTBOX SET ARRAY command. If an array is not specified for the list box, the corresponding item in arrStyles will contain a Nil pointer.
    The fourth pointer corresponds either to a Boolean array (Hidden Rows Array), or to a longint array (array used to set hidden, disabled and non-selectable rows) based on the implementation used for the row control array (see List box specific properties).
    For a selection type list box, arrStyles contains:
    • For each configuration set via a variable, a pointer to the variable,
    • For each configuration set via an expression, a Nil pointer.



See also 

LISTBOX Get array
LISTBOX Get information
LISTBOX SET ARRAY

 
PROPERTIES 

Product: 4D
Theme: List Box
Number: 832

 
HISTORY 

Modified: 4D v11 SQL Release 2
Renamed: 4D v12
Modified: 4D v13
Modified: 4D v15 R4

 
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)