4D Doc Center : LISTBOX Get information

4D v12.4

LISTBOX Get information


LISTBOX Get information ( {* ;} object ; info ) -> Function result

Parameter	Type	Description
*		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)
info	Longint	Information to get
Function result	Longint	Current value

Description

The LISTBOX Get information command returns various information regarding the current visibility and size of headers and scrollbars in the list box object set 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. For more information about object names, refer to the Object Properties section.

In the dans info parameter, pass a value indicating the type of information that you want to get. You can use a value or one of the following constants from the “List box” theme:

Constant	Type	Value	Comment
Display listbox header	Longint	0	0=hidden, 1=shown
Display listbox hor scrollbar	Longint	2	0=hidden, 1=shown
Display listbox ver scrollbar	Longint	4	0=hidden, 1=shown
Listbox header height	Longint	1	Height in pixels
Listbox hor scrollbar height	Longint	3	Height in pixels
Listbox ver scrollbar width	Longint	5	Width in pixels
Position listbox hor scrollbar	Longint	6	Position of the cursor in pixels
Position listbox ver scrollbar	Longint	7	Position of the cursor in pixels

The first six constants are useful for calculating the actual size of a list box area in a form.
When you use the constants Position listbox hor scrollbar or Position listbox ver scrollbar, the LISTBOX Get information command returns the position of the scrolling cursor in relation to its original position, i.e. the size of the hidden part of the window, expressed in pixels. By default, this position corresponds to 0. Combined, for example, with information concerning the row height, this value lets you find out the contents displayed in the listbox.

Example

Given a list box containing rows with a height of 20 pixels each. You execute the following statement:

$scroll:=LISTBOX Get information(*;"Listbox";Position listbox ver scrollbar)

If, for instance, $scroll returns 200, you can conclude that the 11th row is currently the first one displayed in the list box (200/20=10, thus 10 rows are hidden).