Votre souhait s’est enfin réalisé, vous pouvez désormais insérer et remplir des tableaux par programmation dans vos documents 4D Write Pro. Il ne s’agit pas ici de tabulations imitant des tableaux, mais de « vrais » tableaux ! Des tableaux où le texte s’adapte automatiquement à la taille de colonne que vous avez définie, et qui ne se « cassent » pas lorsque vos données changent.
Cette fonctionnalité est la première amélioration majeure par rapport à l’ancien ensemble de fonctionnalités de 4D Write. Vous serez désormais en mesure de générer des factures contenant des tableaux, entièrement par programmation et de les styliser exactement comme vous le souhaitez avec quelques lignes de codes ! Un autre scénario est que vous pouvez maintenant fournir à vos utilisateurs un bouton dans l’interface utilisateur de votre application qui insérera un tableau avec un nombre prédéfini de lignes et de rangées, une taille prédéfinie pour chaque colonne, puis vous pouvez laisser l’utilisateur modifier et styliser le contenu par lui-même.
Qu’est-ce qui est possible pour le développeur 4D ?
Grâce à un nouvel ensemble de commandes, les développeurs 4D peuvent désormais créer un tableau par programmation dans un document 4D Write Pro, ajouter des lignes à ce tableau puis styliser l’ensemble du contenu du tableau, une ou plusieurs lignes, une cellule ou même un ensemble de cellules ! Les commandes WP Insert table, WP Table append row, WP Table get rows, WP Table get columns et WP Table get cells sont faciles à utiliser et permettent de manipuler les plages selon le concept du langage 4D Write Pro.
Qu’est-ce qui est possible pour l’utilisateur final ?
Une fois qu’un tableau a été créé par programmation, le contenu des cellules peut être modifié par les utilisateurs de la zone 4D Write Pro. Ils peuvent cliquer dans une cellule et sélectionner, éditer, copier/coller ou supprimer du texte ou des images, tout comme dans les paragraphes ordinaires. Les utilisateurs peuvent également sélectionner des colonnes, des lignes ou des cellules et les styliser, par exemple mettre le texte en gras/italique, changer les couleurs du texte/du fond, l’alignement du texte, etc… en utilisant le menu contextuel ou toute autre interface personnalisée.
Téléchargez notre exemple
Si vous voulez voir comment il est facile de construire l’exemple de tableau ci-dessous avec 4D Write Pro, veuillez télécharger notre base de données d’exemples :
Exemples de programmation
Insérer un tableau et ajouter des lignes
WP Insert table crée une table et retourne une référence sur l’objet table. Cette référence peut être utilisée par la suite pour ajouter une nouvelle ligne et remplir les valeurs des cellules en utilisant WP Table append row.
WPrange:=WP Get range(WParea;wk start text;wk end text)
WPtable :=WP Insert Table(WPrange;wk append)
$row :=WP Table append row(WPtable;[myTable]image;[myTable]produit;[myTable]date;[myTable]valeur)
Styliser la table et son contenu
Ensuite, la plupart des attributs qui peuvent déjà être appliqués au document, au paragraphe ou au texte peuvent également être appliqués au tableau lui-même, aux lignes, aux colonnes et même aux cellules individuelles. La largeur des colonnes, l’alignement, le type et la taille de la police, les couleurs, les bordures… tout ce dont vous avez besoin pour personnaliser le style de votre tableau peut être défini aussi simplement que pour tout autre type de contenu dans votre document.
Pour ce faire, il suffit d’utiliser WP Table get columns, WP Table get rows et WP Table get cells pour obtenir les plages que vous souhaitez manipuler à l’aide des commandes WP SET ATTRIBUTES et WP GET ATTRIBUTES .
Définissez la taille de la police à 16 pt pour l’ensemble du tableau :
WP SET ATTRIBUTES(WPtable;wk font size;16)
Définissez la largeur de la deuxième colonne à 150 pt :
$col:=WP Table get columns(WPtable;2;1)
WP SET ATTRIBUTES ($col;wk width; "150pt")
Définissez le style de police de la première ligne sur gras :
$row:=WP Table get rows(WPtable;1;1)
WP SET ATTRIBUTES ($row;wk font bold;wk true)
Définissez la couleur de police de la cellule (2;2) sur bleu :
$cell:=WP Table get cells(WPtable;2;2)
WP SET ATTRIBUTES ($cell;wk text color; "blue")
Pour plus de détails, nous vous recommandons de jeter un coup d’œil à la documentation de4D v16 R4 .