ClapPrint - Utilisation

Ce composant propose essentiellement deux éléments :

• La fonction d'impression de table : sImprimeTable()
• Une interface utilisateur permettant de gérer toutes les options de la fonction.

La fonction sImprimeTable

L'impression de la table se fait par une unique fonction : sImprimeTable. Une série de paramètres, donc certains peuvent être laissés par défaut, permettent de jouer sur les couleurs, sur l'existence ou pas des lignes (cadres, séparation), sur les formats (date, heure, monétaire, booléen), ...

L'interface utilisateur d'impression de table

Cette interface propose non seulement de gérer l'ensemble des paramètres reconnus par la fonction sImprimeTable() mais aussi de sauver le tout dans des profils, de sorte à pouvoir rappeler un "profil" plus tard.

L'appel de cette fenêtre FEN_ParamPrint accepte deux paramètres principaux :

• Le nom de la table à imprimer (obligatoire, avec ou sans guillemets)
• Le chemin complet d'un fichier INI pour sauvegarder les profils (optionnel)

Le contenu des onglets représente les mêmes options que pour l'appel de la fonction. Veuillez vous reporter à ce chapitre pour plus de détails.

Le fichier INI

Le fichier ini est exclusivement géré par l'interface utilisateur présentée ci-dessus. Chaque profil enregistré (avec le bouton "disquette") doit avoir un nom unique et correspondra à une section du fichier INI. Pour éviter toute confusion dans le fichier INI (au cas où le nom d'un profil correspondrait à une section déjà existante), préférez avoir un fichier INI à l'usage unique de ce composant.

Pour information, voici les mots clés géré par la fenêtre. Il est déconseillé de les modifier en dehors de cette fenêtre.

[NomDuProfil]

Orientation = 1 ou 2 (1[défaut]=portrait, 2=paysage)

Assemblage = 1 ou 2 (1[défaut]=assemblé, 2=non-assemblé), voir remarque ci-dessous

Portrait = 0 ou 1 (0[défaut]=portrait non forcé, 1=portrait forcé)

Titre = Valeur du titre du rapport (attention ne peut pas contenir de TAB, par défaut=vide). Pour les titres multilignes, utiliser les mots clés "Titre1","Titre2", ... dans ce cas "Titre" est alors ignoré.

