cvs: phpdoc /fr/functions fdf.xml
| From: | Damien Seguy | Date: | Wed, 22 Nov 2000 17:19:34 +0000 |
| Subject: | cvs: phpdoc /fr/functions fdf.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969333028@lists.php.net to get a copy of this message | ||
dams Wed Nov 22 09:19:34 2000 EDT
Modified files:
/phpdoc/fr/functions fdf.xml
Log:
Added missing functions.Synch with en.
Index: phpdoc/fr/functions/fdf.xml diff -u phpdoc/fr/functions/fdf.xml:1.1 phpdoc/fr/functions/fdf.xml:1.2 --- phpdoc/fr/functions/fdf.xml:1.1 Fri Jul 21 03:27:50 2000 +++ phpdoc/fr/functions/fdf.xml Wed Nov 22 09:19:34 2000 @@ -1,432 +1,541 @@ - <reference id="ref.fdf"> - <title>Forms Data Format</title> - <titleabbrev>FDF</titleabbrev> - - <partintro> - - <simpara> - Forms Data Format (FDF) est un format de fomulaire pour les documents PDF. - Vous pouvez lire la documentation (en anglais) à - <ulink url="http://partners.adobe.com/asn/developer/acrosdk/forms.html">http://partners.adobe.com/asn/developer/acrosdk/forms.html</ulink> - pour plus de détails sur les tenants et les aboutissants. - </simpara> - - <note><simpara> - Actuellement, Adobe ne fournit que libc5, compatible Linux. Les tests avec glibc2 - ont donné des "segmentation fault". Si quelqu'un est arrivé à un résultat, - envoyez nous vos infos. - </simpara></note> - - <note><simpara> - Si vous rencontrez des problèmes de configuration avec fdftk, vérifier que le - header FdfTk.h et la librairie libFdfTk.so sont bien là oú ils doivent être. - Ils devraient être placés dans le dossier <filename>fdftk-dir/include</filename> - et <filename>fdftk-dir/lib</filename>. Cela ne sera pas le cas si vous avez - simplement décompressé la distribution. - </simpara></note> - - <simpara> - L'esprit de FDF est similaire à celui des formulaires HTML. Les différences résident - dans les moyens de transmission des données au serveur, lorsque le bouton "submit" - (soumettre) est pressé (ce qui est du ressort de Form Data Format) et le format de - formulaire lui même (qui est plutot du ressort de Portable Document Format, PDF). - Gérer des données FDF est un des objectifs des fonctions FDF. Mais il y en a - d'autres. - - Vous pouvez aussi prendre un formulaire PDF, et pré-remplir les champs, sans - modifier le formulaire lui même. Dans ce cas, on va créer un document FDF - (<function>fdf_create</function>), remplir les champs - (<function>fdf_set_value</function>) et l'associer à un fichier PDF - (<function>fdf_set_file</function>). Finalement, le tout sera envoyé au client, - avec le type MIME "application/vnd.fdf". Le module "Acrobat reader" - de votre navigateur va reconnaître ce type MIME, et lire le fichier PDF, puis le - remplis avec FDF. - </simpara> - - <simpara> - Les exemples suivants montre comme évaluer les données du formulaire. - </simpara> - <simpara></simpara> - <example> - <title>Evaluer un document FDF</title> - <programlisting> -<?php -// Sauver le fichier FDF dans un fichier temporaire. -$fdffp = fopen("test.fdf", "w"); -fwrite($fdffp, $HTTP_FDF_DATA, strlen($HTTP_FDF_DATA)); -fclose($fdffp); - -// Ouvrir le fichier temporaire, et utiliser les données. -// Le formulaire pdf contenait différents fichiers texte, avec pour nom : -// volume, date, comment, publisher, preparer, ainsi que deux boîtes à cocher, -// show_publisher et show_preparer. -$fdf = fdf_open("test.fdf"); -$volume = fdf_get_value($fdf, "volume"); -echo "La valeur du champs volume était : '<B>$volume</B>'<BR>"; - -$date = fdf_get_value($fdf, "date"); -echo "La valeur du champs date était '<B>$date</B>'<BR>"; - -$comment = fdf_get_value($fdf, "comment"); -echo "La valeur du champs comment était '<B>$comment</B>'<BR>"; - -if(fdf_get_value($fdf, "show_publisher") == "On") { - $publisher = fdf_get_value($fdf, "publisher"); - echo "La valeur du champs publisher était : '<B>$publisher</B>'<BR>"; -} else - echo "La valeur du champs ne doit pas être affichée.<BR>"; - -if(fdf_get_value($fdf, "show_preparer") == "On") { - $preparer = fdf_get_value($fdf, "preparer"); - echo "La valeur du champs preparer était '<B>$preparer</B>'<BR>"; -} else - echo "La valeur du champs Preparer ne doit pas être affiché.<BR>"; -fdf_close($fdf); -?> - </programlisting> - </example> - - </partintro> - - <refentry id="function.fdf-open"> - <refnamediv> - <refname>fdf_open</refname> - <refpurpose>Ouvre un document FDF.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>fdf_open</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcsynopsis> - <para> - La fonction <function>fdf_open</function> ouvre un fichier avec formulaire. - Le fichier doit contenir les données retournées par le formulaire PDF. - Actuellement, le fichier doit être créée 'manuellement', en utilisant la fonction - <function>fopen</function> et en y écrivant le contenu du tableau HTTP_FDF_DATA - avec la fonction <function>fwrite</function>. - Un mécanisme comparable aux formulaires HTML qui créent une variable pour chaque - champs entrant, n'existe pas. - </para> - <para> - <example> - <title>Accéder aux données du formulaire</title> - <programlisting> -<?php -// Sauver le fichier FDF dans un fichier temporaire. -$fdffp = fopen("test.fdf", "w"); -fwrite($fdffp, $HTTP_FDF_DATA, strlen($HTTP_FDF_DATA)); -fclose($fdffp); - -// Ouvrir le fichier temporaire, et utiliser les données. -$fdf = fdf_open("test.fdf"); -... -fdf_close($fdf); -?> - </programlisting> - </example></para> - - <para> - Voir aussi <function>fdf_close</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.fdf-close"> - <refnamediv> - <refname>fdf_close</refname> - <refpurpose>Ferme une document FDF.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>fdf_close</function></funcdef> - <paramdef>int <parameter>fdf_document</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_close</function> ferme le document FDF.</para> - - <para> - Voir aussi <function>fdf_open</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.fdf-create"> - <refnamediv> - <refname>fdf_create</refname> - <refpurpose>Crée un nouveau document FDF.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>fdf_create</function></funcdef> - <paramdef>void <parameter></parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_create</function> crée un nouveau document FDF. - Cette fonction est nécessaire pour ceux qui veulent pré remplir les champs d'un - formulaire dans un fichier PDF. -</para> - <para> - <example> - <title>Pré rempir un formulaire PDF</title> - <programlisting> -<?php -$outfdf = fdf_create(); -fdf_set_value($outfdf, "volume", $volume, 0); - -fdf_set_file($outfdf, "http:/testfdf/resultlabel.pdf"); -fdf_save($outfdf, "outtest.fdf"); -fdf_close($outfdf); -Header("Content-type: application/vnd.fdf"); -$fp = fopen("outtest.fdf", "r"); -fpassthru($fp); -unlink("outtest.fdf"); -?> - </programlisting> - </example></para> - - <para> - Voir aussi <function>fdf_close</function>, <function>fdf_save</function>, - et <function>fdf_open</function>.</para> - </refsect1> - </refentry> - - <refentry id="function.fdf-save"> - <refnamediv> - <refname>fdf_save</refname> - <refpurpose>Sauver un document FDF.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>fdf_save</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_save</function> sauve un document FDF. - Le FDF Toolkit fournit un moyen d'envoyer le contenu d'un document FDF à au - fichier de sortie stdout si le paramètre <parameter>filename</parameter> vaut '.'. - Ceci ne fonctionne pas si PHP est sous la forme d'un module Apache. - Dans ce cas, il faudra écrire le résultat dans un fichier, et utiliser - <function>fpassthru</function> pour l'afficher au client. - </para> - - <para> - Voir aussi <function>fdf_close</function> et pour avoir un exemple - <function>fdf_create</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.fdf-get-value"> - <refnamediv> - <refname>fdf_get_value</refname> - <refpurpose>Mot la valeur d'un champs.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>fdf_get_value</function></funcdef> - <paramdef>int <parameter>fdf_document</parameter></paramdef> - <paramdef>string <parameter>fieldname</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_get_value</function> retourne la valeur d'un champs. - </para> - - <para> - Voir aussi <function>fdf_set_value</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.fdf-set-value"> - <refnamediv> - <refname>fdf_set_value</refname> - <refpurpose>Fixe la valeur d'un champs.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>fdf_set_value</function></funcdef> - <paramdef>int <parameter>fdf_document</parameter></paramdef> - <paramdef>string <parameter>fieldname</parameter></paramdef> - <paramdef>string <parameter>value</parameter></paramdef> - <paramdef>int <parameter>isName</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_set_value</function> fixe la valeur d'un champs. - Le dernier paramètre determine si la valeur doit être convertie en nom PDF - (<parameter>isName</parameter> = 1) ou affecter une chaîne PDF à un contrôle - (<parameter>isName</parameter> = 0). - </para> - - <para> - Voir aussi <function>fdf_get_value</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.fdf-next-field-name"> - <refnamediv> - <refname>fdf_next_field_name</refname> - <refpurpose>Lit le nom du champs suivant.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>fdf_next_field_name</function></funcdef> - <paramdef>int <parameter>fdf_document</parameter></paramdef> - <paramdef>string <parameter>fieldname</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_next_field_name</function> retourne le nom du champs après le champs - <parameter>fieldname</parameter> ou le nom du premier champs, si le second - paramètre est NULL. - </para> - - <para> - Voir aussi <function>fdf_set_value</function> et <function>fdf_get_value</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.fdf-set-ap"> - <refnamediv> - <refname>fdf_set_ap</refname> - <refpurpose>Fixe l'apparence d'un champs.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>fdf_set_ap</function></funcdef> - <paramdef>int <parameter>fdf_document</parameter></paramdef> - <paramdef>string <parameter>field_name</parameter></paramdef> - <paramdef>int <parameter>face</parameter></paramdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>int <parameter>page_number</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_set_ap</function> fixe l'apparence d'un champs - (i.e. la valeur de la clé /AP). - Les valeurs possibles de <parameter>face</parameter> sont - sont 1=FDFNormalAP, 2=FDFRolloverAP, 3=FDFDownAP.</para> - - </refsect1> - </refentry> - - <refentry id="function.fdf-set-status"> - <refnamediv> - <refname>fdf_set_status</refname> - <refpurpose>Fixe la valeur de la clé /STATUS.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>fdf_set_status</function></funcdef> - <paramdef>int <parameter>fdf_document</parameter></paramdef> - <paramdef>string <parameter>status</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_set_status</function> fixe la valeur de la clé /STATUS.</para> - - <para> - Voir aussi <function>fdf_get_status</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.fdf-get-status"> - <refnamediv> - <refname>fdf_get_status</refname> - <refpurpose>Lit la valeur de la clé /STATUS.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>fdf_get_status</function></funcdef> - <paramdef>int <parameter>fdf_document</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_get_status</function> retourne la valeur de la clé /STATUS. - </para> - <para> - Voir aussi <function>fdf_set_status</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.fdf-set-file"> - <refnamediv> - <refname>fdf_set_file</refname> - <refpurpose>Fixe la valeur de la clé /F.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>fdf_set_file</function></funcdef> - <paramdef>int <parameter>fdf_document</parameter></paramdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_set_file</function> Fixe la valeur de la clé /F. la clé /F est - simplement une référence sur un formulaire PDF qui doit être pré-remplis. - Dans un environnement web, c'est une URL (e.g. http:/testfdf/resultlabel.pdf). - </para> - - <para> - Voir aussi <function>fdf_get_file</function> et pour un exemple, - <function>fdf_create</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.fdf-get-file"> - <refnamediv> - <refname>fdf_get_file</refname> - <refpurpose>Lit la valeur de la clé /F.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>fdf_get_file</function></funcdef> - <paramdef>int <parameter>fdf_document</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_set_file</function> lit la valeur de la clé /F. - </para> - <para> - Voir aussi <function>fdf_set_file</function>. - </para> - - </refsect1> - </refentry> - - </reference> - -<!-- 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 -sgml-parent-document:nil -sgml-default-dtd-file:"../manual.ced" -sgml-exposed-tags:nil -sgml-local-catalogs:nil -sgml-local-ecat-files:nil -End: ---> + <reference id="ref.fdf"> + <title>Forms Data Format</title> + <titleabbrev>FDF</titleabbrev> + <partintro> + <simpara> + Forms Data Format (FDF) est un format de fomulaire pour les documents + PDF. Vous pouvez lire la documentation (en anglais) à + <ulink url="&spec.pdf.fdf;">&spec.pdf.fdf;</ulink> + pour plus de détails sur les tenants et les aboutissants. + </simpara> + <note> + <simpara> + Si vous rencontrez des problèmes de configuration de PHP avec le support + fdftk, vérifiez bien que le fichier d'entêtes FdfTk.h et la librairie + libFdfTk.so sont bien situés. Elle devrait être dans les dossiers + fdftk-dir/include et fdftk-dir/lib. Cela ne sera pas le cas si vous + avez simplement décompressé la distribution FdfTk. + </simpara> + </note> + <simpara> + L'esprit de FDF est similaire à celui des formulaires HTML. Les + différences résident dans les moyens de transmission des + données au serveur, lorsque le bouton "submit" (soumettre) est + pressé (ce qui est du ressort de Form Data Format) et le format de + formulaire lui même (qui est plutot du ressort de Portable Document + Format, PDF). Gérer des données FDF est un des objectifs des + fonctions FDF. Mais il y en a d'autres. Vous pouvez aussi prendre un + formulaire PDF, et pré-remplir les champs, sans modifier le + formulaire lui même. Dans ce cas, on va créer un document FDF + (<function>fdf_create</function>), remplir les champs + (<function>fdf_set_value</function>) et l'associer à un fichier PDF + (<function>fdf_set_file</function>). Finalement, le tout sera envoyé + au client, avec le type MIME "application/vnd.fdf". Le module "Acrobat reader" + de votre navigateur va reconnaître ce type MIME, et lire le fichier + PDF, puis le remplis avec FDF. + </simpara> + <simpara> + Si vous éditez un fichier FDF avec un éditeur de texte, vous trouverez + un catalogue d'objet avec le nom de <literal>FDF</literal>. Cet objet + peut contenir des entrées telles que <literal>Fields</literal>, + <literal>F</literal>, <literal>Status</literal> etc.. + Les entrées les plus couramment utilisées sont + <literal>Fields</literal>, qui indique une liste de champs de contrôle, + et <literal>F</literal> qui contient le nom du fichier PDF a qui + appartiennent ces données. Ces entrées sont désignées dans la documentation + PDF sous le nom de /F-Key ou /Status-Key. + La modification de ces entrées est possible avec les fonctions + <function>fdf_set_file</function> et <function>fdf_set_status</function>. + Les champs sont modifiables avec les fonctions + <function>fdf_set_value</function>, <function>fdf_set_opt</function> etc.. + </simpara> + <simpara> + Les exemples suivants montre comme évaluer les données + du formulaire. + </simpara> + <simpara></simpara> + <example> + <title>Evaluer un document FDF</title> + <programlisting> +<?php +// Sauver le fichier FDF dans un fichier temporaire. +$fdffp = fopen("test.fdf", "w"); +fwrite($fdffp, $HTTP_FDF_DATA, strlen($HTTP_FDF_DATA)); +fclose($fdffp); +// Ouvrir le fichier temporaire, et utiliser les données. +// Le formulaire pdf contenait différents fichiers texte, avec pour nom : +// volume, date, comment, publisher, preparer, ainsi que deux boîtes +// à cocher show_publisher et show_preparer. +$fdf = fdf_open("test.fdf"); +$volume = fdf_get_value($fdf, "volume"); +echo "La valeur du champs volume était : '<B>$volume</B>'<BR>"; +$date = fdf_get_value($fdf, "date"); +echo "La valeur du champs date était '<B>$date</B>'<BR>"; +$comment = fdf_get_value($fdf, "comment"); +echo "La valeur du champs comment était '<B>$comment</B>'<BR>"; +if(fdf_get_value($fdf, "show_publisher") == "On") { + $publisher = fdf_get_value($fdf, "publisher"); + echo "La valeur du champs publisher était : '<B>$publisher</B>'<BR>"; +} else + echo "La valeur du champs ne doit pas être affichée.<BR>"; +if(fdf_get_value($fdf, "show_preparer") == "On") { + $preparer = fdf_get_value($fdf, "preparer"); + echo "La valeur du champs preparer était '<B>$preparer</B>'<BR>"; +} else + echo "La valeur du champs Preparer ne doit pas être affiché.<BR>"; +fdf_close($fdf); +?> + </programlisting> + </example> + </partintro> + <refentry id="function.fdf-open"> + <refnamediv> + <refname>fdf_open</refname> + <refpurpose>Ouvre un document FDF.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fdf_open</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + La fonction <function>fdf_open</function> ouvre un fichier avec + formulaire. Le fichier doit contenir les données + retournées par le formulaire PDF. Actuellement, le + fichier doit être créée 'manuellement', + en utilisant la fonction <function>fopen</function> et en y + écrivant le contenu du tableau HTTP_FDF_DATA avec la + fonction <function>fwrite</function>. Un mécanisme + comparable aux formulaires HTML qui créent une variable + pour chaque champs entrant, n'existe pas. + </para> + <para> + <example> + <title>Accéder aux données du formulaire</title> + <programlisting> +<?php +// Sauver le fichier FDF dans un fichier temporaire. +$fdffp = fopen("test.fdf", "w"); +fwrite($fdffp, $HTTP_FDF_DATA, strlen($HTTP_FDF_DATA)); +fclose($fdffp); +// Ouvrir le fichier temporaire, et utiliser les données. +$fdf = fdf_open("test.fdf"); +... +fdf_close($fdf); +?> + </programlisting> + </example> + </para> + <para> + Voir aussi <function>fdf_close</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-close"> + <refnamediv> + <refname>fdf_close</refname> + <refpurpose>Ferme une document FDF.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>fdf_close</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_close</function> ferme le document FDF. + </para> + <para> + Voir aussi <function>fdf_open</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-create"> + <refnamediv> + <refname>fdf_create</refname> + <refpurpose>Crée un nouveau document FDF.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fdf_create</function></funcdef> + <paramdef>void <parameter></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_create</function> crée un nouveau document FDF. + Cette fonction est nécessaire pour ceux qui veulent pré + remplir les champs d'un formulaire dans un fichier PDF. + </para> + <para> + <example> + <title>Pré rempir un formulaire PDF</title> + <programlisting> +<?php +$outfdf = fdf_create(); +fdf_set_value($outfdf, "volume", $volume, 0); +fdf_set_file($outfdf, "http:/testfdf/resultlabel.pdf"); +fdf_save($outfdf, "outtest.fdf"); +fdf_close($outfdf); +Header("Content-type: application/vnd.fdf"); +$fp = fopen("outtest.fdf", "r"); +fpassthru($fp); +unlink("outtest.fdf"); +?> + </programlisting> + </example> + </para> + <para> + Voir aussi <function>fdf_close</function>, <function>fdf_save</function>, + et <function>fdf_open</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-save"> + <refnamediv> + <refname>fdf_save</refname> + <refpurpose>Sauver un document FDF.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fdf_save</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_save</function> sauve un document FDF. + Le FDF Toolkit fournit un moyen d'envoyer le contenu d'un document + FDF à au fichier de sortie stdout si le paramètre + <parameter>filename</parameter> vaut '.'. Ceci ne fonctionne pas + si PHP est sous la forme d'un module Apache. Dans ce cas, il + faudra écrire le résultat dans un fichier, et utiliser + <function>fpassthru</function> pour l'afficher au client. + </para> + <para> + Voir aussi <function>fdf_close</function> et pour avoir un exemple + <function>fdf_create</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-get-value"> + <refnamediv> + <refname>fdf_get_value</refname> + <refpurpose>Mot la valeur d'un champs.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>fdf_get_value</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>fieldname</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_get_value</function> retourne la valeur d'un champs. + </para> + <para> + Voir aussi <function>fdf_set_value</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-set-value"> + <refnamediv> + <refname>fdf_set_value</refname> + <refpurpose>Fixe la valeur d'un champs.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>fdf_set_value</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>fieldname</parameter></paramdef> + <paramdef>string <parameter>value</parameter></paramdef> + <paramdef>int <parameter>isName</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_set_value</function> fixe la valeur d'un champs. + Le dernier paramètre determine si la valeur doit être + convertie en nom PDF (<parameter>isName</parameter> = 1) ou affecter + une chaîne PDF à un contrôle + (<parameter>isName</parameter> = 0). + </para> + <para> + Voir aussi <function>fdf_get_value</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-next-field-name"> + <refnamediv> + <refname>fdf_next_field_name</refname> + <refpurpose>Lit le nom du champs suivant.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>fdf_next_field_name</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>fieldname</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_next_field_name</function> retourne le nom du + champs après le champs <parameter>fieldname</parameter> + ou le nom du premier champs, si le second paramètre est NULL. + </para> + <para> + Voir aussi <function>fdf_set_value</function> et + <function>fdf_get_value</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-set-ap"> + <refnamediv> + <refname>fdf_set_ap</refname> + <refpurpose>Fixe l'apparence d'un champs.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>fdf_set_ap</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>field_name</parameter></paramdef> + <paramdef>int <parameter>face</parameter></paramdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>int <parameter>page_number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_set_ap</function> fixe l'apparence d'un champs + (i.e. la valeur de la clé /AP). + Les valeurs possibles de <parameter>face</parameter> sont + sont 1=FDFNormalAP, 2=FDFRolloverAP, 3=FDFDownAP. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-set-status"> + <refnamediv> + <refname>fdf_set_status</refname> + <refpurpose>Fixe la valeur de la clé /STATUS.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>fdf_set_status</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>status</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_set_status</function> fixe la valeur de la + clé /STATUS. + </para> + <para> + Voir aussi <function>fdf_get_status</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-get-status"> + <refnamediv> + <refname>fdf_get_status</refname> + <refpurpose>Lit la valeur de la clé /STATUS.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>fdf_get_status</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_get_status</function> retourne la + valeur de la clé /STATUS. + </para> + <para> + Voir aussi <function>fdf_set_status</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-set-file"> + <refnamediv> + <refname>fdf_set_file</refname> + <refpurpose>Fixe la valeur de la clé /F.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>fdf_set_file</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_set_file</function> Fixe la valeur de la + clé /F. la clé /F est simplement une + référence sur un formulaire PDF qui doit + être pré-remplis. Dans un environnement web, + c'est une URL (e.g. http:/testfdf/resultlabel.pdf). + </para> + <para> + Voir aussi <function>fdf_get_file</function> et pour un exemple, + <function>fdf_create</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-get-file"> + <refnamediv> + <refname>fdf_get_file</refname> + <refpurpose>Lit la valeur de la clé /F.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>fdf_get_file</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_set_file</function> lit la valeur de la clé /F. + </para> + <para> + Voir aussi <function>fdf_set_file</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-set-flags"> + <refnamediv> + <refname>fdf_set_flags</refname> + <refpurpose>Modifie une option d'un champs</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>fdf_set_flags</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>fieldname</parameter></paramdef> + <paramdef>int <parameter>whichFlags</parameter></paramdef> + <paramdef>int <parameter>newFlags</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_set_flags</function> modifie certaines options + du champs <parameter>fieldname</parameter>. + </para> + <para> + Voir aussi <function>fdf_set_opt</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-set-opt"> + <refnamediv> + <refname>fdf_set_opt</refname> + <refpurpose>Modifie une option d'un champs</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>fdf_set_opt</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>fieldname</parameter></paramdef> + <paramdef>int <parameter>element</parameter></paramdef> + <paramdef>string <parameter>str1</parameter></paramdef> + <paramdef>string <parameter>str2</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_set_opt</function> modifie les options + du champs <parameter>fieldname</parameter>. + </para> + <para> + Voir aussi <function>fdf_set_flags</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-set-submit-form-action"> + <refnamediv> + <refname>fdf_set_submit_form_action</refname> + <refpurpose>Modifie l'action javascript d'un champs</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>fdf_set_submit_form_action</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>fieldname</parameter></paramdef> + <paramdef>int <parameter>trigger</parameter></paramdef> + <paramdef>string <parameter>script</parameter></paramdef> + <paramdef>int <parameter>flags</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_set_submit_form_action</function> affecte un + javascript au champs <parameter>fieldname</parameter>, exécuté + lors de la validation d'un formulaire. + </para> + <para> + Voir aussi <function>fdf_set_javascript_action</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-set-javascript-action"> + <refnamediv> + <refname>fdf_set_javascript_action</refname> + <refpurpose>Modifie l'action javascript d'un champs</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>fdf_set_javascript_action</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>fieldname</parameter></paramdef> + <paramdef>int <parameter>trigger</parameter></paramdef> + <paramdef>string <parameter>script</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + The <function>fdf_set_javascript_action</function> affecte un + javascript au champs <parameter>fieldname</parameter>, exécuté + lors de la validation d'un formulaire. + </para> + <para> + Voir aussi <function>fdf_set_submit_form_action</function>. + </para> + </refsect1> + </refentry> + </reference> +<!-- 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 +sgml-parent-document:nil +sgml-default-dtd-file:"../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +-->
Index: phpdoc/fr/functions/fdf.xml diff -u phpdoc/fr/functions/fdf.xml:1.1 phpdoc/fr/functions/fdf.xml:1.2 --- phpdoc/fr/functions/fdf.xml:1.1 Fri Jul 21 03:27:50 2000 +++ phpdoc/fr/functions/fdf.xml Wed Nov 22 09:19:34 2000 @@ -1,432 +1,541 @@ - <reference id="ref.fdf"> - <title>Forms Data Format</title> - <titleabbrev>FDF</titleabbrev> - - <partintro> - - <simpara> - Forms Data Format (FDF) est un format de fomulaire pour les documents PDF. - Vous pouvez lire la documentation (en anglais) à - <ulink url="http://partners.adobe.com/asn/developer/acrosdk/forms.html">http://partners.adobe.com/asn/developer/acrosdk/forms.html</ulink> - pour plus de détails sur les tenants et les aboutissants. - </simpara> - - <note><simpara> - Actuellement, Adobe ne fournit que libc5, compatible Linux. Les tests avec glibc2 - ont donné des "segmentation fault". Si quelqu'un est arrivé à un résultat, - envoyez nous vos infos. - </simpara></note> - - <note><simpara> - Si vous rencontrez des problèmes de configuration avec fdftk, vérifier que le - header FdfTk.h et la librairie libFdfTk.so sont bien là oú ils doivent être. - Ils devraient être placés dans le dossier <filename>fdftk-dir/include</filename> - et <filename>fdftk-dir/lib</filename>. Cela ne sera pas le cas si vous avez - simplement décompressé la distribution. - </simpara></note> - - <simpara> - L'esprit de FDF est similaire à celui des formulaires HTML. Les différences résident - dans les moyens de transmission des données au serveur, lorsque le bouton "submit" - (soumettre) est pressé (ce qui est du ressort de Form Data Format) et le format de - formulaire lui même (qui est plutot du ressort de Portable Document Format, PDF). - Gérer des données FDF est un des objectifs des fonctions FDF. Mais il y en a - d'autres. - - Vous pouvez aussi prendre un formulaire PDF, et pré-remplir les champs, sans - modifier le formulaire lui même. Dans ce cas, on va créer un document FDF - (<function>fdf_create</function>), remplir les champs - (<function>fdf_set_value</function>) et l'associer à un fichier PDF - (<function>fdf_set_file</function>). Finalement, le tout sera envoyé au client, - avec le type MIME "application/vnd.fdf". Le module "Acrobat reader" - de votre navigateur va reconnaître ce type MIME, et lire le fichier PDF, puis le - remplis avec FDF. - </simpara> - - <simpara> - Les exemples suivants montre comme évaluer les données du formulaire. - </simpara> - <simpara></simpara> - <example> - <title>Evaluer un document FDF</title> - <programlisting> -<?php -// Sauver le fichier FDF dans un fichier temporaire. -$fdffp = fopen("test.fdf", "w"); -fwrite($fdffp, $HTTP_FDF_DATA, strlen($HTTP_FDF_DATA)); -fclose($fdffp); - -// Ouvrir le fichier temporaire, et utiliser les données. -// Le formulaire pdf contenait différents fichiers texte, avec pour nom : -// volume, date, comment, publisher, preparer, ainsi que deux boîtes à cocher, -// show_publisher et show_preparer. -$fdf = fdf_open("test.fdf"); -$volume = fdf_get_value($fdf, "volume"); -echo "La valeur du champs volume était : '<B>$volume</B>'<BR>"; - -$date = fdf_get_value($fdf, "date"); -echo "La valeur du champs date était '<B>$date</B>'<BR>"; - -$comment = fdf_get_value($fdf, "comment"); -echo "La valeur du champs comment était '<B>$comment</B>'<BR>"; - -if(fdf_get_value($fdf, "show_publisher") == "On") { - $publisher = fdf_get_value($fdf, "publisher"); - echo "La valeur du champs publisher était : '<B>$publisher</B>'<BR>"; -} else - echo "La valeur du champs ne doit pas être affichée.<BR>"; - -if(fdf_get_value($fdf, "show_preparer") == "On") { - $preparer = fdf_get_value($fdf, "preparer"); - echo "La valeur du champs preparer était '<B>$preparer</B>'<BR>"; -} else - echo "La valeur du champs Preparer ne doit pas être affiché.<BR>"; -fdf_close($fdf); -?> - </programlisting> - </example> - - </partintro> - - <refentry id="function.fdf-open"> - <refnamediv> - <refname>fdf_open</refname> - <refpurpose>Ouvre un document FDF.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>fdf_open</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcsynopsis> - <para> - La fonction <function>fdf_open</function> ouvre un fichier avec formulaire. - Le fichier doit contenir les données retournées par le formulaire PDF. - Actuellement, le fichier doit être créée 'manuellement', en utilisant la fonction - <function>fopen</function> et en y écrivant le contenu du tableau HTTP_FDF_DATA - avec la fonction <function>fwrite</function>. - Un mécanisme comparable aux formulaires HTML qui créent une variable pour chaque - champs entrant, n'existe pas. - </para> - <para> - <example> - <title>Accéder aux données du formulaire</title> - <programlisting> -<?php -// Sauver le fichier FDF dans un fichier temporaire. -$fdffp = fopen("test.fdf", "w"); -fwrite($fdffp, $HTTP_FDF_DATA, strlen($HTTP_FDF_DATA)); -fclose($fdffp); - -// Ouvrir le fichier temporaire, et utiliser les données. -$fdf = fdf_open("test.fdf"); -... -fdf_close($fdf); -?> - </programlisting> - </example></para> - - <para> - Voir aussi <function>fdf_close</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.fdf-close"> - <refnamediv> - <refname>fdf_close</refname> - <refpurpose>Ferme une document FDF.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>fdf_close</function></funcdef> - <paramdef>int <parameter>fdf_document</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_close</function> ferme le document FDF.</para> - - <para> - Voir aussi <function>fdf_open</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.fdf-create"> - <refnamediv> - <refname>fdf_create</refname> - <refpurpose>Crée un nouveau document FDF.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>fdf_create</function></funcdef> - <paramdef>void <parameter></parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_create</function> crée un nouveau document FDF. - Cette fonction est nécessaire pour ceux qui veulent pré remplir les champs d'un - formulaire dans un fichier PDF. -</para> - <para> - <example> - <title>Pré rempir un formulaire PDF</title> - <programlisting> -<?php -$outfdf = fdf_create(); -fdf_set_value($outfdf, "volume", $volume, 0); - -fdf_set_file($outfdf, "http:/testfdf/resultlabel.pdf"); -fdf_save($outfdf, "outtest.fdf"); -fdf_close($outfdf); -Header("Content-type: application/vnd.fdf"); -$fp = fopen("outtest.fdf", "r"); -fpassthru($fp); -unlink("outtest.fdf"); -?> - </programlisting> - </example></para> - - <para> - Voir aussi <function>fdf_close</function>, <function>fdf_save</function>, - et <function>fdf_open</function>.</para> - </refsect1> - </refentry> - - <refentry id="function.fdf-save"> - <refnamediv> - <refname>fdf_save</refname> - <refpurpose>Sauver un document FDF.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>fdf_save</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_save</function> sauve un document FDF. - Le FDF Toolkit fournit un moyen d'envoyer le contenu d'un document FDF à au - fichier de sortie stdout si le paramètre <parameter>filename</parameter> vaut '.'. - Ceci ne fonctionne pas si PHP est sous la forme d'un module Apache. - Dans ce cas, il faudra écrire le résultat dans un fichier, et utiliser - <function>fpassthru</function> pour l'afficher au client. - </para> - - <para> - Voir aussi <function>fdf_close</function> et pour avoir un exemple - <function>fdf_create</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.fdf-get-value"> - <refnamediv> - <refname>fdf_get_value</refname> - <refpurpose>Mot la valeur d'un champs.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>fdf_get_value</function></funcdef> - <paramdef>int <parameter>fdf_document</parameter></paramdef> - <paramdef>string <parameter>fieldname</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_get_value</function> retourne la valeur d'un champs. - </para> - - <para> - Voir aussi <function>fdf_set_value</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.fdf-set-value"> - <refnamediv> - <refname>fdf_set_value</refname> - <refpurpose>Fixe la valeur d'un champs.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>fdf_set_value</function></funcdef> - <paramdef>int <parameter>fdf_document</parameter></paramdef> - <paramdef>string <parameter>fieldname</parameter></paramdef> - <paramdef>string <parameter>value</parameter></paramdef> - <paramdef>int <parameter>isName</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_set_value</function> fixe la valeur d'un champs. - Le dernier paramètre determine si la valeur doit être convertie en nom PDF - (<parameter>isName</parameter> = 1) ou affecter une chaîne PDF à un contrôle - (<parameter>isName</parameter> = 0). - </para> - - <para> - Voir aussi <function>fdf_get_value</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.fdf-next-field-name"> - <refnamediv> - <refname>fdf_next_field_name</refname> - <refpurpose>Lit le nom du champs suivant.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>fdf_next_field_name</function></funcdef> - <paramdef>int <parameter>fdf_document</parameter></paramdef> - <paramdef>string <parameter>fieldname</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_next_field_name</function> retourne le nom du champs après le champs - <parameter>fieldname</parameter> ou le nom du premier champs, si le second - paramètre est NULL. - </para> - - <para> - Voir aussi <function>fdf_set_value</function> et <function>fdf_get_value</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.fdf-set-ap"> - <refnamediv> - <refname>fdf_set_ap</refname> - <refpurpose>Fixe l'apparence d'un champs.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>fdf_set_ap</function></funcdef> - <paramdef>int <parameter>fdf_document</parameter></paramdef> - <paramdef>string <parameter>field_name</parameter></paramdef> - <paramdef>int <parameter>face</parameter></paramdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>int <parameter>page_number</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_set_ap</function> fixe l'apparence d'un champs - (i.e. la valeur de la clé /AP). - Les valeurs possibles de <parameter>face</parameter> sont - sont 1=FDFNormalAP, 2=FDFRolloverAP, 3=FDFDownAP.</para> - - </refsect1> - </refentry> - - <refentry id="function.fdf-set-status"> - <refnamediv> - <refname>fdf_set_status</refname> - <refpurpose>Fixe la valeur de la clé /STATUS.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>fdf_set_status</function></funcdef> - <paramdef>int <parameter>fdf_document</parameter></paramdef> - <paramdef>string <parameter>status</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_set_status</function> fixe la valeur de la clé /STATUS.</para> - - <para> - Voir aussi <function>fdf_get_status</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.fdf-get-status"> - <refnamediv> - <refname>fdf_get_status</refname> - <refpurpose>Lit la valeur de la clé /STATUS.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>fdf_get_status</function></funcdef> - <paramdef>int <parameter>fdf_document</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_get_status</function> retourne la valeur de la clé /STATUS. - </para> - <para> - Voir aussi <function>fdf_set_status</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.fdf-set-file"> - <refnamediv> - <refname>fdf_set_file</refname> - <refpurpose>Fixe la valeur de la clé /F.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>void <function>fdf_set_file</function></funcdef> - <paramdef>int <parameter>fdf_document</parameter></paramdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_set_file</function> Fixe la valeur de la clé /F. la clé /F est - simplement une référence sur un formulaire PDF qui doit être pré-remplis. - Dans un environnement web, c'est une URL (e.g. http:/testfdf/resultlabel.pdf). - </para> - - <para> - Voir aussi <function>fdf_get_file</function> et pour un exemple, - <function>fdf_create</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.fdf-get-file"> - <refnamediv> - <refname>fdf_get_file</refname> - <refpurpose>Lit la valeur de la clé /F.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>fdf_get_file</function></funcdef> - <paramdef>int <parameter>fdf_document</parameter></paramdef> - </funcsynopsis> - <para> - <function>fdf_set_file</function> lit la valeur de la clé /F. - </para> - <para> - Voir aussi <function>fdf_set_file</function>. - </para> - - </refsect1> - </refentry> - - </reference> - -<!-- 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 -sgml-parent-document:nil -sgml-default-dtd-file:"../manual.ced" -sgml-exposed-tags:nil -sgml-local-catalogs:nil -sgml-local-ecat-files:nil -End: ---> + <reference id="ref.fdf"> + <title>Forms Data Format</title> + <titleabbrev>FDF</titleabbrev> + <partintro> + <simpara> + Forms Data Format (FDF) est un format de fomulaire pour les documents + PDF. Vous pouvez lire la documentation (en anglais) à + <ulink url="&spec.pdf.fdf;">&spec.pdf.fdf;</ulink> + pour plus de détails sur les tenants et les aboutissants. + </simpara> + <note> + <simpara> + Si vous rencontrez des problèmes de configuration de PHP avec le support + fdftk, vérifiez bien que le fichier d'entêtes FdfTk.h et la librairie + libFdfTk.so sont bien situés. Elle devrait être dans les dossiers + fdftk-dir/include et fdftk-dir/lib. Cela ne sera pas le cas si vous + avez simplement décompressé la distribution FdfTk. + </simpara> + </note> + <simpara> + L'esprit de FDF est similaire à celui des formulaires HTML. Les + différences résident dans les moyens de transmission des + données au serveur, lorsque le bouton "submit" (soumettre) est + pressé (ce qui est du ressort de Form Data Format) et le format de + formulaire lui même (qui est plutot du ressort de Portable Document + Format, PDF). Gérer des données FDF est un des objectifs des + fonctions FDF. Mais il y en a d'autres. Vous pouvez aussi prendre un + formulaire PDF, et pré-remplir les champs, sans modifier le + formulaire lui même. Dans ce cas, on va créer un document FDF + (<function>fdf_create</function>), remplir les champs + (<function>fdf_set_value</function>) et l'associer à un fichier PDF + (<function>fdf_set_file</function>). Finalement, le tout sera envoyé + au client, avec le type MIME "application/vnd.fdf". Le module "Acrobat reader" + de votre navigateur va reconnaître ce type MIME, et lire le fichier + PDF, puis le remplis avec FDF. + </simpara> + <simpara> + Si vous éditez un fichier FDF avec un éditeur de texte, vous trouverez + un catalogue d'objet avec le nom de <literal>FDF</literal>. Cet objet + peut contenir des entrées telles que <literal>Fields</literal>, + <literal>F</literal>, <literal>Status</literal> etc.. + Les entrées les plus couramment utilisées sont + <literal>Fields</literal>, qui indique une liste de champs de contrôle, + et <literal>F</literal> qui contient le nom du fichier PDF a qui + appartiennent ces données. Ces entrées sont désignées dans la documentation + PDF sous le nom de /F-Key ou /Status-Key. + La modification de ces entrées est possible avec les fonctions + <function>fdf_set_file</function> et <function>fdf_set_status</function>. + Les champs sont modifiables avec les fonctions + <function>fdf_set_value</function>, <function>fdf_set_opt</function> etc.. + </simpara> + <simpara> + Les exemples suivants montre comme évaluer les données + du formulaire. + </simpara> + <simpara></simpara> + <example> + <title>Evaluer un document FDF</title> + <programlisting> +<?php +// Sauver le fichier FDF dans un fichier temporaire. +$fdffp = fopen("test.fdf", "w"); +fwrite($fdffp, $HTTP_FDF_DATA, strlen($HTTP_FDF_DATA)); +fclose($fdffp); +// Ouvrir le fichier temporaire, et utiliser les données. +// Le formulaire pdf contenait différents fichiers texte, avec pour nom : +// volume, date, comment, publisher, preparer, ainsi que deux boîtes +// à cocher show_publisher et show_preparer. +$fdf = fdf_open("test.fdf"); +$volume = fdf_get_value($fdf, "volume"); +echo "La valeur du champs volume était : '<B>$volume</B>'<BR>"; +$date = fdf_get_value($fdf, "date"); +echo "La valeur du champs date était '<B>$date</B>'<BR>"; +$comment = fdf_get_value($fdf, "comment"); +echo "La valeur du champs comment était '<B>$comment</B>'<BR>"; +if(fdf_get_value($fdf, "show_publisher") == "On") { + $publisher = fdf_get_value($fdf, "publisher"); + echo "La valeur du champs publisher était : '<B>$publisher</B>'<BR>"; +} else + echo "La valeur du champs ne doit pas être affichée.<BR>"; +if(fdf_get_value($fdf, "show_preparer") == "On") { + $preparer = fdf_get_value($fdf, "preparer"); + echo "La valeur du champs preparer était '<B>$preparer</B>'<BR>"; +} else + echo "La valeur du champs Preparer ne doit pas être affiché.<BR>"; +fdf_close($fdf); +?> + </programlisting> + </example> + </partintro> + <refentry id="function.fdf-open"> + <refnamediv> + <refname>fdf_open</refname> + <refpurpose>Ouvre un document FDF.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fdf_open</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + La fonction <function>fdf_open</function> ouvre un fichier avec + formulaire. Le fichier doit contenir les données + retournées par le formulaire PDF. Actuellement, le + fichier doit être créée 'manuellement', + en utilisant la fonction <function>fopen</function> et en y + écrivant le contenu du tableau HTTP_FDF_DATA avec la + fonction <function>fwrite</function>. Un mécanisme + comparable aux formulaires HTML qui créent une variable + pour chaque champs entrant, n'existe pas. + </para> + <para> + <example> + <title>Accéder aux données du formulaire</title> + <programlisting> +<?php +// Sauver le fichier FDF dans un fichier temporaire. +$fdffp = fopen("test.fdf", "w"); +fwrite($fdffp, $HTTP_FDF_DATA, strlen($HTTP_FDF_DATA)); +fclose($fdffp); +// Ouvrir le fichier temporaire, et utiliser les données. +$fdf = fdf_open("test.fdf"); +... +fdf_close($fdf); +?> + </programlisting> + </example> + </para> + <para> + Voir aussi <function>fdf_close</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-close"> + <refnamediv> + <refname>fdf_close</refname> + <refpurpose>Ferme une document FDF.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>fdf_close</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_close</function> ferme le document FDF. + </para> + <para> + Voir aussi <function>fdf_open</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-create"> + <refnamediv> + <refname>fdf_create</refname> + <refpurpose>Crée un nouveau document FDF.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fdf_create</function></funcdef> + <paramdef>void <parameter></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_create</function> crée un nouveau document FDF. + Cette fonction est nécessaire pour ceux qui veulent pré + remplir les champs d'un formulaire dans un fichier PDF. + </para> + <para> + <example> + <title>Pré rempir un formulaire PDF</title> + <programlisting> +<?php +$outfdf = fdf_create(); +fdf_set_value($outfdf, "volume", $volume, 0); +fdf_set_file($outfdf, "http:/testfdf/resultlabel.pdf"); +fdf_save($outfdf, "outtest.fdf"); +fdf_close($outfdf); +Header("Content-type: application/vnd.fdf"); +$fp = fopen("outtest.fdf", "r"); +fpassthru($fp); +unlink("outtest.fdf"); +?> + </programlisting> + </example> + </para> + <para> + Voir aussi <function>fdf_close</function>, <function>fdf_save</function>, + et <function>fdf_open</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-save"> + <refnamediv> + <refname>fdf_save</refname> + <refpurpose>Sauver un document FDF.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fdf_save</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_save</function> sauve un document FDF. + Le FDF Toolkit fournit un moyen d'envoyer le contenu d'un document + FDF à au fichier de sortie stdout si le paramètre + <parameter>filename</parameter> vaut '.'. Ceci ne fonctionne pas + si PHP est sous la forme d'un module Apache. Dans ce cas, il + faudra écrire le résultat dans un fichier, et utiliser + <function>fpassthru</function> pour l'afficher au client. + </para> + <para> + Voir aussi <function>fdf_close</function> et pour avoir un exemple + <function>fdf_create</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-get-value"> + <refnamediv> + <refname>fdf_get_value</refname> + <refpurpose>Mot la valeur d'un champs.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>fdf_get_value</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>fieldname</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_get_value</function> retourne la valeur d'un champs. + </para> + <para> + Voir aussi <function>fdf_set_value</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-set-value"> + <refnamediv> + <refname>fdf_set_value</refname> + <refpurpose>Fixe la valeur d'un champs.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>fdf_set_value</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>fieldname</parameter></paramdef> + <paramdef>string <parameter>value</parameter></paramdef> + <paramdef>int <parameter>isName</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_set_value</function> fixe la valeur d'un champs. + Le dernier paramètre determine si la valeur doit être + convertie en nom PDF (<parameter>isName</parameter> = 1) ou affecter + une chaîne PDF à un contrôle + (<parameter>isName</parameter> = 0). + </para> + <para> + Voir aussi <function>fdf_get_value</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-next-field-name"> + <refnamediv> + <refname>fdf_next_field_name</refname> + <refpurpose>Lit le nom du champs suivant.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>fdf_next_field_name</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>fieldname</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_next_field_name</function> retourne le nom du + champs après le champs <parameter>fieldname</parameter> + ou le nom du premier champs, si le second paramètre est NULL. + </para> + <para> + Voir aussi <function>fdf_set_value</function> et + <function>fdf_get_value</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-set-ap"> + <refnamediv> + <refname>fdf_set_ap</refname> + <refpurpose>Fixe l'apparence d'un champs.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>fdf_set_ap</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>field_name</parameter></paramdef> + <paramdef>int <parameter>face</parameter></paramdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>int <parameter>page_number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_set_ap</function> fixe l'apparence d'un champs + (i.e. la valeur de la clé /AP). + Les valeurs possibles de <parameter>face</parameter> sont + sont 1=FDFNormalAP, 2=FDFRolloverAP, 3=FDFDownAP. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-set-status"> + <refnamediv> + <refname>fdf_set_status</refname> + <refpurpose>Fixe la valeur de la clé /STATUS.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>fdf_set_status</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>status</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_set_status</function> fixe la valeur de la + clé /STATUS. + </para> + <para> + Voir aussi <function>fdf_get_status</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-get-status"> + <refnamediv> + <refname>fdf_get_status</refname> + <refpurpose>Lit la valeur de la clé /STATUS.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>fdf_get_status</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_get_status</function> retourne la + valeur de la clé /STATUS. + </para> + <para> + Voir aussi <function>fdf_set_status</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-set-file"> + <refnamediv> + <refname>fdf_set_file</refname> + <refpurpose>Fixe la valeur de la clé /F.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>fdf_set_file</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_set_file</function> Fixe la valeur de la + clé /F. la clé /F est simplement une + référence sur un formulaire PDF qui doit + être pré-remplis. Dans un environnement web, + c'est une URL (e.g. http:/testfdf/resultlabel.pdf). + </para> + <para> + Voir aussi <function>fdf_get_file</function> et pour un exemple, + <function>fdf_create</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-get-file"> + <refnamediv> + <refname>fdf_get_file</refname> + <refpurpose>Lit la valeur de la clé /F.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>fdf_get_file</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_set_file</function> lit la valeur de la clé /F. + </para> + <para> + Voir aussi <function>fdf_set_file</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-set-flags"> + <refnamediv> + <refname>fdf_set_flags</refname> + <refpurpose>Modifie une option d'un champs</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>fdf_set_flags</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>fieldname</parameter></paramdef> + <paramdef>int <parameter>whichFlags</parameter></paramdef> + <paramdef>int <parameter>newFlags</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_set_flags</function> modifie certaines options + du champs <parameter>fieldname</parameter>. + </para> + <para> + Voir aussi <function>fdf_set_opt</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-set-opt"> + <refnamediv> + <refname>fdf_set_opt</refname> + <refpurpose>Modifie une option d'un champs</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>fdf_set_opt</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>fieldname</parameter></paramdef> + <paramdef>int <parameter>element</parameter></paramdef> + <paramdef>string <parameter>str1</parameter></paramdef> + <paramdef>string <parameter>str2</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_set_opt</function> modifie les options + du champs <parameter>fieldname</parameter>. + </para> + <para> + Voir aussi <function>fdf_set_flags</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-set-submit-form-action"> + <refnamediv> + <refname>fdf_set_submit_form_action</refname> + <refpurpose>Modifie l'action javascript d'un champs</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>fdf_set_submit_form_action</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>fieldname</parameter></paramdef> + <paramdef>int <parameter>trigger</parameter></paramdef> + <paramdef>string <parameter>script</parameter></paramdef> + <paramdef>int <parameter>flags</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fdf_set_submit_form_action</function> affecte un + javascript au champs <parameter>fieldname</parameter>, exécuté + lors de la validation d'un formulaire. + </para> + <para> + Voir aussi <function>fdf_set_javascript_action</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.fdf-set-javascript-action"> + <refnamediv> + <refname>fdf_set_javascript_action</refname> + <refpurpose>Modifie l'action javascript d'un champs</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>fdf_set_javascript_action</function></funcdef> + <paramdef>int <parameter>fdf_document</parameter></paramdef> + <paramdef>string <parameter>fieldname</parameter></paramdef> + <paramdef>int <parameter>trigger</parameter></paramdef> + <paramdef>string <parameter>script</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + The <function>fdf_set_javascript_action</function> affecte un + javascript au champs <parameter>fieldname</parameter>, exécuté + lors de la validation d'un formulaire. + </para> + <para> + Voir aussi <function>fdf_set_submit_form_action</function>. + </para> + </refsect1> + </refentry> + </reference> +<!-- 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 +sgml-parent-document:nil +sgml-default-dtd-file:"../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +-->