LISTBOX FIXER HAUTEUR LIGNE

4D v16.3


LISTBOX FIXER HAUTEUR LIGNE ( {* ;} objet ; ligne ; hauteur )

Paramètre	Type	Description
*	Opérateur	Si spécifié, objet est un nom d'objet (chaîne) Si omis, objet est une variable
objet	Objet de formulaire	Nom d’objet (si * est spécifié) ou Variable (si * est omis)
ligne	Entier long	Ligne de la List box dont la hauteur doit être fixée.
hauteur	Entier long	Hauteur de la ligne de la List box

4D View Pro

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.

Description

La commande LISTBOX FIXER HAUTEUR LIGNE 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 FIXER HAUTEUR LIGNES.

La commande LISTBOX FIXER HAUTEUR LIGNE 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 FIXER HAUTEUR LIGNES 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 FIXER HAUTEUR LIGNE (voir exemple 2).

Exemple 1

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

Si vous exécutez ce code :

  //unité courante en pixels

 LISTBOX FIXER HAUTEUR LIGNE(*;"listboxname";3;40) //Kuwait

 LISTBOX FIXER HAUTEUR LIGNE(*;"listboxname";7;14) //Serbia

... vous obtenez le résultat suivant :

Exemple 2

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 FIXER HAUTEUR LIGNE :

 LISTBOX FIXER HAUTEUR LIGNES(*;"listboxname";25;lk pixels) // la hauteur est globalement fixée à 25 pixels

 

 LISTBOX FIXER HAUTEUR LIGNE(*;"listboxname";1;30) // ligne 1: 30 pixels

 LISTBOX FIXER HAUTEUR LIGNE(*;"listboxname";5;40) // ligne 5: 40 pixels

 LISTBOX FIXER HAUTEUR LIGNE(*;"listboxname";11;50) // ligne 11: 50 pixels

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

LISTBOX FIXER HAUTEUR LIGNES(*;"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 FIXER HAUTEUR LIGNE.

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

LISTBOX FIXER HAUTEUR LIGNES(*;"listboxname";2;lk lignes)

… alors les lignes 1, 5 et 11 sont réinitialisées à la valeur globale par défaut mise en place par la commande LISTBOX FIXER HAUTEUR LIGNES (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 FIXER HAUTEUR LIGNES
LISTBOX Lire hauteur ligne