printer_set_option

(PECL printer SVN)

printer_set_optionConfigure la connexion à l'imprimante

Description

bool printer_set_option ( resource $printer_handle , int $option , mixed $value )

Configure la connexion à l'imprimante.

Liste de paramètres

printer_handle

printer_handle doit être une ressource d'imprimante valide.

option

Peut être l'une des constantes suivantes :

  • PRINTER_COPIES : indique le nombre de copies à imprimer. value doit être un entier.
  • PRINTER_MODE : spécifie le type de data ("text", "raw" ou "emf"), valuedoit être une chaîne de caractères.
  • PRINTER_TITLE : spécifie le nom du document, value doit être une chaîne de caractères.
  • PRINTER_ORIENTATION : spécifie l'orientation du papier, value peut être PRINTER_ORIENTATION_PORTRAIT ou PRINTER_ORIENTATION_LANDSCAPE
  • PRINTER_RESOLUTION_Y : spécifie la résolution en ordonnées, en DPI, value doit être un entier.
  • PRINTER_RESOLUTION_X : spécifie la résolution en abscisse, en DPI, value doit être un entier.
  • PRINTER_PAPER_FORMAT : spécifie un format de papier prédéfini : donnez à value la valeur de PRINTER_FORMAT_CUSTOM si vous souhaitez utiliser un format de papier personnalisé, grâce aux constantes PRINTER_PAPER_WIDTH et PRINTER_PAPER_LENGTH. value peut alors être l'une des constantes suivantes :
    • PRINTER_FORMAT_CUSTOM : vous laisse spécifier le format de papier.
    • PRINTER_FORMAT_LETTER : spécifie le format standard "letter" (8 1/2 par 11 pouces (2.54cm)).
    • PRINTER_FORMAT_LEGAL : spécifie le format standard "legal" (8 1/2 par 14 pouces (2.54cm)).
    • PRINTER_FORMAT_A3 : spécifie le format standard "A3" (297 par 420 millimètres).
    • PRINTER_FORMAT_A4 : spécifie le format standard "A4" (210 par 297 millimètres).
    • PRINTER_FORMAT_A5 : spécifie le format standard "A5" (148 par 210 millimètres).
    • PRINTER_FORMAT_B4: spécifies le format standard B4 (250 par 354 millimètres).
    • PRINTER_FORMAT_B5 : spécifie le format standard "B5" (182 par 257 millimètres).
    • PRINTER_FORMAT_FOLIO : spécifie le format standard "FOLIO" (8 1/2 par 13 pouces (2.54cm)).
  • PRINTER_PAPER_LENGTH : si PRINTER_PAPER_FORMAT vaut PRINTER_FORMAT_CUSTOM, PRINTER_PAPER_LENGTH spécifie une longueur personnalisée de papier, en millimètres. value doit être un entier.
  • PRINTER_PAPER_WIDTH : si PRINTER_PAPER_FORMAT vaut PRINTER_FORMAT_CUSTOM, PRINTER_PAPER_WIDTH spécifie une largeur personnalisée de papier, en millimètres. value doit être un entier.
  • PRINTER_SCALE : spécifie le facteur de mise à l'échelle du document. La taille physique de la page imprimée est alors mise à l'échelle avec un facteur égal à value/100. Par exemple, si vous donnez un facteur d'échelle de 50, l'impression sera de la moitié de la taille du document original. value doit être un entier.
  • PRINTER_BACKGROUND_COLOR : spécifie la couleur de fond pour le contexte actuel. value doit être une chaîne de caractères contenant une couleur au format RGB hexadécimal : par exemple, "005533".
  • PRINTER_TEXT_COLOR : spécifie la couleur du texte pour ce contexte d'imprimante. value doit être une chaîne de caractères contenant une couleur au format RGB hexadécimal : par exemple, "005533".
  • PRINTER_TEXT_ALIGN : spécifie l'alignement du texte pour le contexte d'imprimante. value peut être une combinaison, avec l'opérateur OR, des constantes suivantes :
    • PRINTER_TA_BASELINE : le texte sera aligné sur la ligne de base.
    • PRINTER_TA_BOTTOM : le texte sera aligné sur la ligne de fond.
    • PRINTER_TA_TOP : le texte sera aligné sur la ligne de haut.
    • PRINTER_TA_CENTER : le texte sera centré.
    • PRINTER_TA_LEFT : le texte sera aligné à gauche.
    • PRINTER_TA_RIGHT : le texte sera aligné à droite.

value

La valeur de l'option.

Valeurs de retour

Cette fonction retourne TRUE en cas de succès ou FALSE si une erreur survient.

Exemples

Exemple #1 Exemple avec printer_set_option()

<?php
$handle 
printer_open();
printer_set_option($handlePRINTER_SCALE75);
printer_set_option($handlePRINTER_TEXT_ALIGNPRINTER_TA_LEFT);
printer_close($handle);
?>

add a note add a note

User Contributed Notes 1 note

up
0
saiko1 at gmail dot com
5 years ago
Note that printer_set_option will not work due to a bug in php_printer.dll. As far as I can tell this extension has been abandoned for quite some time.
To Top