ClapPrint - Entrées et sorties

De Wiki de Lapalys
Aller à la navigation Aller à la recherche

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

Fonction 'sImprimeTable'

Résumé
Imprime la table passée en paramètre. Cette table peut être une table mémoire/fichier et/ou une table classique/hiérarchique. 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

sImprimeTable (<xNomTable> [, <nOptions> est un entier [, <rHauteurMaxLigne> est un réel [, <nNbPagesMax> est un entier [, <sTitre> est une chaîne [, <polImprime> est une Police [, <sCouleurs> est une chaîne [, <sCalculs> est une chaîne [, <sImageCombo> est une chaîne [, <sFormatDate> est une chaîne [, <sFormatHeure> est une chaîne [, <sFormatMonétaire> est une chaîne ]]]]]]]]]]])


Paramètres
xNomTable : Nom complet de la table avec le nom de la fenêtre (soit Table..nom, soit avec guillemets)
nOptions (entier - valeur par défaut = _ImprimeAvecCadre+_ImprimeAvecSéparateurVertical) : combinaison des constantes ci-dessous
  _ImprimeMultiligne : Imprime le contenu et les titres des colonnes sur plusieurs lignes si nécessaire, sinon sur une seule ligne (défaut);
  _ImprimeAvecCadre : 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);
  _ImprimeAvecDate : Imprime la date en bas de page, sinon ne l'imprime pas (défaut);
  _ImprimeAvecHeure : Imprime l'heure en bas de page, sinon ne l'imprime pas (défaut);
  _ImprimeAvecNumPage : Imprime le # de page en bas de page, sinon ne l'imprime pas (défaut);
  _ImprimeAvecTitreColonne : Imprime les titres des colonnes (représente NomDeColonne..titre et non le nom logique de la colonne), sinon ne les imprime pas (défaut);
  _ImprimeForcePortrait : 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);
  _ImprimeAvecSéparateurVertical : Imprime les séparateurs verticaux entre les colonnes (par défaut, en iContinu), sinon n'en imprime pas (défaut);
  _ImprimeAvecSéparateurHorizontal : Imprime les séparateurs horizontaux entre les enregistrements (par défaut, en iContinu), sinon n'en imprime pas (défaut);
  _ImprimeComboValeur : Imprime la valeur (indice) de la combo, sinon imprime la valeur affichée (prioritaire par rapport aux image des combos de l'option sImageCombo) (défaut);
  _ImprimeInterrupteurCoche : 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);
  _ImprimeNonAssemblée : Assemble ou pas les pages dans le cas ou la table doit être imprimée sur plusieurs pages en largeur (voir remarques)
  _ImprimeEnTonDeGris : Imprime en tons de gris, sinon imprime en couleur (défaut);
  _ImprimeRépèteTitreChaquePage : Imprime le titre sur chaque page, sinon uniquement sur la première page (défaut);
  _ImprimeRépèteTitreColonneChaquePage : Imprime le titre des colonnes sur chaque page, sinon uniquement sur la première page (défaut);
  _ImprimeForceÉ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);
  _ImprimeRepè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);
  _ImprimeAvecImage : Imprime les images, sinon ne les imprime pas (défaut);
  _ImprimeOrientationPortrait : Imprime en orientation portrait, sinon en paysage (défaut);
  _ImprimeMagentaTransparent : Imprime les images avec une transparence sur la couleur magenta, sinon le magenta est imprimé aussi (défaut);
  _ImprimeColonneCalculée : Sélectionne chaque ligne de la table pour que les colonnes calculées s'affichent correctement;
