4D v16.3

LISTBOX SET ROW HEIGHT

Accueil

 
4D v16.3
LISTBOX SET ROW HEIGHT

LISTBOX SET ROW HEIGHT 


 

LISTBOX SET ROW HEIGHT ( {* ;} objet ; ligne ; hauteur ) 
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)
ligne  Entier long in Ligne de la List box dont la hauteur doit être fixée.
hauteur  Entier long in Hauteur de la ligne de la List box

Cette commande nécessite une licence 4D View Pro. Si cette licence n'est pas présente, une erreur est affichée dans la list box à l'exécution du formulaire. Pour plus d'informations, veuillez vous reporter à la section 4D View Pro.

La commande LISTBOX SET ROW HEIGHT permet de modifier la hauteur de la ligne spécifiée dans le paramètre ligne dans la List box désignée par les paramètres objet et éventuellement *.

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

Si la ligne spécifiée n'existe pas dans la List box, la commande ne fait rien.

L'unité utilisée par hauteur correspond à celle définie globalement pour les lignes de la List box, soit dans la Liste des propriétés, soit par un appel antérieur à la commande LISTBOX SET ROWS HEIGHT.

La commande LISTBOX SET ROW HEIGHT modifie le tableau de hauteur de lignes spécifié dans la Liste des propriétés, le cas échéant (cf. section Tableau hauteurs de lignes dans le manuel Mode Développement. Sinon, la commande crée dynamiquement un tableau de hauteurs de lignes. Utiliser cette commande pour définir individuellement les hauteurs de lignes produit le même résultat qu'utiliser un tableau de hauteurs de lignes ; toutefois, remplir un tableau de hauteurs de lignes est plus rapide qu'appeler cette commande dans une boucle pour fixer les hauteurs de lignes une par une.

Important : Si la commande globale LISTBOX SET ROWS HEIGHT est appelée par la suite avec une unité différente de celle définie précédemment, la valeur par défaut de cette commande remplacera et réinitialisera toute hauteur de ligne définie à l'aide de LISTBOX SET ROW HEIGHT (voir exemple 2).

Vous souhaitez modifier la hauteur de quelques lignes de la list box suivante :

Si vous exécutez ce code :

  //unité courante en pixels
 LISTBOX SET ROW HEIGHT(*;"listboxname";3;40) //Kuwait
 LISTBOX SET ROW HEIGHT(*;"listboxname";7;14) //Serbia

... vous obtenez le résultat suivant :

Vous devez fixer une hauteur de ligne par défaut puis mettre en place individuellement des hauteurs de lignes spécifiques pour certaines d'entre elles en utilisant la commande LISTBOX SET ROW HEIGHT :

 LISTBOX SET ROWS HEIGHT(*;"listboxname";25;lk pixels// la hauteur est globalement fixée à 25 pixels
 
 LISTBOX SET ROW HEIGHT(*;"listboxname";1;30) // ligne 1: 30 pixels
 LISTBOX SET ROW HEIGHT(*;"listboxname";5;40) // ligne 5: 40 pixels
 LISTBOX SET ROW HEIGHT(*;"listboxname";11;50) // ligne 11: 50 pixels

Par la suite, si le code suivant est exécuté :

 LISTBOX SET ROWS HEIGHT(*;"listboxname";18;lk pixels)

… la hauteur des lignes est globalement fixée à 18 pixels ; toutefois, étant donné que l'unité n'a pas changé, les lignes 1, 5 et 11 garderont leur hauteur personnalisée, à savoir, 30, 40 et 50 pixels tel que défini ci-dessus par la commande LISTBOX SET ROW HEIGHT.

En revanche, si le code suivant est exécuté :

 LISTBOX SET ROWS HEIGHT(*;"listboxname";2;lk lines)

… alors les lignes 1, 5 et 11 sont réinitialisées à la valeur globale par défaut mise en place par la commande LISTBOX SET ROWS HEIGHT (c'est-à-dire 2 lignes) car l'unité est passée de "pixels" à "lignes". Comme il n'y a pas de conversion automatique, le changement d'unité aboutit toujours à la réinitialisation des hauteurs de lignes avec la nouvelle valeur par défaut.



Voir aussi  


LISTBOX Get row height
LISTBOX SET ROWS HEIGHT

 
PROPRIÉTÉS 

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

 
HISTORIQUE 

New
Créé : 4D v16

 
UTILISATION DE L'ARTICLE

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