4D v16.3

LISTBOX SELECT ROW

Accueil

 
4D v16.3
LISTBOX SELECT ROW

LISTBOX SELECT ROW 


 

LISTBOX SELECT ROW ( {* ;} objet ; positionLigne {; action} )  
Paramètre Type   Description
Opérateur in Si spécifié, objet est un nom d’objet (chaîne) Si omis, objet est une variable
objet  Objet de formulaire in Nom d’objet (si * est spécifié) ou Variable (si * est omis)
positionLigne  Entier long in Numéro de la ligne à sélectionner
action  Entier long in Action de sélection

La commande LISTBOX SELECT ROW provoque la sélection de la ligne de numéro positionLigne dans l’objet list box désigné par les paramètres objet et *.

Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet est un nom d’objet (une chaîne). Si vous ne passez pas ce paramètre, vous indiquez que le paramètre objet est une variable. Dans ce cas, vous ne passez pas une chaîne mais une référence de variable. Pour plus d'informations sur les noms d’objets, reportez-vous à la section Objets de formulaires.

Le paramètre action, s’il est passé, permet de définir l’action de sélection à effectuer lorsqu’une sélection de lignes existe déjà dans la list box. Vous pouvez passer une valeur ou l’une des constantes suivantes, placées dans le thème List box :

Constante Type Valeur Comment
lk add to selection Entier long 1 La ligne sélectionnée est ajoutée à la sélection existante. Si la ligne désignée appartient déjà à la sélection existante, la commande ne fait rien.
lk remove from selection Entier long 2 La ligne sélectionnée est supprimée de la sélection existante. Si la ligne désignée n’appartient pas à la sélection existante, la commande ne fait rien.
lk replace selection Entier long 0 La ligne sélectionnée devient la nouvelle sélection et remplace la sélection existante. La commande produit le même effet qu’un clic de l’utilisateur sur une ligne de la list box (l'événement Sur clic n'est toutefois pas généré). Cette action est effectuée par défaut (lorsque le paramètre action n’est pas passé).

Lorsque le paramètre positionLigne ne correspond pas strictement à un numéro de ligne existante, la commande agit de la manière suivante :

  • Si positionLigne est <0, la commande ne fait rien, quelle que soit la valeur du paramètre action.
  • Si positionLigne vaut 0 et si le paramètre action contient lk replace selection ou est omis, toutes les lignes de la listbox sont sélectionnées. Si le paramètre action contient lk remove from selection, toutes les lignes de la listbox sont désélectionnées.
  • Si la valeur de positionLigne est supérieure au nombre total de lignes contenues dans la listbox (dans le cas d'une listbox de type tableau uniquement), le tableau booléen associé à la listbox est automatiquement redimensionné et l’action de sélection est effectuée. Ce mécanisme permet d’utiliser LISTBOX SELECT ROW avec des commandes “standard” de gestion de tableaux (telles que APPEND TO ARRAY) n’entraînant pas de synchronisation immédiate de la listbox.
    A l’issue de l’exécution de la méthode, les tableaux sont synchronisés : si le tableau source de la listbox a effectivement été redimensionné, l’action de sélection est effectuée. Sinon, le tableau booléen associé à la listbox reprend sa taille initiale et la commande ne fait rien.

Notes :

  • Si vous souhaitez que la list box défile de manière à afficher la ligne nouvellement sélectionnée, utilisez la commande OBJECT SET SCROLL POSITION.
  • Pour passer une ligne en mode édition (saisie), utilisez la commande EDIT ITEM.
  • Si le numéro passé dans positionLigne correspond à une ligne masquée dans la list box, la ligne est sélectionnée mais n'est pas affichée.



Voir aussi  

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

 
PROPRIÉTÉS 

Produit : 4D
Thème : List Box
Numéro : 912

 
HISTORIQUE 

Modifié : 4D v11 SQL Release 2
Renommé : 4D v12

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)