SCR/AL1 - TOME III. Les librairies utilitaires
19. Le groupe s_a2m
19.11 A2mToGdiPrinter (file s_a2mgdi.c:177)
Syntax
A2mToGdiPrinter(hWndOwner, Dlg, JobTitle, a2mfile)
HWND hWndOwner;
int Dlg;
U_ch *JobTitle;
U_ch *a2mfile;
Description
Interprète le contenu d'un fichier a2m et l'imprime sur une imprimante définie dans le système Win32.
- hWndOwner = fenêtre propriétaire de la tâche
- Dlg = 0 pour ne pas afficher la boîte de dialogue de configuration de l'imprimante, 1 pour l'afficher. Dans ce dernier cas, l'impression peut se faire sur une imprimante spécifique.
- JobTitle = nom du job
- a2mfile = nom du fichier a2m à imprimer
Valeur retournée
La fonction retourne 0 si le processus s'est bien déroulé, -1 sinon. Si le job est annulé par l'utilisateur (Dlg == 1 et Cancel), la fonction retourne aussi -1.
La syntaxe des fichiers a2m est décrite dans un chapitre spécifique.
Fichier a2m.ini
Le fichier a2m.ini (ou un autre) contient des paramètres pour l'impression et la lecture du fichier a2m. Pour que ces paramètres soient pris en compte par le programme A2mToGdiPrinter(), il faut appeler la fonction A2mGdiReadIni(filename) avant de lancer la fonction d'interprétation et d'impression.
#include <s_a2m.h>
A2mGdiReadIni("myfile.ini");
A2mToGdiPrinter(0L, 1, "Job Title", "myfile.a2m");
Variables globales
Les variables globales décrites dans le fichier .ini peuvent également être modifiées dans le programme.
Variables influençant la lecture du fichier
Ces variables sont définies dans la section [A2M] du fichier ini.
- int A2M_ESCCH = caractère d'escape (enrichissements et caractères spéciaux) : '\'par défaut
- int A2M_CMDCH = caractère de commande ('.' par défaut) spéciaux)
- int A2M_DEFCH = caractère préfixant les macros ('&' par défaut)
- int A2M_SEPCH = caractère de séparation des cellules ('&' par défaut)
- int A2M_LFON = conserve les linefeed (1) ou non (0)
- int A2M_BLON = conserve les blancs (1) ou non (0)
- char A2M_CURTAG[41] = paragraphe par défaut ("par_0")
Variables influençant l'impression
Ces variables sont définies dans la section [GDI] du fichier .ini.
- int A2M_FONTSIZE = taille par défaut des caractères dans les paragraphes (10 pts par défaut)
- int A2M_FONTFAMILY = police de caractère par défaut ('H', 'T' ou 'C')
- int A2M_FONTINCR = incrément de taille de caractères (2 par défaut)
- int A2M_TFONTSIZE = taille par défaut des caractères dans les tableaux (8 pts par défaut)
- U_ch *A2M_PGHEAD = titre de page ("" par défaut)
- U_ch *A2M_PGFOOT = pied de page ("" par défaut)
- int A2M_TSHADING_COL[2] = couleurs de la brosse de hachurage des titres([0]) et corps([1]) des tableaux
- 0 = noir
- 1 = blanc
- 2 = rouge
- 3 = vert
- 4 = bleu
- 5 = cyan
- 6 = magenta
- 7 = jaune
- int A2M_TSHADING_BRUSH[2] = brosse de hachurage des titres([0]) et corps([1]) des tableaux
- 7 = 50%
- 6 = 25%
- 5 = 12%
- 4 = 6%
- 3 = 3%
- 0-2 = 0%
- int A2M_GDI_COLOR = 1 (dft) pour impression en couleur, 0 en B/W
- int A2M_GDI_TBORDER = épaisseur des cadres des tableaux (2 par dft)
- int A2M_GDI_LMARG = marge de gauche de la page (12 pts par dft)
- int A2M_GDI_RMARG = marge de droite de la page (12 pts par dft)
- int A2M_GDI_TMARG = marge de haut de la page (12 pts par dft)
- int A2M_GDI_BMARG = marge de bas de la page (12 pts par dft)
Valeur retournée
- 0 en cas de succès
- -1 si le fichier ne peut être ouvert
- -2 si l'imprimante n'a pû être initialisée ou si l'utilisateur a pressé sur Cancel dans le panneau d'impression
Voir également
A2mGdiReadIni(), A2mToGdiEMF, A2mToRtf(), A2mToMif(), A2mToHtml(), A2mPrintError()
19.11.1 File s_a2mgdi.c
A2mGdiReadIni(filename)
A2mToGdiPrinter(hWndOwner, Dlg, JobTitle, a2mfile)