4D v14.3

LISTBOX SET ARRAY

Home

 
4D v14.3
LISTBOX SET ARRAY

LISTBOX SET ARRAY 


 

LISTBOX SET ARRAY ( {* ;} object ; arrType ; arrPtr ) 
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)
arrType  Longint in Type of array
arrPtr  Pointer in Array to associate with property

Note: This command only works with array type list boxes.

The LISTBOX SET ARRAY command associates a style or color array with the list box or list box column designated by the object and * parameters.

Note: Arrays of styles, colors or background colors can also be associated with array type list boxes using the Property list in the Design mode. 

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 variable. In this case, you pass a variable reference instead of a string. You can designate a list box or a list box column in the object parameter.

In arrType, pass the type of array to associate with the list box or column. You can use one of the following constants, available in the "List Box" theme:

Constant Type Value
Listbox background color array Longint 1
Listbox font color array Longint 0
Listbox style array Longint 2

In the arrPtr parameter, you pass a pointer to the array to use to support the property type (font color, background color or font style).

Example  

You want to reuse the font color array of the 4th column for the 10th column:

  // retrieve a pointer to the array for column 4
 $Pointer:=LISTBOX Get array(*;"Col4";Listbox font color array)
  // check that it exists
 If(Not(Nil($Pointer)))
  //transfer to column 10
    LISTBOX SET ARRAY(*;"Col10";Listbox font color array;$Pointer)
 End if

 
PROPERTIES 

Product: 4D
Theme: List Box
Number: 1279

 
HISTORY 

New
Created: 4D v14

 
SEE ALSO 

LISTBOX Get array

 
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)