4D v14.3

LISTBOX SELECTIONNER RUPTURE

Accueil

 
4D v14.3
LISTBOX SELECTIONNER RUPTURE

LISTBOX SELECTIONNER RUPTURE 


 

LISTBOX SELECTIONNER RUPTURE ( {* ;} objet ; ligne ; colonne {; 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 * spécifié) ou Variable (si * omis)
ligne  Entier long in Numéro de ligne de la rupture
colonne  Entier long in Numéro de colonne de la rupture
action  Entier long in Action de sélection

La commande LISTBOX SELECTIONNER RUPTURE permet de sélectionner des lignes de rupture dans l’objet list box désigné par les paramètres objet et *. La list box doit être affichée en mode hiérarchique. 

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.

Les lignes de rupture sont ajoutées pour représenter la hiérarchie mais ne correspondent pas à des lignes de tableaux existantes. Pour désigner une ligne de rupture à sélectionner, vous devez passer dans les paramètres ligne et colonne des numéros de ligne et de colonne correspondant à la première occurrence dans le tableau correspondant. Ces valeurs sont retournées par la commande LISTBOX LIRE POSITION CELLULE lorsque l’utilisateur a sélectionné une ligne de rupture. Ce principe est détaillé dans le paragraphe “Gestion des lignes de rupture” de la section Gestion des List box hiérarchiques

Le paramètre action, s’il est passé, permet de définir l’action de sélection à effectuer lorsqu’une sélection de lignes de rupture 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 Commentaire
Ajouter à sélection listbox 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.
Remplacer sélection listbox 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é).
Supprimer de sélection listbox 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.

Exemple  

Soient les tableaux suivants représentés dans une list box :

Nous souhaitons sélectionner la ligne de rupture "Normandie" dans la représentation hiérarchique de ces tableaux :

 $ligne:=Chercher dans tableau(T2;"Normandie")
 $colonne:=2
 LISTBOX CONTRACTER(*;"MaListbox") `contraction de tous les niveaux
 LISTBOX SELECTIONNER RUPTURE(*;"MaListbox";$ligne;$colonne)

Voici le résultat :

 
PROPRIÉTÉS 

Produit : 4D
Thème : List Box
Numéro : 1117
Nom intl. : LISTBOX SELECT BREAK

 
HISTORIQUE 

Créé : 4D v12

 
VOIR AUSSI  

Gestion des List box hiérarchiques
LISTBOX LIRE POSITION CELLULE
LISTBOX SELECTIONNER LIGNE

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v13.5)
4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)

Parent de : LISTBOX SELECTIONNER RUPTURE ( 4D v12.4)