LIRE OPTION IMPRESSION

4D v20 R7


LIRE OPTION IMPRESSION ( option ; valeur1 {; valeur2} )

Paramètre	Type	Description
option	Entier long	Numéro d’option ou Code d'option PDF
valeur1	Entier long, Texte	Valeur 1 de l’option
valeur2	Entier long, Texte	Valeur 2 de l’option

Description

La commande LIRE OPTION IMPRESSION retourne la ou les valeur(s) courante(s) d’une option d’impression.

Le paramètre option vous permet de désigner l’option à lire. Vous pouvez passer soit une option standard (entier long), soit un code d'option PDF (chaîne). La commande retourne dans les paramètres valeur1 et (facultativement) valeur2 la ou les valeur(s) courante(s) de l’option spécifiée.

Pour spécifier une option d'impression standard, utilisez l'une des constantes suivantes du thème Options d'impression :

Constante	Type	Valeur	Comment
Option papier	Entier long	1	Si vous passez uniquement valeur1, il contient le nom du papier. Si vous passez les deux paramètres, valeur1 contient la largeur du papier et valeur2 contient la hauteur du papier. La largeur et la hauteur sont exprimées en pixels écran. Utilisez la commande VALEURS OPTION IMPRESSION pour connaître le nom, la hauteur et la largeur de tous les formats de papier proposés par l’imprimante.
Option orientation	Entier long	2	valeur1 uniquement : 1=Portrait, 2=Paysage. Si une option d’orientation différente est utilisée, LIRE OPTION IMPRESSION retourne 0 dans valeur1. Cette option peut être appelée au sein d'une tâche d'impression, ce qui signifie que vous pouvez passer du mode portrait au mode paysage et inversement dans la même tâche d'impression.
Option échelle	Entier long	3	valeur1 uniquement : valeur d'échelle en pourcentage. Attention, certaines imprimantes ne permettent pas de modifier l’échelle. Si vous passez une valeur invalide, la propriété est remise à 100% au moment de l'impression.
Option nombre copies	Entier long	4	valeur1 uniquement : nombre de copies à imprimer
Option alimentation	Entier long	5	(Windows uniqument) valeur1 uniquement : numéro correspondant à l’indice, dans le tableau des bacs retourné par la commande VALEURS OPTION IMPRESSION, du bac papier à utiliser. Cette option est utilisable sous Windows uniquement.
Option destination	Entier long	9	valeur1: code indiquant le type de destination de l’impression : 1=Imprimante, 2=Fichier (PC)/PS (Mac), 3=Fichier PDF, 5=Ecran (option du pilote OS X) Si valeur1 est différent de 1 ou de 5, valeur2 contient un chemin d’accès pour le document résultant. Ce chemin sera utilisé jusqu’à ce qu’un autre chemin soit spécifié. Si un fichier du même nom existe déjà à l’emplacement de destination, il est remplacé. Avec LIRE OPTION IMPRESSION, si la valeur courante n’est pas dans la liste prédéfinie, valeur1 contient -1 et la variable système OK vaut 1. Si une erreur se produit, valeur1 et la variable système OK valent 0. Note (sous Windows) : Pour imprimer un PDF sous Windows, vous devez appeler FIXER IMPRIMANTE COURANTE(Driver PDF générique) et définir la destination d'impression 2 (Fichier) ou 3 (Fichier PDF). La destination d'impression 3 vous permet d'écrire du code multi-plate-forme. De plus, si le pilote PDF Creator a été installé et si une imprimante standard a été sélectionnée, lorsque les valeurs (9;3;chemin) sont passées, 4D lance automatiquement une impression PDF "silencieuse" et prend en compte les codes d'options éventuellement passés (à noter que si vous passez une chaîne vide dans valeur2 ou omettez ce paramètre, une boîte de dialogue d’enregistrement de fichier apparaît au moment de l’impression). A l'issue de l'impression, les paramétrages courants sont restaurés.
Option recto verso	Entier long	11	valeur1: 0=Recto ou standard, 1=Recto-verso. Si valeur1=1, valeur2 contient la reliure à appliquer : 0=Reliure à gauche (valeur par défaut), 1=Reliure en haut.
Option nom document à imprimer	Entier long	12	valeur1 uniquement : nom du document d’impression, qui apparaît dans la liste des documents du serveur d’impression. Le nom défini par cette instruction sera utilisé pour tous les documents d’impression de la session tant qu’un nouveau nom ou une chaîne vide ne sera pas passé(e). Pour utiliser ou rétablir le fonctionnement standard (utilisation du nom de la méthode dans le cas d’une méthode, nom de la table pour un enregistrement, etc.), passez une chaîne vide dans valeur1.
Option intervalle de page	Entier long	15	valeur1=numéro de la première page à imprimer (valeur par défaut 1) et (optionnel) valeur2=numéro de la dernière page à imprimer (valeur par défaut -1 = fin du document).
Option ancienne couche impression	Entier long	16	(Windows uniquement) valeur1 uniquement : 1=sélectionner l'ancienne couche d'impression GDI pour toutes les tâches d'impression suivantes, 0=sélectionner la couche d'impression D2D (défaut). Ce sélecteur est principalement destiné, dans les applications 4D sous Windows, à permettre aux plug-ins d'ancienne génération d'imprimer dans des tâches d'impression 4D.
Option d'aperçu avant impression	Entier long	18	(Uniquement pour Windows) valeur1 : Format à utiliser pour les aperçus avant impression sous Windows. Valeurs disponibles : kp aperçu automatique (par défaut) : Utiliser l'imprimante et la visionneuse XPS si elles sont disponibles, sinon utiliser l'imprimante ou la visionneuse PDF si elles sont disponibles, sinon générer une erreur.. kp aperçu XPS : Utiliser l'imprimante et la visionneuse XPS si elle est disponible, sinon générer une erreur. kp aperçu PDF : Utiliser l'imprimante et la visionneuse PDF si elles sont disponibles, sinon générer une erreur. valeur2 (ne peut être utilisé qu'avec LIRE OPTION IMPRESSION.): Format d'aperçu avant impression utilisé sous Windows (peut différer de la valeur1 en fonction de la configuration). Valeurs disponibles : kp aucun aperçu : Aucun format disponible. kp aperçu XPS : Imprimante et visionneuse XPS utilisées. kp aperçu PDF : Imprimante et visionneuse PDF utilisées.

Un code d’option PDF est constitué de deux parties, TypeOption et NomOption, assemblées sous la forme "TypeOption:NomOption". Pour plus d'informations sur les codes d'option PDF et les valeurs possibles, reportez-vous à la description de la commande FIXER OPTION IMPRESSION.

Note : La commande LIRE OPTION IMPRESSION prend principalement en charge les imprimantes PostScript. Elle peut être utilisée avec d'autres types d'imprimantes, telles que PCL ou Ink, mais dans ce cas il est possible que certaines options ne soient pas disponibles.

Variables et ensembles système

La variable système OK prend la valeur 1 si la commande a été exécutée correctement, sinon elle prend la valeur 0.

Voir aussi

FIXER OPTION IMPRESSION
VALEURS OPTION IMPRESSION