LISTBOX SET PROPERTY

Home

4D v19.8


LISTBOX SET PROPERTY ( {* ;} object ; property ; value )

Parameter	Type	Description
*	Operator	If specified, object is an object name (string). If omitted, object is a variable.
object	Form object	Object name (if * is specified) or Variable (if * is omitted)
property	Longint	List box or column property
value	Longint, String	Value of property

Description

The LISTBOX SET PROPERTY command sets the value for the property of the list box or list box column specified using 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.

Note: If the list box or list box column specified using the object and * parameters does not exist, the command does nothing and no error is triggered.

In the property and value parameters, you indicate, respectively, the property to set and its new value. You can use the following constants found in the “List Box” theme:

Constant	Type	Value	Comment
lk allow wordwrap	Longint	14	Wordwrap property Applies to: Column* Possible values: lk no (0) lk yes (1)
lk auto row height	Longint	31	Automatic row height property for array type list box Applies to: List box or column Possible values: lk no (0) lk yes (1)
lk background color expression	String	22	Background Color Expression property for selection type list box Applies to: List box or column
lk column max width	Longint	26	Maximum Width property Applies to: Column*
lk column min width	Longint	25	Minimum Width property Applies to: Column*
lk column resizable	Longint	15	Resizable property Applies to: Column* Possible values: lk no (0) lk yes (1)
lk detail form name	String	19	Detail Form Name property for selection type list box Applies to: List box
lk display type	Longint	21	Display Type property for numeric columns Applies to: Column* Possible values: lk numeric format (0): displays values in numeric format lk three states checkbox (1): displays values as three-state checkboxes
lk double click on row	Longint	18	Double-click on row property for selection type list box Applies to: List box Possible values: lk do nothing (0): does not trigger any automatic action lk edit record (1): displays corresponding record in read-write mode lk display record (2): displays corresponding record in read-only mode
lk extra rows	Longint	13	Hide extra blank rows property Applies to: List box Possible values: lk display (0) lk hide (1)
lk font color expression	String	23	Font Color Expression property for selection type list box Applies to: List box or column
lk font style expression	String	24	Style Expression property for selection type list box Applies to: List box or column
lk hide selection highlight	Longint	16	Hide selection highlight property Applies to: List box Possible values: lk no (0) lk yes (1)
lk highlight set	String	27	Highlight Set property for selection type list box Applies to: List box
lk movable rows	Longint	35	Movable Rows property for array type list box Applies to: List box (excluding hierarchical mode) Possible values: lk no (0): Rows cannot be moved at runtime lk yes (1): Rows can be moved at runtime (default)
lk multi style	Longint	30	Multi-style property Applies to: Column* Possible values: lk no (0) lk yes (1)
lk named selection	String	28	Named Selection property for selection type list box Applies to: List box
lk resizing mode	Longint	11	Column Auto-Resizing property Applies to: List box Possible values: lk manual (0) lk automatic (1)
lk row height unit	Longint	17	Unit of Row Height property Applies to: List box Possible values: lk lines (1) lk pixels (0)
lk selection mode	Longint	10	Selection Mode property Applies to: List box Possible values: lk none (0) lk single (1) lk multiple (2)
lk single click edit	Longint	29	Single-Click Edit property Applies to: List box Possible values: lk no (0) lk yes (1)
lk sortable	Longint	20	Sortable property Applies to: List box Possible values: lk no (0) lk yes (1)
lk truncate	Longint	12	Truncate with ellipsis property Applies to: List box or column Possible values: lk without ellipsis (0) lk with ellipsis (1)

*These properties can only be applied to list box columns; however, if you pass a list box as parameter, LISTBOX SET PROPERTY applies the property to each column of the list box.

Note: If you pass a property that does not exist, or that is not available for the specified list box or column, for example lk font style expression in the case of an array type list box, the command does nothing and no error is triggered.

Example 1

You want to make all columns of the "MyListbox" list box resizable:

 LISTBOX SET PROPERTY(*;"MyListbox";lk column resizable;lk yes) //All columns of the "MyListbox" list box are set as resizable

Example 2

You want to set a maximum width for the column whose name is "ProductNumber":

LISTBOX SET PROPERTY(*;"ProductNumber";lk column max width;200) //This column will have a maximum width of 200