4D v14.3

LISTBOX SELECT ROW

Home

 
4D v14.3
LISTBOX SELECT ROW

LISTBOX SELECT ROW 


 

LISTBOX SELECT ROW ( {* ;} object ; rowPosition {; action} )  
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)
rowPosition  Longint in Number of the row to select
action  Longint in Selection action

The LISTBOX SELECT ROW command selects the row whose number is passed in position 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.

The optional action parameter, if passed, is used to define the selection action to execute when a selection of rows already exists in the list box. You can pass a value or one of the following constants (located in the “List Box” theme):

Constant Type Value Comment
Listbox add to selection Longint 1 The row selected is added to the existing selection. If the row specified already belongs to the existing selection, the command does nothing.
Listbox remove from selection Longint 2 The row selected is removed from the existing selection. If the row specified does not belong to the existing selection, the command does nothing.
Listbox replace selection Longint 0 The row selected becomes the new selection and replaces the existing selection. The command has the same effect as a user click on a row (however, the On Clicked event is not generated). This is the default action (if the action parameter is omitted).

When the position parameter does not correspond exactly to an existing row number, the command works as follows:

  • If position is <0, the command does nothing, regardless of the action parameter value.
  • If position is 0 and if the action parameter contains Listbox replace selection or is omitted, all the rows of the listbox are selected. If the action parameter contains Listbox remove from selection, all the listbox rows are deselected.
  • If the position value is greater than the total number of rows contained in the listbox (only in the case of an array type listbox), the Boolean array associated with the listbox is automatically resized and the selection action is carried out. This mechanism means that you can use LISTBOX SELECT ROW with “standard” array management commands (such as APPEND TO ARRAY) that do not cause immediate synchronization of the listbox.
    After execution of the method, the arrays are synchronized: if the source array of the listbox has indeed been resized, the selection action is carried out. Otherwise, the Boolean array associated with the listbox returns to its initial size and the command does nothing.

Notes:

  • If you want the list box to scroll automatically in order to display the row selected, use the OBJECT SET SCROLL POSITION command.
  • To switch a row into editing mode (to allow data entry), use the EDIT ITEM command.
  • If the number passed in position corresponds to a hidden row in the list box, the row is selected but not displayed.

 
PROPERTIES 

Product: 4D
Theme: List Box
Number: 912

 
HISTORY 

Modified: 4D v11 SQL Release 2
Renamed: 4D v12

 
SEE ALSO 

EDIT ITEM
LISTBOX DELETE ROWS
LISTBOX INSERT ROWS
LISTBOX SELECT BREAK
OBJECT SET SCROLL POSITION

 
ARTICLE USAGE

4D Language Reference ( 4D v14 R3)
4D Language Reference ( 4D v14 R2)
4D Language Reference ( 4D v13.5)
4D Language Reference ( 4D v14.3)
4D Language Reference ( 4D v14 R4)

Inherited from : LISTBOX SELECT ROW ( 4D v12.4)