ClapPrint - Entrées et sorties

Le composant d'impression propose plusieurs fonctions dans une collection de procédure ainsi qu'une fenêtre :

Fonction 'nImprimeTable'

Résumé

Imprime la table passée en paramètre. Cette table peut être une table classique ou hiérarchique (mémoire ou fichier). Dans ce dernier cas, l'impression ne tient pas compte de la hiérarchie (tous les éléments de la colonne hiérarchique seront imprimés sur le même niveau). De même, toute rupture est également ignorée dans cette fonction.

Syntaxe

nImprimeTable (<xNomTable> [, <stOptions> est un stOptionClapPrint [, <nOptions> est un entier [, <sTitre> est une chaîne [, <polImprime> est une Police]]]])

Paramètres

xNomTable : Nom complet de la table avec le nom de la fenêtre (soit Table..nom, soit avec guillemets)

stOptions (structure propre à clapPrint) :

  rHauteurMaxLigne (réel - valeur par défaut=0.0) : Hauteur d'une ligne de données (est influencé par le facteur de "zoom");

  sFormatDate (chaîne - valeur par défaut="JJ/MM/AAAA") : Voir la documentation PC SOFT de DateVersChaine;

  sFormatHeure (chaîne - valeur par défaut="HH:MM:SS") : Voir la documentation PC SOFT de HeureVersChaine;

  sFormatMonétaire (chaîne - valeur par défaut="10.2fS") : Voir la documentation PC SOFT de NumériqueVersChaine;

  rMargeHaut (réel - valeur par défaut 5.0) : Marge de haut de page en millimètres;

  rMargeBas (réel - valeur par défaut 5.0) : Marge de bas de page en millimètres;

  rMargeGauche (réel - valeur par défaut 5.0) : Marge de gauche en millimètres;

  rMargeDroite (réel - valeur par défaut 5.0) : Marge de droite en millimètres;

  nNbExemplaire (entier - valeur par défaut 1) : Nombre d'exemplaires à imprimer (est prioritaire sur l'option _clapPrintPasFinImprime;

  nNbPagesMax (entier - valeur par défaut=0) : Nombre de page à imprimer, depuis la première. Mettre 0 (zéro) pour imprimer toutes les pages. Attention, si l'on utilise une valeur >0, à l'ordre d'impression dépendant du type d'assemblage choisi (voir remarques);

  sCouleurs (chaîne - valeur par défaut=vide) : Doit contenir les paramètres de couleurs (NomDeLaCouleur + TAB + ValeurDeLaCouleur) séparés par des RC. Les constantes reconnues pour les couleurs sont :

      _clapPrintCouleurLigneImpaire : Couleur de fond des lignes impaires (par défaut : blanc) de 0 a 16777216 (voir la documentation PC SOFT);

      _clapPrintCouleurTexteDonnée : Couleur de caractère des données des lignes impaires (par défaut : noir) de 0 a 16777216 (voir la documentation PC SOFT);

      _clapPrintCouleurLignePaire : Couleur de fond des lignes paires (par défaut : blanc) de 0 a 16777216 (voir la documentation PC SOFT);

      _clapPrintCouleurTexteDonnée : Couleur de caractère des données des lignes paires (par défaut : noir) de 0 a 16777216 (voir la documentation PC SOFT);

      _clapPrintCouleurFondPage : Couleur de fond du cadre délimitant le contenu complet de la page (par défaut : blanc) de 0 a 16777216 (voir la documentation PC SOFT);

      _clapPrintCouleurSéparateurVertical : Couleur de trait des séparateurs verticaux (par défaut : noir) de 0 a 16777216 (voir la documentation PC SOFT);

      _clapPrintCouleurSéparateurHorizontal : Couleur de trait des séparateurs horizontaux (par défaut : noir) de 0 a 16777216 (voir la documentation PC SOFT);

      _clapPrintCouleurTexteTitre : Couleur de caractère du titre (par défaut : noir) de 0 a 16777216 (voir la documentation PC SOFT);

      _clapPrintCouleurFondTitre : Couleur de fond du titre (par défaut : blanc) de 0 a 16777216 (voir la documentation PC SOFT);

      _clapPrintCouleurCadre : Couleur de trait du cadre incluant la ligne en-dessous du titre et celle au-dessus du "pied de page" (par défaut : noir) de 0 a 16777216 (voir la documentation PC SOFT);

      _clapPrintCouleurTexteTitreColonne : Couleur de caractère du titre des colonnes (par défaut : noir) de 0 a 16777216 (voir la documentation PC SOFT);

      _clapPrintCouleurFondTitreColonne : Couleur de font du titre des colonnes (par défaut : blanc) de 0 a 16777216 (voir la documentation PC SOFT);

  sCalculs (chaîne - valeur par défaut=vide) : Doit contenir les paramètres de calculs (NomLogiqueDeLaColonne + TAB + CombinaisonDeConstantes) séparés par RC;

      _clapPrintAvecCalculCompteur (= 4) : Si l'on veut imprimer un compteur sur la colonne liée;

      _clapPrintAvecCalculMoyenne (= 2) : Si l'on veut imprimer une moyenne sur la colonne liée (attention, uniquement pour les colonnes numériques, monétaires et booléennes);

      _clapPrintAvecCalculTotal (= 1) : Si l'on veut imprimer un total sur la colonne liée (attention, uniquement pour les colonnes numériques, monétaires et booléennes);

  sImageCombo (chaîne - valeur par défaut=vide) : Contient les transformation de valeur en image (NomLogiqueDeLaColonne + TAB + ValeurAConvertir + TAB + CheminDuFichierImageIllustrantLaValeur) séparés par RC;

      Attention, la valeur à convertir ne peut pas contenir ni de TAB ni de RC !

  sColonneAncrée (chaîne - valeur par défaut=vide) : Nom de la colonne qui est susceptible de s'élargir pour imprimer la table sur toute la largeur de la page;

  sPiedDePage (chaîne - valeur par défaut=vide) : Texte à imprimer en bas de page (1 seule ligne est prise en compte);

  nNumPageDépart (entier - valeur par défaut=1) : Valeur de début de numérotation de page (ne fonctionne que si l'on choisi d'imprimer le numéro de page);

