[API] DocumentProperties : Modifier les paramètres d'impression par programmation

Version imprimable

Bonjour à tous !

Dans l'épisode précédent, nous avons vu comment récupérer les informations contenues dans une structure DEVMODE via l'API DocumentProperties (Merci JBO).

Aujourd'hui nous allons essayer de comprendre comment modifier les paramètres d'impression de notre chère imprimante par programmation via la même API.

Tout d'abord, voici la doc MSDN à ce sujet :

Citation:

To make changes to print settings that are local to an application, an application should follow these steps:

1. Get the number of bytes required for the full DEVMODE structure by calling DocumentProperties and specifying zero in the fMode parameter.
2. Allocate memory for the full DEVMODE structure.
3. Get the current printer settings by calling DocumentProperties. Pass a pointer to the DEVMODE structure allocated in Step 2 as the pDevModeOutput parameter and specify the DM_OUT_BUFFER value.
4. Modify the appropriate members of the returned DEVMODE structure and indicate which members were changed by setting the corresponding bits in the dmFields member of the DEVMODE.
5. Call DocumentProperties and pass the modified DEVMODE structure back as both the pDevModeInput and pDevModeOutput parameters and specify both the DM_IN_BUFFER and DM_OUT_BUFFER values (which are combined using the OR operator).The DEVMODE structure returned by the third call to DocumentProperties can be used as an argument in a call to the CreateDC function.

Tout est clair jusqu'au 4. : Il est dit dans la doc MSDN qu'il faut vérifier que le changement que l'on veut faire est possible en regardant la valeur contenue dans la variable dmFields de la structure DEVMODE.
Source :

Citation:

Often, an element of the DEVMODE structure pointed to by pDevMode will be modified (instead of an element of PRINTER_INFO_n). When this is the case, the pDevMode->dmFields flags will tell the application which fields can be changed. Because this is given to you by GetPrinter(), you can check the dmFields flag before attempting the change.

Contenu de la variable dmFields :

Citation:

dmFields

DWORD that specifies whether certain members of the DEVMODE structure have been initialized.

If a member is initialized, its corresponding bit is set, otherwise the bit is clear.

A printer driver supports only those member of the DEVMODE structure that are appropriate for the printer technology.

