4D v16.3LISTBOX DUPLIQUER COLONNE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v16.3
LISTBOX DUPLIQUER COLONNE
LISTBOX DUPLIQUER COLONNE
La commande LISTBOX DUPLIQUER COLONNE permet de dupliquer la colonne désignée par le(s) paramètre(s) objet et * dans le contexte du formulaire en cours d’exécution (mode Application). Le formulaire d’origine, généré en mode Développement, n’est pas modifié. Note : Cette fonctionnalité est présente dans 4D, en mode Développement uniquement, via la commande Dupliquer colonne du menu contextuel de l’éditeur de formulaires. Par défaut, toutes les options de style (taille, couleur, formats, etc.) définies pour la colonne source via la Liste des propriétés ou les commandes de gestion d’objet (OBJET FIXER COULEUR, etc.) sont appliquées à la copie. La méthode objet et le paramétrage des événements formulaire sont également dupliqués. Les paramètres objet et * désignent la colonne à dupliquer. Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet est un nom de colonne (une chaîne). Si vous ne passez pas ce paramètre, vous indiquez que le paramètre objet est une variable de colonne. Dans ce cas, vous ne passez pas une chaîne mais une référence de variable. Note : Cette commande ne fait rien si elle est appliquée à la première colonne d’une list box affichée en mode hiérarchique. La nouvelle colonne dupliquée est placée juste avant la colonne désignée par le paramètre positionCol. Si le paramètre positionCol est supérieur au nombre total de colonnes, la colonne est dupliquée après la dernière colonne. Passez dans les paramètres nomCol et variableCol le nom d’objet et la variable de la nouvelle colonne dupliquée.
N’oubliez pas que la source de données de la colonne d’origine n’est pas dupliquée : le contenu de la variable, tableau ou champ source de la nouvelle colonne dupliquée doit être défini. Passez dans les paramètres nomEntête et variableEntête le nom d’objet et la variable de l’en-tête de la nouvelle colonne dupliquée. Vous pouvez également passer dans les paramètres nomPied et variablePied le nom d’objet et la variable du pied de la colonne insérée. Si vous omettez le paramètre variablePied, 4D utilisera une variable dynamique. Note : Les noms d’objets doivent être uniques dans un formulaire. Vous devez veiller à ce que les noms passés dans les paramètres nomCol, nomEntête et nomPied ne soient pas déjà utilisés. Sinon, la colonne n’est pas dupliquée et une erreur est générée. Cette commande doit être utilisée dans le contexte de l’affichage d’un formulaire. Elle sera généralement appelée dans l’événement Sur chargement du formulaire ou suite à une action utilisateur (événement Sur clic). A compter de 4D v14 R3, vous pouvez dupliquer dynamiquement des colonnes de list box, 4D prenant automatiquement en charge les définitions de variables nécessaires (colonne, pied et en-tête). Pour cela, LISTBOX DUPLIQUER COLONNE accepte un pointeur Nil (->[]) comme valeur pour les paramètres variableCol (list box de type tableau uniquement), variableEntête et variablePied. Dans ce cas, 4D va créer dynamiquement les variables requises lors de l'exécution de la commande (pour plus d'informations, reportez-vous à la section Variables dynamiques). A noter que les variables d'en-tête et de pied sont toujours créées avec un type spécifique (respectivement entier long et texte). A l'inverse, les variables de colonne ne peuvent pas être typées à la création car les list box acceptent différents types de tableaux pour ces variables (tableau texte, tableau entier, etc.). Vous devez donc définir manuellement le type du tableau (cf. exemple 2). Il est important d'effectuer ce typage avant d'appeler des commandes telles que LISTBOX INSERER LIGNES pour insérer des nouveaux éléments dans le tableau. Ou bien, il est possible d'utiliser AJOUTER A TABLEAU pour à la fois typer le tableau et insérer des éléments. Dans une list box de type tableau, on souhaite dupliquer la colonne "Prénom", prête pour la saisie : Le code du bouton : TABLEAU TEXTE(tPrenoms2;Enregistrements dans table([Adhérents])) Lorsque vous cliquez sur le bouton, la list box apparaît ainsi : Vous souhaitez dupliquer dynamiquement une colonne booléenne et modifier son titre : C_POINTEUR($ptr)
Voir aussi
|
PROPRIÉTÉS
Produit : 4D
HISTORIQUE
Créé : 4D v14 UTILISATION DE L'ARTICLE
4D - Langage ( 4D v16) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||