nOptions (entier - valeur par défaut = _clapPrintAvecCadre+_clapPrintAvecSéparateurVertical) : combinaison des constantes ci-dessous

  _clapPrintContenuMultiligne : Imprime le contenu et les titres des colonnes sur plusieurs lignes si nécessaire, sinon sur une seule ligne (défaut);

  _clapPrintAvecCadre : Imprime le cadre qui délimite le contenu (ainsi que la ligne en-dessous du titre et celle au-dessus du bas de page avec la date/l'heure/le # de page s'ils sont choisis), sinon ne l'imprime pas (défaut);

  _clapPrintAvecDate : Imprime la date en bas de page, sinon ne l'imprime pas (défaut);

  _clapPrintAvecHeure : Imprime l'heure en bas de page, sinon ne l'imprime pas (défaut);

  _clapPrintAvecNumPage : Imprime le # de page en bas de page, sinon ne l'imprime pas (défaut);

  _clapPrintAvecTitreColonne : Imprime les titres des colonnes (représente NomDeColonne..titre et non le nom logique de la colonne), sinon ne les imprime pas (défaut);

  _clapPrintForcePortrait : Force l'orientation portrait quand l'ensemble des colonnes dépassent la largeur d'une page portrait, sinon l'orientation passe automatiquement en paysage (défaut);

  _clapPrintAvecSéparateurVertical : Imprime les séparateurs verticaux entre les colonnes (par défaut, en iContinu), sinon n'en imprime pas (défaut);

  _clapPrintAvecSéparateurHorizontal : Imprime les séparateurs horizontaux entre les enregistrements (par défaut, en iContinu), sinon n'en imprime pas (défaut);

  _clapPrintComboValeur : Imprime la valeur (indice) de la combo, sinon imprime la valeur affichée (prioritaire par rapport aux images des combos de l'option sImageCombo) (défaut);

  _clapPrintInterrupteurCoche : Imprime une coche si la valeur booléenne est vrai et vide si la valeur booléenne est fausse, sinon imprime la valeur booléenne 0 ou 1 (défaut);

  _clapPrintNonAssemblée : Assemble ou pas les pages dans le cas ou la table doit être imprimée sur plusieurs pages en largeur (voir remarques);

  _clapPrintEnTonDeGris : Imprime le texte, les lignes et les fonds en tons de gris, sinon imprime en couleur (défaut). Attention, ne gère pas le gris sur les images;

  _clapPrintRépèteTitreChaquePage : Imprime le titre sur chaque page, sinon uniquement sur la première page (défaut);

  _clapPrintRépèteTitreColonneChaquePage : Imprime le titre des colonnes sur chaque page, sinon uniquement sur la première page (défaut);

  _clapPrintForceÉcritureDroiteAGauche : Force l'impression des textes de droite à gauche et les numériques de gauche à droite, sinon prend le sens d'écriture par ordre de priorité : de la table, de la fenêtre, de gauche à droite (défaut);

  _clapPrintRepèteCalculChaquePage : Imprime le résultat des calculs demandés en bas de chaque page (comme des valeurs intermédiaires), sinon le résultat des calculs s'imprime sur la dernière page (défaut);

  _clapPrintAvecImage : Imprime les images (rubrique image), sinon ne les imprime pas (défaut);

  _clapPrintOrientationPortrait : Imprime en orientation portrait, sinon en paysage (défaut);

  _clapPrintMagentaTransparent : Imprime les mémos images et le logo avec une transparence sur la couleur magenta, sinon le magenta est imprimé aussi (défaut);

  _clapPrintColonneCalculée : Sélectionne chaque ligne de la table pour que les colonnes calculées s'affichent correctement (exécution du code "Affichage d'une ligne de table" pour chaque ligne);

  _clapPrintMultiligneTitreColonne : Imprime les titres des colonnes sur plusieurs lignes, sinon sur une seule ligne (défaut);

  _clapPrintLigneSélectionnée : Imprime uniquement les lignes sélectionnées (voir remarques), sinon toutes les lignes (défaut);

  _clapPrintSelonOrigine : Imprime selon les couleurs de la table elle-même. Cette option exploite les couleurs de texte et de fond des lignes paires, des lignes impaires et des cases. Cette option est prioritaire sur le paramétrage de ces mêmes couleurs dans le paramètre sOptions:sCouleurs;

  _clapPrintPasFinImprime : En utilisant cette option, l'instruction iFinImprime() n'est pas lancée à la fin de l'impression (voir remarques)

  _clapPrintRepetePiedChaquePage : Imprime le pied de page sur chaque page, sinon uniquement sur la première page (défaut);

sTitre (chaîne - valeur par défaut=NULL) : Titre de l'impression. S'affichera en haut de la première page (au-dessus des titres de colonnes si demandé, sinon au-dessus des données) et sur toute les autres pages (si demandé avec l'option _clapPrintRépèteTitreChaquePage). Le titre peut contenir des RC pour avoir plusieurs lignes. La première ligne est toujours imprimée avec une police 20% plus grande, les autres lignes auront une taille standard (comme la taille du texte des données). Le titre peut aussi contenir le chemin complet d'une image. Celle-ci s'imprimera dans le coin haut à gauche de la page (voir remarques);

polImprime (police - valeur par défaut=xNomTable..police) : Caractéristique de la police de caractères qui sera utilisée pour imprimer la table (voir remarques);

Valeur de retour

entier : nombre de pages imprimées

Exemple simple

nNbPages est un entier = nImprimeTable(Table_Client..nom,*,*,"Ma table client")
SI nNbPages=0 ET clapPrint.sClapPrintErreur()>"" ALORS Erreur(clapPrint.sClapPrintErreur())   //une erreur est survenue

Procédure 'MargesImprimante'

Résumé

Permet de récupérer les valeurs des marges maximales liées à l'imprimante en cours.

Syntaxe

MargesImprimante(<rMargeHaute> est réel, <rMargeBasse> est réel, <rMargeGauche> est réel, <rMargeDroite> est réel)

Paramètres

rMargeHaute (réel - valeur par défaut=0.0) : valeur de retour de la marge haute de la page

rMargeBasse (réel - valeur par défaut=0.0) : valeur de retour de la marge basse de la page

rMargeGauche (réel - valeur par défaut=0.0) : valeur de retour de la marge gauche de la page

rMargeDroite (réel - valeur par défaut=0.0) : valeur de retour de la marge droite de la page

Valeur de retour

via les paramètres

Exemple

rMargeGauche,rMargeDroite,rMargeHaut,rMargeBas sont des réels
MargesImprimante(rMargeHaut, rMargeBas, rMargeGauche, rMargeDroite)	//met les marges max dans les variables

Constantes

• _clapPrintContenuMultiligne = 1
• _clapPrintAvecCadre = 2
• _clapPrintAvecDate = 4
• _clapPrintAvecHeure = 8
• _clapPrintAvecNumPage = 16
• _clapPrintAvecTitreColonne = 32
• _clapPrintForcePortrait = 64
• _clapPrintAvecSéparateurVertical = 128
• _clapPrintAvecSéparateurHorizontal = 256
• _clapPrintComboValeur = 512
• _clapPrintInterrupteurCoche = 1024
• _clapPrintNonAssemblée = 2048
• _clapPrintEnTonDeGris = 4096
• _clapPrintRépèteTitreChaquePage = 16384
• _clapPrintRépèteTitreColonneChaquePage = 32768
• _clapPrintForceÉcritureDroiteAGauche = 65536
• _clapPrintRepèteCalculChaquePage = 131072
• _clapPrintAvecImage = 262144
• _clapPrintOrientationPortrait = 524288
• _clapPrintMagentaTransparent = 1048576
• _clapPrintColonneCalculée = 2097152
• _clapPrintMultiligneTitreColonne = 4194304
• _clapPrintLigneSélectionnée = 8388608

• _clapPrintAvecCalculTotal = 1
• _clapPrintAvecCalculMoyenne = 2
• _clapPrintAvecCalculCompteur = 4

• _clapPrintCouleurLignePaire = "COULEURPAIRE"
• _clapPrintCouleurLigneImpaire = "COULEURIMPAIRE"
• _clapPrintCouleurTexteDonnéePaire = "COULEURDONNEEPAIRE"
• _clapPrintCouleurTexteDonnéeImpaire = "COULEURDONNEEIMPAIRE"
• _clapPrintCouleurFondPage = "COULEURFONDPAGE"
• _clapPrintCouleurSéparateurVertical = "COULEURVERTICAL"
• _clapPrintCouleurSéparateurHorizontal = "COULEURHORIZONTAL"
• _clapPrintCouleurTexteTitre = "COULEURTITRE"
• _clapPrintCouleurFondTitre = "COULEURFONDTITRE"
• _clapPrintCouleurTexteTitreColonne = "COULEURTITRECOL"
• _clapPrintCouleurFondTitreColonne = "COULEURFONDTITRECOL"
• _clapPrintCouleurCadre = "COULEURCADRE"
• _clapPrintCouleurTextePied = "COULEURPIED"
• _clapPrintCouleurFondPied = "COULEURFONDPIED"

Dysfonctionnements, commentaires et suggestions

Merci de contacter notre support. Vous trouverez nos coordonnées et les conditions bas de notre site internet.

Liens utiles

Utilisation du composant

Détail de la fenêtre FEN_ParamPrint

Téléchargement et licence