rHauteurMaxLigne (réel - valeur par défaut=0.0) : Hauteur d'une ligne de données (est influencé par le facteur de "zoom");
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);
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é);
polImprime (police - valeur par défaut=xNomTable..police) : Caractéristique de la police de caractère qui sera utilisée pour imprimer la table;
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 :
  _ImprimeCouleurLignePaire (="COULEURPAIRE") : Couleur de fond des lignes paires (par défaut : blanc) de 0 a 16777216 (voir la documentation PC SOFT);
  _ImprimeCouleurLigneImpaire (="COULEURIMPAIRE") : Couleur de fond des lignes impaires (par défaut : blanc) de 0 a 16777216 (voir la documentation PC SOFT);
  _ImprimeCouleurTexteDonnée (="COULEURDONNEE") : Couleur de caractère des données (par défaut : noir) de 0 a 16777216 (voir la documentation PC SOFT);
  _ImprimeCouleurFondPage (="COULEURFONDPAGE") : 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);
  _ImprimeCouleurSéparateurVertical (="COULEURVERTICAL") : Couleur de trait des séparateurs verticaux (par défaut : noir) de 0 a 16777216 (voir la documentation PC SOFT);
  _ImprimeCouleurSéparateurHorizontal (="COULEURHORIZONTAL") : Couleur de trait des séparateurs horizontaux (par défaut : noir) de 0 a 16777216 (voir la documentation PC SOFT);
  _ImprimeCouleurTexteTitre (="COULEURTITRE") : Couleur de caractère du titre (par défaut : noir) de 0 a 16777216 (voir la documentation PC SOFT);
  _ImprimeCouleurFondTitre (="COULEURFONDTITRE") : Couleur de fond du titre (par défaut : blanc) de 0 a 16777216 (voir la documentation PC SOFT);
  _ImprimeCouleurCadre (="COULEURCADRE") : 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);
  _ImprimeCouleurTexteTitreColonne (="COULEURTITRECOL") : Couleur de caractère du titre des colonnes (par défaut : noir) de 0 a 16777216 (voir la documentation PC SOFT);
  _ImprimeCouleurFondTitreColonne (="COULEURFONDTITRECOL") : 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;
  _ImprimeAvecCalculCompteur (= 4) : si l'on veut imprimer un compteur sur la colonne liée;
  _ImprimeAvecCalculMoyenne (= 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);
  _ImprimeAvecCalculTotal (= 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) : Doit contenu les paramètres d'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 !
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;


Valeur de retour

chaîne : erreur détectée dans les paramètres


Exemple simple
sErreur est une chaîne = sImprimeTable(Table_Client..nom,*,*,0,"Ma table client")


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

  • _ImprimeMultiligne = 1
  • _ImprimeAvecCadre = 2
  • _ImprimeAvecDate = 4
  • _ImprimeAvecHeure = 8
  • _ImprimeAvecNumPage = 16
  • _ImprimeAvecTitreColonne = 32
  • _ImprimeForcePortrait = 64
  • _ImprimeAvecSéparateurVertical = 128
  • _ImprimeAvecSéparateurHorizontal = 256
  • _ImprimeComboValeur = 512
  • _ImprimeInterrupteurCoche = 1024
  • _ImprimeNonAssemblée = 2048
  • _ImprimeEnTonDeGris = 4096
  • _ImprimeRépèteTitreChaquePage = 16384
  • _ImprimeRépèteTitreColonneChaquePage = 32768
  • _ImprimeForceÉcritureDroiteAGauche = 65536
  • _ImprimeRepèteCalculChaquePage = 131072
  • _ImprimeAvecImage = 262144
  • _ImprimeOrientationPortrait = 524288
  • _ImprimeMagentaTransparent = 1048576
  • _ImprimeColonneCalculée = 2097152
  • _ImprimeAvecCalculTotal = 1
  • _ImprimeAvecCalculMoyenne = 2
  • _ImprimeAvecCalculCompteur = 4
  • _ImprimeCouleurLignePaire = "COULEURPAIRE"
  • _ImprimeCouleurLigneImpaire = "COULEURIMPAIRE"
  • _ImprimeCouleurTexteDonnée = "COULEURDONNEE"
  • _ImprimeCouleurFondPage = "COULEURFONDPAGE"
  • _ImprimeCouleurSéparateurVertical = "COULEURVERTICAL"
  • _ImprimeCouleurSéparateurHorizontal = "COULEURHORIZONTAL"
  • _ImprimeCouleurTexteTitre = "COULEURTITRE"
  • _ImprimeCouleurFondTitre = "COULEURFONDTITRE"
  • _ImprimeCouleurTexteTitreColonne = "COULEURTITRECOL"
  • _ImprimeCouleurFondTitreColonne = "COULEURFONDTITRECOL"
  • _ImprimeCouleurCadre = "COULEURCADRE"


Dysfonctionnements, commentaires et suggestions

Lapalys met à votre disposition un forum de discussion sur le site www.lapalys.ca dans lequel pour pouvez partager vos expériences et proposer des évolutions. Nous vous répondrons dans les plus brefs délais.

Pour intervenir sur notre forum, vous devez vous enregistrer sur notre site.


Liens utiles

Utilisation du composant

Détail de la fenêtre FEN_ParamPrint

Téléchargement et licence