La valeur de la variable dmFields est donc une combinaison de différentes valeurs en rapport avec les constantes suivantes :
Code:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 //**************************************** DEVMODE dmFields flags ********************************************* DM_BITSPERPEL=262144//0x00040000L DM_COLLATE=32768//0x00008000L DM_COLOR=2048//0x00000800L DM_COPIES=256//0x00000100L DM_COPY=2//2 DM_DEFAULTSOURCE=512//0x00000200L DM_DISPLAYFLAGS=2097152//0x00200000L DM_DISPLAYFREQUENCY=4194304//0x00400000L DM_DITHERTYPE=268435456//0x10000000L DM_DUPLEX=4096//0x00001000L DM_FORMNAME=65536//0x00010000L DM_GETDEFID=1024//(WM_USER+0) DM_ICCMANUFACTURER=536870912//0x20000000L DM_ICCMODEL=1073741824//0x40000000L DM_ICMINTENT=67108864//0x04000000L DM_ICMMETHOD=33554432//0x02000000L DM_LOGPIXELS=131072//0x00020000L DM_MEDIATYPE=134217728//0x08000000L DM_MODIFY=8//8 DM_ORIENTATION=1//0x00000001L DM_OUT_DEFAULT=1//DM_UPDATE DM_PANNINGHEIGHT=16777216//0x01000000L DM_PANNINGWIDTH=8388608//0x00800000L DM_PAPERLENGTH=4//0x00000004L DM_PAPERSIZE=2//0x00000002L DM_PAPERWIDTH=8//0x00000008L DM_PELSHEIGHT=1048576//0x00100000L DM_PELSWIDTH=524288//0x00080000L DM_PRINTQUALITY=1024//0x00000400L DM_PROMPT=4//4 DM_REPOSITION=1026//(WM_USER+2) DM_SCALE=16//0x00000010L DM_SETDEFID=1025//(WM_USER+1) DM_SPECVERSION=1025//0x0401 DM_TTOPTION=16384//0x00004000L DM_UPDATE=1//1 DM_YRESOLUTION=8192//0x00002000L
Comment savoir à quoi à quelles constantes correspond la valeur de dmFields (Vous pouvez éventuellement utiliser la valeur que j'ai pour mon imprimante pour exemple : 1851155).
En C (++ ou #, je n'en ai aucune idée :oops:) le bout de code suivant vérifie que le driver supporte le changement d'orientation de l'impression (portrait/paysage) :
Code:

1 2 3 4 if (!(pi2->pDevMode->dmFields & DM_ORIENTATION)) { ... }
A quel opérateur du W langage correspond l'opérateur " & " ?
Dans la foulée, comment combiner plusieurs constantes et les affecter à dmFields ?

En C (++ ou #) la syntaxe est la suivante :

Code:

lpDevMode->dmFields = DM_ORIENTATION | DM_PRINTQUALITY;

A quel opérateur du W langage correspond l'opérateur " | " ?

De la même manière la ligne suivante plante mon application lors de son appel (sans message d'erreur, l'application se ferme) :

Code:

nReturnValue = API("WINSPOOL.DRV", "DocumentPropertiesA", Handle(), nPrinterHandle, &szSDeviceName, &MyPRINTER_INFO_2:pDevMode, &MyPRINTER_INFO_2:pDevMode, DM_IN_BUFFER OU DM_OUT_BUFFER)

L'erreur vient probablement de l'expression "DM_IN_BUFFER OU DM_OUT_BUFFER", problème qui sera résolu lorsque la question précédente aura trouvé une réponse

C'est à peu près tout pour le moment, je reviendrai à la charge avec quelques questions subsidiaires à l'occasion :)

Merci d'avance !

[Edit] J'utilise WD14 version 01F140030f et WinXP SP3, si cela peut avoir son importance

27/04/2010, 14h14
VincentRoy

pour

Code:

lpDevMode->dmFields = DM_ORIENTATION | DM_PRINTQUALITY;

tu peux utiliser la fonction oubinaire:

Code:

lpDevMode:dmFields = oubinaire(DM_ORIENTATION,DM_PRINTQUALITY)

A+

Vince

http://www.ennovsys.fr

Edit: Je crois aussi que l'opérateur | en Windev fonctionne.

Citation:

Tu peux utiliser la fonction oubinaire

Citation:

Je crois aussi que l'opérateur | en Windev fonctionne.

Merci Vincent !

Je viens de tester les deux ... et les deux marchent, bien qu'il qu'il n'y ait rien dans l'aide de WD à propos de l'opérateur " | ".

Et c'est tant mieux car la fonction OuBinaire() ne permet d'inclure que 2 paramètres, ennuyeux lorsqu'on veut modifier plus de 2 options d'impression (par exemple).

Voici le code fonctionnel pour information :
Code:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 PROCEDURE PR_PRINTER_SetDocumentProperties(sNomImprimante est une chaîne) MyPRINTER_INFO_2 est un STPRINTER_INFO_2 MyPrinterDefaults est un STPRINTER_DEFAULTSA bufMyPrinterBuffer est un Buffer MyDEVMODE est un STDEVMODE bufMyDevModeBuffer est un Buffer nReturnValue est un entier bufBuffer est un Buffer szPrinterName est une chaîne ASCIIZ sur 128 szDriverName est une chaîne ASCIIZ sur 128 nPrinterHandle est un entier système // Récupération d'un buffer contenant les informations pour "nourrir" une structure PRINTER_INFO_2 bufMyPrinterBuffer = FU_PRINTER_GetPrinter(sNomImprimante) // Transfert des données vers les structures adéquates Transfert(&MyPRINTER_INFO_2, &bufMyPrinterBuffer, Dimension(MyPRINTER_INFO_2)) // Récupération du nom de l'imprimante et du driver szPrinterName = sNomImprimante Transfert(&szDriverName, MyPRINTER_INFO_2:pDriverName, 128) MyPrinterDefaults:pDatatype = Null MyPrinterDefaults:pDatatype = Null MyPrinterDefaults:DesiredAccess = PRINTER_ALL_ACCESS // Obtention du handle de l'imprimante nReturnValue = API("WINSPOOL.DRV","OpenPrinterA",&szPrinterName,&nPrinterHandle, &MyPrinterDefaults) // Récupération du DEVMODE à partir de PRINTER_INFO_2 Transfert(&MyDEVMODE, MyPRINTER_INFO_2:pDevMode, Dimension(MyDEVMODE)) // Changement du nombre de copies à imprimer MyDEVMODE:dmFields = DM_COPIES MyDEVMODE:dmCopies = 4 // Affectation du DEVMODE modifié à la structure PRINTER_INFO_2 Transfert(MyPRINTER_INFO_2:pDevMode, &MyDEVMODE, Dimension(MyDEVMODE)) // Mise à jour des informations (temporaire) du driver de l'imprimante nReturnValue = API("WINSPOOL.DRV", "DocumentPropertiesA", Null, nPrinterHandle, &szPrinterName, MyPRINTER_INFO_2:pDevMode, MyPRINTER_INFO_2:pDevMode, DM_IN_BUFFER | DM_OUT_BUFFER) nReturnValue = API("WINSPOOL.DRV","SetPrinterA",nPrinterHandle, 2, &MyPRINTER_INFO_2, 0) //************ INCLU POUR TEST **************************************** MyDEVMODE:dmCopies = 0 // Récupération d'un buffer contenant les informations pour "nourrir" une structure PRINTER_INFO_2 bufMyPrinterBuffer = FU_PRINTER_GetPrinter(sNomImprimante) // Transfert des données vers les structures adéquates Transfert(&MyPRINTER_INFO_2, &bufMyPrinterBuffer, Dimension(MyPRINTER_INFO_2)) Transfert(&MyDEVMODE, MyPRINTER_INFO_2:pDevMode, Dimension(MyDEVMODE)) Info(MyDEVMODE:dmCopies) //********************************************************************* // Fermeture de l'imprimante API("WINSPOOL.DRV","ClosePrinter",nPrinterHandle) CAS EXCEPTION: nReturnValue = ErreurInfo(errCodeSystème) sErrorMessage est une chaîne = ErreurInfo(errMessageSystème) Info("Error Code : " +nReturnValue +RC +"Error Message : " +sErrorMessage)
(original) dmCopies = 0
(après modification) dmCopies = 4

Cela fonctionne donc !

Par contre, je ne sait toujours pas décomposer une valeur entière en combinaison de constantes. Par exemple savoir si DM_COPIES fait partie de la combinaison de dmFields (pi2->pDevMode->dmFields & DM_ORIENTATION en C (++ ou #))
J'ai testé avec EtBinaire (on sait jamais), mais cela n'a pas fonctionné.
Si quelqu'un à une idée, je prends 8-)

[Edit] - Une erreur inattention qui s'était glissée dans mon code faisait que ETBinaire retournait systématiquement faux. Cela fonctionne maintenant de deux manières différentes :
ETBinaire(MyDEVMODE:dmFields, DM_COPIES) retourne vrai et
(MyDEVMODE:dmFields & DM_COPIES) retourne vrai aussi !

Code modifié pour mise à jour permanente du driver via SetPrinter() (+modification des droits d'accès au périphérique)

Merci Vincent de m'avoir mis sur la piste

A+