PHPBuilder.com, the best resource for PHP tutorials, templates, PHP manuals, content management systems, scripts, classes and more.

Index: phpdoc/fr/functions/fdf.xml diff -u phpdoc/fr/functions/fdf.xml:1.8 phpdoc/fr/functions/fdf.xml:1.9 --- phpdoc/fr/functions/fdf.xml:1.8 Sat Jul 7 18:22:07 2001 +++ phpdoc/fr/functions/fdf.xml Fri Jul 13 13:51:07 2001 @@ -1,62 +1,64 @@ - - Forms Data Format - FDF - + + Forms Data Format + FDF + + + Forms Data Format (FDF) est un format de fomulaire pour les documents + PDF. Vous pouvez lire la documentation (en anglais) à + &spec.pdf.fdf; + pour plus de détails sur les tenants et les aboutissants. + + - Forms Data Format (FDF) est un format de fomulaire pour les documents - PDF. Vous pouvez lire la documentation (en anglais) à - &spec.pdf.fdf; - pour plus de détails sur les tenants et les aboutissants. + Si vous rencontrez des problèmes de configuration de PHP avec le support + fdftk, vérifiez bien que le fichier d'en-tê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. - - - 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. - - - - 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 plutôt 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 - (fdf_create), remplir les champs - (fdf_set_value) et l'associer à un fichier PDF - (fdf_set_file). 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. - - - Si vous éditez un fichier FDF avec un éditeur de texte, vous trouverez - un catalogue d'objet avec le nom de FDF. Cet objet - peut contenir des entrées telles que Fields, - F, Status etc.. - Les entrées les plus couramment utilisées sont - Fields, qui indique une liste de champs de contrôle, - et F 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 - fdf_set_file et fdf_set_status. - Les champs sont modifiables avec les fonctions - fdf_set_value, fdf_set_opt etc.. - - - Les exemples suivants montre comme évaluer les données - du formulaire. - - - - Evaluer un document FDF - + + + 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 plutôt 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 + (fdf_create), remplir les champs + (fdf_set_value) et l'associer à un fichier PDF + (fdf_set_file). 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. + + + Si vous éditez un fichier FDF avec un éditeur de texte, vous trouverez + un catalogue d'objet avec le nom de FDF. Cet objet + peut contenir des entrées telles que Fields, + F, Status etc.. + Les entrées les plus couramment utilisées sont + Fields, qui indique une liste de champs de contrôle, + et F 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 + fdf_set_file et fdf_set_status. + Les champs sont modifiables avec les fonctions + fdf_set_value, fdf_set_opt etc.. + + + Les exemples suivants montre comme évaluer les données + du formulaire. + + + + Evaluer un document FDF + <?php // Sauver le fichier FDF dans un fichier temporaire. $fdffp = fopen("test.fdf", "w"); @@ -68,51 +70,51 @@ // à cocher show_publisher et show_preparer. $fdf = fdf_open("test.fdf"); $volume = fdf_get_value($fdf, "volume"); -echo "La valeur du champs volume était : '$volume' "; +echo "La valeur du champs volume était : '$volume' "; $date = fdf_get_value($fdf, "date"); -echo "La valeur du champs date était '$date' "; +echo "La valeur du champs date était '$date' "; $comment = fdf_get_value($fdf, "comment"); -echo "La valeur du champs comment était '$comment' "; +echo "La valeur du champs comment était '$comment' "; if(fdf_get_value($fdf, "show_publisher") == "On") { $publisher = fdf_get_value($fdf, "publisher"); - echo "La valeur du champs publisher était : '$publisher' "; + echo "La valeur du champs publisher était : '$publisher' "; } else - echo "La valeur du champs ne doit pas être affichée. "; + echo "La valeur du champs ne doit pas être affichée. "; if(fdf_get_value($fdf, "show_preparer") == "On") { $preparer = fdf_get_value($fdf, "preparer"); - echo "La valeur du champs preparer était '$preparer' "; + echo "La valeur du champs preparer était '$preparer' "; } else - echo "La valeur du champs Preparer ne doit pas être affiché. "; + echo "La valeur du champs Preparer ne doit pas être affiché. "; fdf_close($fdf); ?> - - - - - - fdf_open - Ouvre un document FDF. - - - Description - - - resource fdf_open - string filename - - - - fdf_open 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 fopen et en y - écrivant le contenu du tableau HTTP_FDF_DATA avec la - fonction fwrite. Un mécanisme - comparable aux formulaires HTML qui créent une variable - pour chaque champs entrant, n'existe pas. - - + + + + + + fdf_open + Ouvre un document FDF. + + + Description + + + resource fdf_open + string filename + + + + fdf_open 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 fopen et en y + écrivant le contenu du tableau HTTP_FDF_DATA avec la + fonction fwrite. Un mécanisme + comparable aux formulaires HTML qui créent une variable + pour chaque champs entrant, n'existe pas. + + Accéder aux données du formulaire @@ -128,54 +130,56 @@ ?> - - - Voir aussi fdf_close. - - - - - - fdf_close - Ferme une document FDF. - - - Description - - - boolean fdf_close - resource fdf_document - - - - fdf_close ferme le document FDF. - - - Voir aussi fdf_open. - - - - - - fdf_create - Crée un nouveau document FDF. - - - Description - - - int fdf_create - void - - - - fdf_create 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. - - + + + Voir aussi + fdf_close. + + + + + + fdf_close + Ferme un document FDF. + + + Description + + + boolean fdf_close + resource fdf_document + + + + fdf_close ferme le document FDF. + + + Voir aussi + fdf_open. + + + + + + fdf_create + Crée un nouveau document FDF. + + + Description + + + int fdf_create + void + + + + fdf_create 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. + + - Pré rempir un formulaire PDF + Pré remplir un formulaire PDF <?php $outfdf = fdf_create(); @@ -188,341 +192,382 @@ fpassthru($fp); unlink("outtest.fdf"); ?> - - - - - Voir aussi fdf_close, fdf_save, - et fdf_open. - - - - - - fdf_save - Sauver un document FDF. - - - Description - - - int fdf_save - string filename - - - - fdf_save 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 - filename 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 - fpassthru pour l'afficher au client. - - - Voir aussi fdf_close et pour avoir un exemple - fdf_create. - - - - - - fdf_get_value - Mot la valeur d'un champs. - - - Description - - - string fdf_get_value - int fdf_document - string fieldname - - - - fdf_get_value retourne la valeur d'un champs. - - - Voir aussi fdf_set_value. - - - - - - fdf_set_value - Fixe la valeur d'un champs. - - - Description - - - boolean fdf_set_value - int fdf_document - string fieldname - string value - int isName - - - - fdf_set_value fixe la valeur d'un champs. - Le dernier paramètre détermine si la valeur doit être - convertie en nom PDF (isName = 1) ou affecter - une chaîne PDF à un contrôle - (isName = 0). - - - Voir aussi fdf_get_value. - - - - - - fdf_next_field_name - Lit le nom du champs suivant. - - - Description - - - string fdf_next_field_name - int fdf_document - string fieldname - - - - fdf_next_field_name retourne le nom du - champs après le champs fieldname - ou le nom du premier champs, si le second paramètre est &null;. - - - Voir aussi fdf_set_value et - fdf_get_value. - - - - - - fdf_set_ap - Fixe l'apparence d'un champs. - - - Description - - - boolean fdf_set_ap - int fdf_document - string field_name - int face - string filename - int page_number - - - - fdf_set_ap fixe l'apparence d'un champs - (i.e. la valeur de la clé /AP). - Les valeurs possibles de face sont - sont 1=FDFNormalAP, 2=FDFRolloverAP, 3=FDFDownAP. - - - - - - fdf_set_status - Fixe la valeur de la clé /STATUS. - - - Description - - - boolean fdf_set_status - int fdf_document - string status - - - - fdf_set_status fixe la valeur de la - clé /STATUS. - - - Voir aussi fdf_get_status. - - - - - - fdf_get_status - Lit la valeur de la clé /STATUS. - - - Description - - - string fdf_get_status - int fdf_document - - - - fdf_get_status retourne la - valeur de la clé /STATUS. - - - Voir aussi fdf_set_status. - - - - - - fdf_set_file - Fixe la valeur de la clé /F. - - - Description - - - boolean fdf_set_file - int fdf_document - string filename - - - - fdf_set_file 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). - - - Voir aussi fdf_get_file et pour un exemple, - fdf_create. - - - - - - fdf_get_file - Lit la valeur de la clé /F. - - - Description - - - string fdf_get_file - int fdf_document - - - - fdf_set_file lit la valeur de la clé /F. - - - Voir aussi fdf_set_file. - - - - - - fdf_set_flags - Modifie une option d'un champs - - - Description - - - boolean fdf_set_flags - int fdf_document - string fieldname - int whichFlags - int newFlags - - - - fdf_set_flags modifie certaines options - du champs fieldname. - - - Voir aussi fdf_set_opt. - - - - - - fdf_set_opt - Modifie une option d'un champs - - - Description - - - boolean fdf_set_opt - int fdf_document - string fieldname - int element - string str1 - string str2 - - - - fdf_set_opt modifie les options - du champs fieldname. - - - Voir aussi fdf_set_flags. - - - - - - fdf_set_submit_form_action - Modifie l'action javascript d'un champs - - - Description - - - boolean fdf_set_submit_form_action - int fdf_document - string fieldname - int trigger - string script - int flags - - - - fdf_set_submit_form_action affecte un - javascript au champs fieldname, exécuté - lors de la validation d'un formulaire. - - - Voir aussi fdf_set_javascript_action. - - - - - - fdf_set_javascript_action - Modifie l'action javascript d'un champs - - - Description - - - boolean fdf_set_javascript_action - int fdf_document - string fieldname - int trigger - string script - - - - The fdf_set_javascript_action affecte un - javascript au champs fieldname, exécuté - lors de la validation d'un formulaire. + + + + + Voir aussi + fdf_close, + fdf_save et + fdf_open. + + + + + + fdf_save + Sauver un document FDF. + + + Description + + + int fdf_save + string filename + + + + fdf_save 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 + filename 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 + fpassthru pour l'afficher au client. + + + Voir aussi + fdf_close et pour avoir un exemple + fdf_create. + + + + + + fdf_get_value + Mot la valeur d'un champs. + + + Description + + + string fdf_get_value + int fdf_document + string fieldname + + + + fdf_get_value retourne la valeur d'un champs. + + + Voir aussi + fdf_set_value. + + + + + + fdf_set_value + Fixe la valeur d'un champs. + + + Description + + + boolean fdf_set_value + int fdf_document + string fieldname + string value + int isName + + + + fdf_set_value fixe la valeur d'un champs. + Le dernier paramètre détermine si la valeur doit être + convertie en nom PDF (isName = 1) ou affecter + une chaîne PDF à un contrôle + (isName = 0). + + + Voir aussi + fdf_get_value. + + + + + + fdf_next_field_name + Lit le nom du champs suivant. + + + Description + + + string fdf_next_field_name + int fdf_document + string fieldname + + + + fdf_next_field_name retourne le nom du + champs après le champs fieldname + ou le nom du premier champs, si le second paramètre est NULL. + + + Voir aussi + fdf_set_value et + fdf_get_value. + + + + + + fdf_set_ap + Fixe l'apparence d'un champs. + + + Description + + + boolean fdf_set_ap + int fdf_document + string field_name + int face + string filename + int page_number + + + + fdf_set_ap fixe l'apparence d'un champs + (i.e. la valeur de la clé /AP). + Les valeurs possibles de face sont + sont 1=FDFNormalAP, 2=FDFRolloverAP, 3=FDFDownAP. + + + + + + fdf_set_status + Fixe la valeur de la clé /STATUS. + + + Description + + + boolean fdf_set_status + int fdf_document + string status + + + + fdf_set_status fixe la valeur de la + clé /STATUS. + + + Voir aussi + fdf_get_status. + + + + + + fdf_get_status + Lit la valeur de la clé /STATUS. + + + Description + + + string fdf_get_status + int fdf_document + + + + fdf_get_status retourne la + valeur de la clé /STATUS. + + + Voir aussi + fdf_set_status. + + + + + + fdf_set_file + Fixe la valeur de la clé /F. + + + Description + + + boolean fdf_set_file + int fdf_document + string filename + + + + fdf_set_file 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). + + + Voir aussi + fdf_get_file et pour un exemple, + fdf_create. + + + + + + fdf_get_file + Lit la valeur de la clé /F. + + + Description + + + string fdf_get_file + int fdf_document + + + + fdf_set_file lit la valeur de la clé /F. + + + Voir aussi + fdf_set_file. + + + + + + fdf_set_flags + Modifie une option d'un champs + + + Description + + + boolean fdf_set_flags + int fdf_document + string fieldname + int whichFlags + int newFlags + + + + fdf_set_flags modifie certaines options + du champs fieldname. + + + Voir aussi + fdf_set_opt. + + + + + + fdf_set_opt + Modifie une option d'un champs + + + Description + + + boolean fdf_set_opt + int fdf_document + string fieldname + int element + string str1 + string str2 + + + + fdf_set_opt modifie les options + du champs fieldname. + + + Voir aussi + fdf_set_flags. + + + + + + fdf_set_submit_form_action + Modifie l'action javascript d'un champs + + + Description + + + boolean fdf_set_submit_form_action + int fdf_document + string fieldname + int trigger + string script + int flags + + + + fdf_set_submit_form_action affecte un + javascript au champs fieldname, exécuté + lors de la validation d'un formulaire. + + + Voir aussi + fdf_set_javascript_action. + + + + + + fdf_set_javascript_action + Modifie l'action javascript d'un champs + + + Description + + + boolean fdf_set_javascript_action + int fdf_document + string fieldname + int trigger + string script + + + + fdf_set_javascript_action affecte un + javascript au champs fieldname, exécuté + lors de la validation d'un formulaire. + + + Voir aussi + fdf_set_submit_form_action. + + + + + + fdf_set_encoding + Modifie l'encodage des caractères + + + Description + + + bool fdf_set_encoding + int fdf_document + string encoding + + + + fdf_set_encoding modifie l'encodage des + caractères du document FDF fdf_document. + Le paramètre encoding doit être un + nom d'encodage valide, tels que "Shift-JIS" ou + "Unicode". - Voir aussi fdf_set_submit_form_action. + fdf_set_encoding a été ajoutée + en PHP 4.0.7. - +

Columns / Articles | Tips / Quickies | News | News Linking and RSS Feeds | Shared Code Library
Mail Archives | Support / Discussion Forums | Get Started! Links | Contribute! | Docs