RepeteTitre = 0 ou 1 (0[défaut]=le titre s'imprime sur la première page uniquement, 1=imprime le titre sur chaque page)

Logo = Chemin complet de l'image à afficher dans le coin supérieur gauche (par défaut pas de logo), voir remarque ci-dessous

TitreColonne = 0 ou 1 (0[défaut]=n'imprime pas le titre des colonnes, 1=imprime le titre des colonnes)

CalculeColonne = 0 ou 1 (0[défaut]=imprime la table sans exécuter le code "affichage d'une ligne dans la table", 1=sélectionne chaque ligne de la table pour que les colonnes calculées s'affichent correctement)

RepeteTitreColonne = 0 ou 1 (0[défaut]=le titre des colonne s'affiche sur la première page uniquement, 1=répète le titre des colonnes sur chaque page si TitreColonne = 1)

TitreColonneMultiligne = 0 ou 1 (0[défaut]=un seule ligne, 1=le titre des colonnes s'imprime sur plusieurs lignes même si le titre est sur une ligne dans la table d'origine)

LigneSelectionne = 0 ou 1 (0[défaut]=imprime toutes les lignes de la table, 1=n'imprime que les lignes sélectionnées), voir remarque ci-dessous

NumPage = 0 ou 1 (0[défaut]=n'imprime pas la # de page, 1=imprime le # de page en bas à droite de chaque page)

Date = 0 ou 1 (0[défaut]=n'imprime pas la date, 1=imprime la date en bas à gauche de chaque page)

Heure = 0 ou 1 (0[défaut]=n'imprime pas l'heure, 1=imprime l'heure en bas à gauche de chaque page)

Booleen = 0 ou 1 (0[défaut]=imprime les booléens comme des chiffres, 1=imprime les booléens comme des coches)

ContenuMultiligne = 0 ou 1 (0[défaut]=contenu de chaque case sur une seule ligne, 1=contenu des cases sur plusieurs ligne)

Image = 0 ou 1 (0[défaut]=n'imprime pas les mémos images, 1=imprime les mémos images)

EcritureDaG = 0 ou 1 (0[défaut]=écrit dans le sens par défaut déterminé par la table, 1=force l'écriture de droite à gauche)

Gris = 0 ou 1 (0[défaut]=imprime en couleur, 1=imprime en tons de gris)

Cadre = 0 ou 1 (0[défaut]=pas de cadre, 1=imprime le cadre)

SeparateurV = 0,iContinu,iPointillé,iMixte,iTiret (0[défaut]=pas de trait)

SeparateurH = 0,iContinu,iPointillé,iMixte,iTiret (0[défaut]=pas de trait)

Police = Nom de la police de caractère à utiliser (par défaut=Arial)

PoliceTaille = numérique (par défaut=10 pour tous les textes sauf la première ligne de titre en 12)

RepeteCalcul = 0 ou 1 (0[défaut]=calculs visibles uniquement sur la dernière page, 1=calculs visibles sur toutes les pages comme des valeurs intermédiaires)

DateFormat = voir la documentation PC SOFT de DateVersChaine

HeureFormat = voir la documentation PC SOFT de HeureVersChaine

MonetaireFormat = voir la documentation PC SOFT de NumériqueVersChaine

MagentaTransparent = 0 ou 1 (0[défaut]=pas de transparence des mémos images et de l'image de titre s'ils contiennent du magenta, 1=le magenta des images sera transparent)

Champ_x = NomDeLaColonne~Compteur~Moyenne~Total (Compteur, Moyenne, Total prennent la valeur 0 ou 1 selon qu'ils sont activés ou pas pour la colonne)

Image_x = NomDeLaColonne~Valeur~CheminImage (valeur = valeur de la "rubrique", CheminImage = chemin complet de l'image correspondante à la valeur ci-avant, voir illustration de l'onglet 4 ci-dessus)

COULEURPAIRE = 0 a 16777216 (couleur de fond des lignes paires, voir la documentation PC SOFT)

COULEURIMPAIRE = 0 a 16777216 (couleur de fond des lignes impaires, voir la documentation PC SOFT)

COULEURDONNEE = 0 a 16777216 (couleur de texte des données, voir la documentation PC SOFT)

COULEURFONDPAGE = 0 a 16777216 (couleur de fond de page, voir la documentation PC SOFT)

COULEURVERTICAL = 0 a 16777216 (couleur des lignes verticales, voir la documentation PC SOFT)

COULEURHORIZONTAL = 0 a 16777216 (couleur des lignes horizontales, voir la documentation PC SOFT)

COULEURTITRE = 0 a 16777216 (couleur de texte du titre, voir la documentation PC SOFT)

COULEURFONDTITRE = 0 a 16777216 (couleur de fond du titre, voir la documentation PC SOFT)

COULEURTITRECOL = 0 a 16777216 (couleur du texte des titres de colonne, voir la documentation PC SOFT)

COULEURFONDTITRECOL = 0 a 16777216 (couleur de fond des titres de colonne, voir la documentation PC SOFT)

COULEURCADRE = 0 a 16777216 (couleur des lignes du cadre, voir la documentation PC SOFT)

Contraintes techniques

• La fonction sImprimeTable() ne peut pas être appelée dans un état (comme pour imprimer un sous-état)

Astuces

• Le nom des colonnes à imprimer doit être sous forme NomDeFenêtre.NomDeTable.NomDeColonne, ceci pour garantir l'exacte correspondance entre ce qui est vu et ce qui est imprimé.
• La fonction ne gère pas le paramètre iAperçu. Vous devez donc, dans le code, utiliser (ou pas) iAperçu avant d'appeler la fonction sImprimeTable.
• Veillez, avant de lancer l'impression via la fonction ou la fenêtre FEN_ParamPrint, de désactiver les timers et les événements tels que spécifiés dans la documentation de PC SOFT.
• Pour ne choisir que certaines colonnes d'une table, utilisez le paramètres sCalculs dans lequel il faut alors mettre NomColonne1+TAB+0+RC+NomColonne2+TAB+0+RC+...
• Lors d'une aperçu avant impression, si l'on utilise sImprimeTable() et ensuite un iImprimeEtat() standard, il faut mettre un iApercu avant chacune des deux instructions.

Adaptation de l'impression à la largeur de la page

La fonction est construite de telle sorte à adapter la taille des caractères (et donc la hauteur et largeur des colonnes) automatiquement. En effet, lorsque la largeur de la table dépasse la largeur d'une page (selon l'orientation demandée dans un autre paramètre), la procédure commence par diminuer la taille de caractères pour voir si la table peut finir par entrer dans la page (la taille minimale est de 3). Si ce n'est pas possible, et que l'orientation portrait avait été choisie, la procédure passe automatiquement en paysage et refait le même calcul. Pour éviter ce passage automatique en mode paysage, il faut explicitement cocher "Force orientation portrait" ou utiliser la constante _ImprimeForcePortrait. Si finalement la ligne de table ne rentre pas dans la largeur de page, plusieurs pages seront prévues en largeur. Dans ce cas, il faut être attentif aux options d'assemblage.

Option d'assemblage

Grâce à ces fonctions, il est donc possible d'imprimer soit toutes les pages en largeur et ensuite les prochains enregistrement, soit les premières colonnes sur tous les enregistrements et ensuite les colonnes suivantes sur tous les enregistrement. Exemple : l'impression a besoin de 3 pages en largeur (pour contenir toutes les colonnes), soit a,b,c et 10 pages en hauteur (pour les 847 enregistrements) soit 1,2,3,4,..10. Chaque page est alors identifiée comme 1a, 1b, 1c, 2a, 2b, 2c, 3a, 3b, 3c ... 10a, 10b et 10c.

- L'option "Assemblé" ou l'absence de constante _ImprimeNonAssemblée imprimera les pages dans l'ordre suivant : 1a, 2a, 3a, 4a, ... 10a, 1b, 2b, 3b, 4b ... 10b, 1c, 2c, 3c, 4c ... 10c

- L'option "Non assemblée" ou l'utilisation de la constante _ImprimeNonAssemblée imprimera les pages dans l'ordre suivant : 1a, 1b, 1c, 2a, 2b, 2c, ... 10a, 10b, 10c

Attention, si l'on choisi un nombre de pages limité (différent de 0 qui imprime toutes les page), l'on imprime évidemment la table selon l'ordre précité.

Impression des lignes sélectionnées

Depuis la version 1.05, la fonction sTableImprime() permet de n'imprimer que les lignes sélectionnées. Pour faire cela, il faut d'une part ajouter l'option "_ImprimeLigneSélectionnée" et il faut ensuite être dans un des cas suivant : soit la première colonne est de type "coche" et elle sera utilisé comme élément de sélection, soit ce n'est pas le cas et l'impression se basera sur la propriété ..Sélectionnée de chaque ligne de la table.

Impression d'un logo (image)

Depuis la version 1.05, la fonction sTableImprime() permet d'imprimer un logo dans le coin supérieur gauche. Il faut, pour cela, que l'image soit sous forme de fichier (les images issues d'un mémo image doivent d'abord est sauvegardées sous forme de fichier). Ensuite, il suffit juste de mettre le chemin de l'image dans le paramètre Titre séparé par un retour chariot : "Le titre de mon rapport"+RC+"D:\Images\LogoCompagnie.png"

Liens utiles

Les entrées/sorties du composant

Détail de la fenêtre FEN_ParamPrint

Téléchargement et licence