SET CURRENT PRINTER

4D v16.3

SET CURRENT PRINTER


SET CURRENT PRINTER ( nomImpr )

Paramètre	Type	Description
nomImpr	Chaîne	Nom de l’imprimante à utiliser

Description

La commande SET CURRENT PRINTER permet de désigner l’imprimante à utiliser pour les impressions avec l’application 4D courante.

Passez dans le paramètre nomImpr le nom de l’imprimante à sélectionner. Pour obtenir la liste des imprimantes disponibles, utilisez au préalable la commande PRINTERS LIST.
Si vous passez une chaîne vide dans nomImpr, l’imprimante courante définie dans le système sera utilisée.

SET CURRENT PRINTER vous permet de désigner l'imprimante PDF générique du système afin d'effectuer des impressions PDF. La valeur à utiliser dépend de la version de l'OS et de celle de 4D.

Windows 8 et versions précédentes :
4D s’appuie sur le pilote PDFCreator pour l’impression de documents PDF sous Windows (cf. section Intégration du pilote PDFCreator sous Windows). Pour imprimer un document PDF, passez dans le paramètre nomImpr le nom de l’imprimante virtuelle installée par PDFCreator. Par défaut, le nom de l’imprimante virtuelle est "PDFCreator". Toutefois, ce nom peut avoir été modifié au moment de l’installation du pilote. Pour que 4D recherche et utilise automatiquement le nom de l’imprimante virtuelle, même s’il a été personnalisé, vous pouvez passer dans nomImpr la constante suivante (thème Options d'impression) :

Constante	Type	Valeur
PDFCreator Printer name	Chaîne	PDFCreator

A partir de Windows 10 :
Windows 10 inclut un pilote d'impression PDF natif, permettant à 4D de créer directement des PDFs sans qu'il soit nécessaire d'utiliser un pilote tiers comme PDFCreator.
Le nom du pilote est "Microsoft Print to PDF" (cf. exemple présenté dans la section Intégration du pilote PDFCreator sous Windows).

Sous OS X et à partir de Windows 10 (4D v15 R5 64 bits et suivantes) :
Une constante du thème Options d'impression vous permet de désigner automatiquement l'imprimante PDF générique, quelle que soit la plate-forme. Ce principe facilite l'écriture de code générique.

Constante	Type	Valeur	Comment
Generic PDF driver	Chaîne	_4d_pdf_printer	Note : Cette fonctionnalité n'est pas disponible dans les versions 32 bits de 4D. Sous OS X, déclare le pilote par défaut comme imprimante courante. Ce pilote n'est pas visible et ne se trouve pas dans la liste retournée par la commande PRINTERS LIST. Notez que le chemin d’accès pour le document PDF doit être défini en utilisant la commande SET PRINT OPTION, sinon l'erreur 3107 est retournée. Sous Windows, déclare le pilote PDF de Windows (nommé "Microsoft Print to PDF") comme imprimante courante. Cette constante est disponible sous Windows 10 uniquement, lorsque l'option PDF est installée. Avec d'autres versions de Windows, ou lorsqu'il n'y a pas de pilote PDF disponible, la commande ne fait rien et la variable système OK prend la valeur 0.

La commande SET CURRENT PRINTER doit être appelée avant SET PRINT OPTION afin que les options disponibles correspondent à l'imprimante sélectionnée. En revanche, SET CURRENT PRINTER doit être appelée après PAGE SETUP (le cas échéant), sinon le paramétrage d'imprimante n'est pas conservé.

Cette commande peut être utilisée avec les commandes PRINT SELECTION, PRINT RECORD, Print form, QR REPORT et s’applique à toutes les impressions de 4D, y compris en mode Développement.
Les commandes d'impression doivent impérativement être appelées avec le paramètre > (le cas échéant) afin que le paramétrage défini soit conservé.

Variables et ensembles système

Si la sélection d’imprimante est correctement effectuée, la variable système OK prend la valeur 1. Dans le cas contraire (par exemple l’imprimante désignée est introuvable), la variable système OK prend la valeur 0 et l’imprimante courante est inchangée.

Exemple

Création d'un document PDF sous Windows 10 avec 4D Developer Edition 64 bits :

 C_TEXT($pdfpath)

 $pdfpath:=System folder(Desktop)+"test.pdf"

 SET CURRENT PRINTER(Generic PDF driver)

 SET PRINT OPTION(Destination option;2;$pdfpath)

 ALL RECORDS([Table_1])

 PRINT SELECTION([Table_1];*)

 SET CURRENT PRINTER("")

Voir aussi

Get current printer
PRINTERS LIST