Files
doc-fr/reference/printer/functions/printer-set-option.xml
T
Damien Seguy 10c29d2002 minor spelling mistakes
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@259225 c90b9560-bf6c-de11-be94-00142212c4b1
2008-05-07 10:32:49 +00:00

309 lines
10 KiB
XML
Executable File

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.13 $ -->
<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.printer-set-option" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>printer_set_option</refname>
<refpurpose>Configure la connexion à l'imprimante</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>printer_set_option</methodname>
<methodparam><type>resource</type><parameter>printer_handle</parameter></methodparam>
<methodparam><type>int</type><parameter>option</parameter></methodparam>
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
</methodsynopsis>
<para>
Configure la connexion à l'imprimante.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>printer_handle</parameter></term>
<listitem>
<para>
<parameter>printer_handle</parameter> doit être une ressource d'imprimante valide.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>option</parameter></term>
<listitem>
<para>
Peut être l'une des constantes suivantes :
<itemizedlist>
<listitem>
<simpara>
<constant>PRINTER_COPIES</constant> :
indique le nombre de copies à imprimer.
<parameter>value</parameter> doit être un &integer;.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_MODE</constant> :
spécifie le type de data ("text", "raw" ou "emf"),
<parameter>value</parameter>doit être une &string;.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_TITLE</constant> :
spécifie le nom du document, <parameter>value</parameter>
doit être une &string;.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_ORIENTATION</constant> :
spécifie l'orientation du papier, <parameter>value</parameter>
peut être <constant>PRINTER_ORIENTATION_PORTRAIT</constant> ou
<constant>PRINTER_ORIENTATION_LANDSCAPE</constant>
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_RESOLUTION_Y</constant> :
spécifie la résolution en ordonnées, en DPI, <parameter>value</parameter>
doit être un &integer;.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_RESOLUTION_X</constant> :
spécifie la résolution en abscisse, en DPI, <parameter>value</parameter>
doit être un &integer;.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_PAPER_FORMAT</constant> :
spécifie un format de papier prédéfini : donnez à <parameter>value</parameter>
la valeur de <constant>PRINTER_FORMAT_CUSTOM</constant> si vous souhaitez
utiliser un format de papier personnalisé, grâce aux constantes
<constant>PRINTER_PAPER_WIDTH</constant> et
<constant>PRINTER_PAPER_LENGTH</constant>.
<parameter>value</parameter> peut alors être l'une des constantes suivantes :
</simpara>
<itemizedlist>
<listitem>
<simpara>
<constant>PRINTER_FORMAT_CUSTOM</constant> :
vous laisse spécifier le format de papier.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_FORMAT_LETTER</constant> :
spécifie le format standard "letter" (8 1/2 par 11 pouces (2.54cm)).
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_FORMAT_LEGAL</constant> :
spécifie le format standard "legal" (8 1/2 par 14 pouces (2.54cm)).
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_FORMAT_A3</constant> :
spécifie le format standard "A3" (297 par 420 millimètres).
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_FORMAT_A4</constant> :
spécifie le format standard "A4" (210 par 297 millimètres).
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_FORMAT_A5</constant> :
spécifie le format standard "A5" (148 par 210 millimètres).
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_FORMAT_B4</constant>:
spécifies le format standard B4 (250 par 354 millimètres).
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_FORMAT_B5</constant> :
spécifie le format standard "B5" (182 par 257 millimètres).
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_FORMAT_FOLIO</constant> :
spécifie le format standard "FOLIO" (8 1/2 par 13 pouces (2.54cm)).
</simpara>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_PAPER_LENGTH</constant> :
si <constant>PRINTER_PAPER_FORMAT</constant> vaut
<constant>PRINTER_FORMAT_CUSTOM</constant>,
<constant>PRINTER_PAPER_LENGTH</constant>
spécifie une longueur personnalisée de papier, en millimètres.
<parameter>value</parameter> doit être un &integer;.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_PAPER_WIDTH</constant> :
si <constant>PRINTER_PAPER_FORMAT</constant> vaut
<constant>PRINTER_FORMAT_CUSTOM</constant>,
<constant>PRINTER_PAPER_WIDTH</constant>
spécifie une largeur personnalisée de papier, en millimètres.
<parameter>value</parameter> doit être un &integer;.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_SCALE</constant> :
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 à <parameter>value</parameter>/100. Par
exemple, si vous donnez un facteur d'échelle de 50, l'impression
sera de la moitié de la taille du document original.
<parameter>value</parameter> doit être un &integer;.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_BACKGROUND_COLOR</constant> :
spécifie la couleur de fond pour le contexte actuel.
<parameter>value</parameter> doit être une &string; contenant une
couleur au format RGB hexadécimal : par exemple, "005533".
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_TEXT_COLOR</constant> :
spécifie la couleur du texte pour ce contexte d'imprimante.
<parameter>value</parameter> doit être une &string; contenant une
couleur au format RGB hexadécimal : par exemple, "005533".
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_TEXT_ALIGN</constant> :
spécifie l'alignement du texte pour le contexte d'imprimante.
<parameter>value</parameter> peut être une combinaison,
avec l'opérateur OR, des constantes suivantes :
</simpara>
<itemizedlist>
<listitem>
<simpara>
<constant>PRINTER_TA_BASELINE</constant> :
le texte sera aligné sur la ligne de base.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_TA_BOTTOM</constant> :
le texte sera aligné sur la ligne de fond.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_TA_TOP</constant> :
le texte sera aligné sur la ligne de haut.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_TA_CENTER</constant> :
le texte sera centré.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_TA_LEFT</constant> :
le texte sera aligné à gauche.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PRINTER_TA_RIGHT</constant> :
le texte sera aligné à droite.
</simpara>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
La valeur de l'<parameter>option</parameter>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Exemple avec <function>printer_set_option</function></title>
<programlisting role="php">
<![CDATA[
<?php
$handle = printer_open();
printer_set_option($handle, PRINTER_SCALE, 75);
printer_set_option($handle, PRINTER_TEXT_ALIGN, PRINTER_TA_LEFT);
printer_close($handle);
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->