cvs: phpdoc-de /reference/fdf reference.xml /reference/fdf/functions fdf-add-template.xml fdf-close.xml fdf-create.xml fdf-get-file.xml
fdf-get-status.xml fdf-get-value.xml fdf-next-field-name.xml fdf-open.xml fdf-save.xml fdf-set-ap.xml fdf-set-encoding.xml fdf-set-file.xml
fdf-set-flags.xml fdf-set-javascript-action.xml fdf-set-opt.xml fdf-set-status.xml fdf-set-submit-form-action.xml fdf-set-value.xml
| From: | Stefan Saasen | Date: | Mon, 16 Dec 2002 14:50:46 +0000 |
| Subject: | cvs: phpdoc-de /reference/fdf reference.xml /reference/fdf/functions fdf-add-template.xml fdf-close.xml fdf-create.xml fdf-get-file.xml fdf-get-status.xml fdf-get-value.xml fdf-next-field-name.xml fdf-open.xml fdf-save.xml fdf-set-ap.xml fdf-set-encoding.xml fdf-set-file.xml fdf-set-flags.xml fdf-set-javascript-action.xml fdf-set-opt.xml fdf-set-status.xml fdf-set-submit-form-action.xml fdf-set-value.xml |
||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-375@lists.php.net to get a copy of this message | ||
sts Mon Dec 16 09:50:46 2002 EDT
Modified files:
/phpdoc-de/reference/fdf reference.xml
/phpdoc-de/reference/fdf/functions fdf-add-template.xml
fdf-close.xml fdf-create.xml
fdf-get-file.xml
fdf-get-status.xml
fdf-get-value.xml
fdf-next-field-name.xml
fdf-open.xml fdf-save.xml
fdf-set-ap.xml
fdf-set-encoding.xml
fdf-set-file.xml
fdf-set-flags.xml
fdf-set-javascript-action.xml
fdf-set-opt.xml
fdf-set-status.xml
fdf-set-submit-form-action.xml
fdf-set-value.xml
Log:
syncing with EN
Index: phpdoc-de/reference/fdf/reference.xml diff -u phpdoc-de/reference/fdf/reference.xml:1.3 phpdoc-de/reference/fdf/reference.xml:1.4 --- phpdoc-de/reference/fdf/reference.xml:1.3 Fri May 31 13:24:35 2002 +++ phpdoc-de/reference/fdf/reference.xml Mon Dec 16 09:50:36 2002 @@ -1,26 +1,20 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.7 Maintainer: sts Status: ready --> <reference id="ref.fdf"> <title>Forms Data Format Funktionen</title> <titleabbrev>FDF</titleabbrev> <partintro> + + <section id="fdf.intro"> + &reftitle.intro; <simpara> Forms Data Format (FDF) ist ein Format zur Verarbeitung von Formularen innerhalb von PDF Dokumenten. Weiterführende Informationen zu FDF und dessen Verwendung sind unter <ulink url="&spec.pdf.fdf;">&spec.pdf.fdf;</ulink> zu finden. </simpara> - <note> - <simpara> - Bei Problemen mit der Konfiguration der FdfTk-Unterstützung - sollte man überprüfen, ob die Datei FdfTk.h sowie die Bibliothek - libFdfTk.so im richtigen Verzeichnis zu finden sind. Die - korrekten Verzeichnisse sind fdftk-dir/include und - fdftk-dir/lib. Das ausschließliche Entpacken der Distribution - führt nicht zu dem gewünschten Ergebnis. - </simpara> - </note> <simpara> Der Ansatz den FDF verfolgt, ist vergleichbar mit dem üblicher HTML Formulare. Die wesentlichen Unterschiede liegen in der @@ -28,7 +22,7 @@ eigentliche Form Data Format), sowie in dem Format des Dokuments welches das Formular enthält(PDF). Die Verarbeitung der FDF Daten ist eine der Möglichkeiten, die die FDF Funktionen bereitstellen. - Darüberhinaus kann man beispielsweise innerhalb eines vorhandenen + Darüber hinaus kann man beispielsweise innerhalb eines vorhandenen PDF Formulars die Input Felder dynamisch mit Daten füllen, ohne das Formular selbst zu verändern. Hierzu erzeugt man das FDF Dokument (<function>fdf_create</function>), setzt die Werte der @@ -38,11 +32,12 @@ Dokument, mit dem passenden MimeType <literal>application/vnd.fdf</literal> versehen, ausgegeben hat, erkennt das Acrobat Reader PlugIn des Browsers den MimeType und - füllt das Zielformular mit den Daten des FDF Dokuments. + füllt das Zielformular mit den Daten des FDF Dokuments. </simpara> + <simpara> Betrachtet man ein FDF Dokument mit einem Text Editor, findet sich - dort ein Katalog Objekt <literal>FDF</literal>. Dieses Objekt kann + dort ein Katalog-Objekt <literal>FDF</literal>. Dieses Objekt kann mehrere Einträge der Art <literal>Fields</literal>, <literal>F</literal>, <literal>Status</literal> etc.. enthalten. Die gebräuchlichsten Einträge sind @@ -54,16 +49,57 @@ <function>fdf_set_file</function> und <function>fdf_set_status</function> vorgenommen. Felder werden u.a. mit <function>fdf_set_value</function>, - <function>fdf_set_opt</function> modifiziert. - </simpara> - <simpara> - Das Beispiel zeigt die Auswertung der Formular Daten. - </simpara> - <simpara> + <function>fdf_set_opt</function> modifiziert. </simpara> - <example> - <title>Auswertung eines FDF Dokuments</title> - <programlisting role="php"> + </section> + + <section id="fdf.requirements"> + &reftitle.required; + <para> + Benötigt wird das FDF-Toolkit-SDK, welches unter + <ulink url="&spec.pdf.fdf;">&spec.pdf.fdf;</ulink> + heruntergeladen werden kann. + Ab PHP-Version 4.3 ist mindestens die Version 5.0 + des FDF-SDKs erforderlich. + Die FDF-Toolkit Bibliothek steht ausschließlich vorkompiliert + zur Verfügung. Von Adobe unterstütze Plattformen sind Win32, Linux, + Solaris und AIX. + </para> + </section> + + &reference.fdf.configure; + + <section id="fdf.configuration"> + &reftitle.runtime; + &no.config; + </section> + + <section id="fdf.resources"> + &reftitle.resources; + <section id="fdf.resources.fdf"> + <title>fdf</title> + <para> + Die meisten FDF-Funktionen benötigen an erster Stelle einen + <parameter>fdf</parameter> Ressource-Parameter. + Der Parameter <parameter>fdf</parameter> ist ein Zeiger auf + eine geöffnete FDF-Datei. + <parameter>fdf</parameter> Ressource-Parameter werden von den + Funktionen <function>fdf_create</function>, + <function>fdf_open</function> und <function>fdf_open_string</function> + zurückgegeben. + </para> + </section> + </section> + + &reference.fdf.constants; + + <section id="fdf.examples"> + &reftitle.examples; + <para> + Das Beispiel zeigt die Auswertung der Formular Daten. + <example> + <title>Auswertung eines FDF_Dokuments</title> + <programlisting role="php"> <![CDATA[ <?php // Speichern der FDF Daten in eine temporäre Datei @@ -102,10 +138,12 @@ fdf_close($fdf); ?> ]]> - </programlisting> - </example> - </partintro> - + </programlisting> + </example> + </para> + </section> + </partintro> + &reference.fdf.functions; </reference> @@ -125,5 +163,10 @@ 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 +--> + + Index: phpdoc-de/reference/fdf/functions/fdf-add-template.xml diff -u phpdoc-de/reference/fdf/functions/fdf-add-template.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-add-template.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-add-template.xml:1.3 Sun Jun 9 06:55:36 2002 +++ phpdoc-de/reference/fdf/functions/fdf-add-template.xml Mon Dec 16 09:50:43 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.17 --> <!-- last change to 'fdf-add-template' in en/ tree in rev 1.12 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.2 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.12 --> <refentry id='function.fdf-add-template'> <refnamediv> Index: phpdoc-de/reference/fdf/functions/fdf-close.xml diff -u phpdoc-de/reference/fdf/functions/fdf-close.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-close.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-close.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-close.xml Mon Dec 16 09:50:43 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-close' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-close"> <refnamediv> @@ -13,7 +13,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_close</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> </methodsynopsis> <para> Die Funktion <function>fdf_close</function> schließt das FDF Index: phpdoc-de/reference/fdf/functions/fdf-create.xml diff -u phpdoc-de/reference/fdf/functions/fdf-create.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-create.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-create.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-create.xml Mon Dec 16 09:50:43 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-create' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-create"> <refnamediv> @@ -12,7 +12,7 @@ <refsect1> <title>Beschreibung</title> <methodsynopsis> - <type>int</type><methodname>fdf_create</methodname> + <type>resource</type><methodname>fdf_create</methodname> <void/> </methodsynopsis> <para> Index: phpdoc-de/reference/fdf/functions/fdf-get-file.xml diff -u phpdoc-de/reference/fdf/functions/fdf-get-file.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-get-file.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-get-file.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-get-file.xml Mon Dec 16 09:50:43 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-get-file' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-get-file"> <refnamediv> @@ -13,7 +13,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>fdf_get_file</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> </methodsynopsis> <para> Die Funktion <function>fdf_set_file</function> gibt den Wert Index: phpdoc-de/reference/fdf/functions/fdf-get-status.xml diff -u phpdoc-de/reference/fdf/functions/fdf-get-status.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-get-status.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-get-status.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-get-status.xml Mon Dec 16 09:50:44 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-get-status' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-get-status"> <refnamediv> @@ -15,7 +15,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>fdf_get_status</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> </methodsynopsis> <para> Die Funktion <function>fdf_get_status</function> gibt den Wert Index: phpdoc-de/reference/fdf/functions/fdf-get-value.xml diff -u phpdoc-de/reference/fdf/functions/fdf-get-value.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-get-value.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-get-value.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-get-value.xml Mon Dec 16 09:50:44 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-get-value' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-get-value"> <refnamediv> @@ -13,13 +13,29 @@ <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>fdf_get_value</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>fieldname</parameter></methodparam> + <methodparam choice='opt'><type>int</type><parameter>which</parameter></methodparam> </methodsynopsis> <para> Die Funktion <function>fdf_get_value</function> gibt den Wert - eines Feldes zurück. + für den Parameter <parameter>fieldname</parameter> zurück. </para> + + <para> + Elemente eines Arrays können abgefragt werden, indem der optionale + Parameter <parameter>which</parameter> übergeben wird. Die Elemente des + abzufragenden Arrays starten bei Null. + Bei Nicht-Array-Feldern wird der Parameter <parameter>which</parameter> + ignoriert. + </para> + <note> + <para> + Der optionale Parameter <parameter>which</parameter> und die Möglichkeit + Arrays abzufragen wurden ab PHP-Version 4.3 hinzugefügt. + </para> + </note> + <para> Siehe auch <function>fdf_set_value</function>. </para> Index: phpdoc-de/reference/fdf/functions/fdf-next-field-name.xml diff -u phpdoc-de/reference/fdf/functions/fdf-next-field-name.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-next-field-name.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-next-field-name.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-next-field-name.xml Mon Dec 16 09:50:44 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-next-field-name' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-next-field-name"> <refnamediv> @@ -13,7 +13,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>fdf_next_field_name</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>fieldname</parameter></methodparam> </methodsynopsis> <para> @@ -22,6 +22,25 @@ Namen des ersten Feldes zurück, wenn der Parameter &null; ist. </para> + + <para> + <example> + <title>Detecting all fieldnames in a FDF</title> + <programlisting> +<![CDATA[ +<?php + $fdf = fdf_open($HTTP_FDF_DATA); + for($field = fdf_next_field_name($fdf); + $field != ""; + $field = fdf_next_field_name($fdf, $field)) { + echo "field: $field\n"; + } +?> +]]> + </programlisting> + </example> + </para> + <para> Siehe auch <function>fdf_set_field</function>, <function>fdf_get_field</function>. Index: phpdoc-de/reference/fdf/functions/fdf-open.xml diff -u phpdoc-de/reference/fdf/functions/fdf-open.xml:1.4 phpdoc-de/reference/fdf/functions/fdf-open.xml:1.5 --- phpdoc-de/reference/fdf/functions/fdf-open.xml:1.4 Wed Oct 23 07:07:22 2002 +++ phpdoc-de/reference/fdf/functions/fdf-open.xml Mon Dec 16 09:50:44 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-open' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-open"> <refnamediv> @@ -12,23 +12,29 @@ <refsect1> <title>Beschreibung</title> <methodsynopsis> - <type>int</type><methodname>fdf_open</methodname> + <type>resource</type><methodname>fdf_open</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> + <para> - Die Funktion <function>fdf_open</function> öffnet eine Datei mit - Formulardaten. Diese Datei muss die von einem PDF Formular - zurückgegebenen Formulardaten enthalten. Momentan muss diese - Datei 'manuell' erzeugt werden. Mit Hilfe von - <function>fopen</function> schreibt man den Inhalt von - HTTP_FDF_DATA mit <function>fwrite</function> in die Datei. Eine - automatische Vorbelegung von Variablen mit den Daten der - Eingabefelder, wie sie bei HTML Formularen möglich ist, existiert - in diesem Fall nicht. + Die Funktion <function>fdf_open</function> öffnet eine Datei + mit Formulardaten. Diese Datei muss entweder die von einem PDF Formular + zurückgegebenen Formulardaten oder Formulardaten, die mit + <function>fdf_create</function> und + <function>fdf_save</function> erzeugt wurden, enthalten. </para> <para> + Das Ergebnis eines per POST übergebenen PDF-Formulars kann verarbeitet werden, + indem die Daten aus <varname>$HTTP_FDF_DATA</varname> in eine Datei + geschrieben und mit Hilfe von <function>fdf_open</function> zugänglich + gemacht werden. + Ab PHP-Version 4.3 steht darüber hinaus die Funktion <function>fdf_open_string</function> + zur Verfügung, die die temporäre Dateierzeugung und -löschung übernimmt. + </para> + + <para> <example> - <title>Zugang zu den Fornmulardaten</title> + <title>Zugang zu den Formulardaten</title> <programlisting> <![CDATA[ <?php @@ -47,7 +53,11 @@ </example> </para> <para> - Siehe auch <function>fdf_close</function>. + Siehe auch + <function>fdf_open_string</function>, + <function>fdf_close</function>, + <function>fdf_create</function> und + <function>fdf_save</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/fdf/functions/fdf-save.xml diff -u phpdoc-de/reference/fdf/functions/fdf-save.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-save.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-save.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-save.xml Mon Dec 16 09:50:44 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-save' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-save"> <refnamediv> @@ -12,23 +12,25 @@ <refsect1> <title>Beschreibung</title> <methodsynopsis> - <type>int</type><methodname>fdf_save</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <type>bool</type><methodname>fdf_save</methodname> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> + <para> - Die Funktion <function>fdf_save</function> speichert ein FDF - Dokument. Das FDF Toolkit stellt eine Möglichkeit zur Verfügung, - das Dokument an der Standardausgabe auszugeben, wenn der - Parameter <parameter>filename</parameter> '.' ist. Dies - funktioniert allerdings nicht, wenn PHP als Apache Module - verwendet wird. In diesem Fall sollte man die Ausgabe in eine - Datei schreiben und die Funktion <function>fpassthru</function> - verwenden, um den Inhalt anzuzeigen. + Die Funktion <function>fdf_save</function> function speichert ein FDF + Dokument. + Das erzeugte Dokument wird in der Datei <parameter>filename</parameter> + gespeichert. + Ohne den Parameter <parameter>filename</parameter> gibt + <function>fdf_save</function> das Dokument an der Standardausgabe aus. </para> <para> - Siehe auch <function>fdf_close</function> and example for - <function>fdf_create</function>. - </para> + Siehe auch <function>fdf_save_string</function>, + <function>fdf_create</function> und + <function>fdf_close</function>. + </para> + </refsect1> </refentry> Index: phpdoc-de/reference/fdf/functions/fdf-set-ap.xml diff -u phpdoc-de/reference/fdf/functions/fdf-set-ap.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-set-ap.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-set-ap.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-set-ap.xml Mon Dec 16 09:50:44 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-set-ap' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-set-ap"> <refnamediv> @@ -13,7 +13,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_set_ap</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>field_name</parameter></methodparam> <methodparam><type>int</type><parameter>face</parameter></methodparam> <methodparam><type>string</type><parameter>filename</parameter></methodparam> @@ -21,9 +21,10 @@ </methodsynopsis> <para> Die Funktion <function>fdf_set_ap</function> legt das Aussehen - eines Feldes (d.h den Wert des /AP Schlüssels) fest. Mögliche - Werte von <parameter>face</parameter> sind 1=FDFNormalAP, - 2=FDFRolloverAP, 3=FDFDownAP. + eines Feldes (d.h. den Wert des /AP Schlüssels) fest. Mögliche + Werte von <parameter>face</parameter> sind + <constant>FDFNormalAP</constant>, <constant>FDFRolloverAP</constant> + und <constant>FDFDownAP</constant>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/fdf/functions/fdf-set-encoding.xml diff -u phpdoc-de/reference/fdf/functions/fdf-set-encoding.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-set-encoding.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-set-encoding.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-set-encoding.xml Mon Dec 16 09:50:44 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.8 --> <!-- last change to 'fdf-set-encoding' in en/ tree in rev 1.24 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.24 --> <refentry id="function.fdf-set-encoding"> <refnamediv> @@ -15,7 +15,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_set_encoding</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>encoding</parameter></methodparam> </methodsynopsis> <para> @@ -25,6 +25,8 @@ "<literal>Shift_JIS</literal>", "<literal>UHC</literal>", "<literal>GBK</literal>","<literal>BigFive</literal>" gültige Werte für den Parameter <parameter>encoding</parameter>. + Ein leerer String setzt die Kodierung auf den voreingestellten Wert + PDFDocEncoding/Unicode. </para> <para> Die Funktion <function>fdf_set_encoding</function> ist ab Index: phpdoc-de/reference/fdf/functions/fdf-set-file.xml diff -u phpdoc-de/reference/fdf/functions/fdf-set-file.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-set-file.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-set-file.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-set-file.xml Mon Dec 16 09:50:44 2002 @@ -1,35 +1,65 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-set-file' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-set-file"> <refnamediv> <refname>fdf_set_file</refname> - <refpurpose>Setzt den Wert des /F Schlüssels</refpurpose> + <refpurpose>Definiert ein PDF-Dokument, das FDF-Daten anzeigen soll</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_set_file</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>target_frame</parameter></methodparam> </methodsynopsis> <para> - Die Funktion <function>fdf_set_file</function> setzt den Wert des - /F Schlüssels. Der /F Schlüssel ist eine Referenz zu einem PDF - Formular welches mit Daten gefüllt werden soll. In einer Web - Umgebung ist diese Referenz ein URL - (z.B. http:/testfdf/resultlabel.pdf). + Die Funktion <function>fdf_set_file</function> wählt ein PDF-Dokument + aus, in dem FDF-Formulardaten angezeigt werden sollen. + Der Parameter <parameter>url</parameter> muss als absolute URL angegeben + werden. </para> <para> - Siehe auch <function>fdf_get_file</function> und das Beispiel zu - <function>fdf_create</function>. + Der Rahmen in den das Dokument angezeigt werden soll, kann mit dem + optionalen Parameter <parameter>target_frame</parameter> oder der + Funktion <function>fdf_set_target_frame</function> festgelegt werden. </para> + <example> + <title>FDF-Daten in einem anderen Dokument anzeigen</title> + <programlisting> +<![CDATA[ +<?php + /* set content type for Adobe FDF */ + fdf_header(); + + /* start new fdf */ + $fdf = fdf_create(); + + /* set field "foo" to value "bar" */ + $fdf_set_value($fdf, "foo", "bar"); + + /* tell client to display FDF data using "fdf_form.pdf" */ + fdf_set_file($fdf, "http://www.example.com/fdf_form.pdf"); + + /* output fdf */ + fdf_save(); + + /* clean up */ + fdf_close(); +?> +]]> + </programlisting> + </example> + <para> + Siehe auch <function>fdf_get_file</function> und + <function>fdf_set_target_frame</function>. + </para> </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml Index: phpdoc-de/reference/fdf/functions/fdf-set-flags.xml diff -u phpdoc-de/reference/fdf/functions/fdf-set-flags.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-set-flags.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-set-flags.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-set-flags.xml Mon Dec 16 09:50:45 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.5 --> <!-- last change to 'fdf-set-flags' in en/ tree in rev 1.6 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.6 --> <refentry id="function.fdf-set-flags"> <refnamediv> @@ -13,7 +13,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_set_flags</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>fieldname</parameter></methodparam> <methodparam><type>int</type><parameter>whichFlags</parameter></methodparam> <methodparam><type>int</type><parameter>newFlags</parameter></methodparam> Index: phpdoc-de/reference/fdf/functions/fdf-set-javascript-action.xml diff -u phpdoc-de/reference/fdf/functions/fdf-set-javascript-action.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-set-javascript-action.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-set-javascript-action.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-set-javascript-action.xml Mon Dec 16 09:50:45 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.5 --> <!-- last change to 'fdf-set-javascript-action' in en/ tree in rev 1.6 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.6 --> <refentry id="function.fdf-set-javascript-action"> <refnamediv> @@ -15,7 +15,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_set_javascript_action</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>fieldname</parameter></methodparam> <methodparam><type>int</type><parameter>trigger</parameter></methodparam> <methodparam><type>string</type><parameter>script</parameter></methodparam> Index: phpdoc-de/reference/fdf/functions/fdf-set-opt.xml diff -u phpdoc-de/reference/fdf/functions/fdf-set-opt.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-set-opt.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-set-opt.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-set-opt.xml Mon Dec 16 09:50:45 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.5 --> <!-- last change to 'fdf-set-opt' in en/ tree in rev 1.6 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.6 --> <refentry id="function.fdf-set-opt"> <refnamediv> @@ -13,7 +13,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_set_opt</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>fieldname</parameter></methodparam> <methodparam><type>int</type><parameter>element</parameter></methodparam> <methodparam><type>string</type><parameter>str1</parameter></methodparam> Index: phpdoc-de/reference/fdf/functions/fdf-set-status.xml diff -u phpdoc-de/reference/fdf/functions/fdf-set-status.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-set-status.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-set-status.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-set-status.xml Mon Dec 16 09:50:45 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-set-status' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-set-status"> <refnamediv> @@ -13,12 +13,13 @@ <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_set_status</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>status</parameter></methodparam> </methodsynopsis> <para> Die Funktion <function>fdf_set_status</function> setzt den Wert - des /STATUS Schlüssels. + des /STATUS Schlüssels. Dieser wird bei der Anzeige in einem + Warnungsfeld angezeigt. </para> <para> Siehe auch <function>fdf_get_status</function>. Index: phpdoc-de/reference/fdf/functions/fdf-set-submit-form-action.xml diff -u phpdoc-de/reference/fdf/functions/fdf-set-submit-form-action.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-set-submit-form-action.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-set-submit-form-action.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-set-submit-form-action.xml Mon Dec 16 09:50:45 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.5 --> <!-- last change to 'fdf-set-submit-form-action' in en/ tree in rev 1.6 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.6 --> <refentry id="function.fdf-set-submit-form-action"> <refnamediv> @@ -15,7 +15,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_set_submit_form_action</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>fieldname</parameter></methodparam> <methodparam><type>int</type><parameter>trigger</parameter></methodparam> <methodparam><type>string</type><parameter>script</parameter></methodparam> Index: phpdoc-de/reference/fdf/functions/fdf-set-value.xml diff -u phpdoc-de/reference/fdf/functions/fdf-set-value.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-set-value.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-set-value.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-set-value.xml Mon Dec 16 09:50:45 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-set-value' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-set-value"> <refnamediv> @@ -13,20 +13,34 @@ <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_set_value</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>fieldname</parameter></methodparam> <methodparam><type>string</type><parameter>value</parameter></methodparam> - <methodparam><type>int</type><parameter>isName</parameter></methodparam> + <methodparam choice='opt'><type>int</type><parameter>isName</parameter></methodparam> </methodsynopsis> <para> Die Funktion <function>fdf_set_value</function> setzt den Wert - eines Feldes. Der letzte Parameter bestimmt, ob der Wert des - Feldes in einen PDF Namen (<parameter>isName</parameter> = 1) - konvertiert oder als PDF String (<parameter>isName</parameter> = - 0) behandelt wird. + <parameter>value</parameter> eines Feldes <parameter>fieldname</parameter>. + Der Parameter <parameter>value</parameter> wird als String, falls der übergebene + Wert ein Array ist, als Array gespeichert. </para> + <note> + <para> + In älteren Versionen des FDF-Toolkits legte der letzte Parameter fest, + ob der Wert in einen PDF-Namen (<parameter>isName</parameter> = 1) konvertiert + oder als PDf-String (<parameter>isName</parameter> = 0) behandelt werden sollte. + Dieser Parameter wird in Version 5.0 des Toolkits nicht mehr benutzt. + Aus Kompatibilitätsgründen wird der Parameter ab PHP-Version 4.3 + als optional unterstützt aber ignoriert. + </para> + <para> + die Unterstützung für Arrays als Parameter <parameter>value</parameter> wurde + ab PHP-Version 4.3 hinzugefügt. + </para> + </note> <para> - Siehe auch <function>fdf_get_value</function>. + Siehe auch <function>fdf_get_value</function> und + <function>fdf_remove_item</function>. </para> </refsect1> </refentry>
Index: phpdoc-de/reference/fdf/reference.xml diff -u phpdoc-de/reference/fdf/reference.xml:1.3 phpdoc-de/reference/fdf/reference.xml:1.4 --- phpdoc-de/reference/fdf/reference.xml:1.3 Fri May 31 13:24:35 2002 +++ phpdoc-de/reference/fdf/reference.xml Mon Dec 16 09:50:36 2002 @@ -1,26 +1,20 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.7 Maintainer: sts Status: ready --> <reference id="ref.fdf"> <title>Forms Data Format Funktionen</title> <titleabbrev>FDF</titleabbrev> <partintro> + + <section id="fdf.intro"> + &reftitle.intro; <simpara> Forms Data Format (FDF) ist ein Format zur Verarbeitung von Formularen innerhalb von PDF Dokumenten. Weiterführende Informationen zu FDF und dessen Verwendung sind unter <ulink url="&spec.pdf.fdf;">&spec.pdf.fdf;</ulink> zu finden. </simpara> - <note> - <simpara> - Bei Problemen mit der Konfiguration der FdfTk-Unterstützung - sollte man überprüfen, ob die Datei FdfTk.h sowie die Bibliothek - libFdfTk.so im richtigen Verzeichnis zu finden sind. Die - korrekten Verzeichnisse sind fdftk-dir/include und - fdftk-dir/lib. Das ausschließliche Entpacken der Distribution - führt nicht zu dem gewünschten Ergebnis. - </simpara> - </note> <simpara> Der Ansatz den FDF verfolgt, ist vergleichbar mit dem üblicher HTML Formulare. Die wesentlichen Unterschiede liegen in der @@ -28,7 +22,7 @@ eigentliche Form Data Format), sowie in dem Format des Dokuments welches das Formular enthält(PDF). Die Verarbeitung der FDF Daten ist eine der Möglichkeiten, die die FDF Funktionen bereitstellen. - Darüberhinaus kann man beispielsweise innerhalb eines vorhandenen + Darüber hinaus kann man beispielsweise innerhalb eines vorhandenen PDF Formulars die Input Felder dynamisch mit Daten füllen, ohne das Formular selbst zu verändern. Hierzu erzeugt man das FDF Dokument (<function>fdf_create</function>), setzt die Werte der @@ -38,11 +32,12 @@ Dokument, mit dem passenden MimeType <literal>application/vnd.fdf</literal> versehen, ausgegeben hat, erkennt das Acrobat Reader PlugIn des Browsers den MimeType und - füllt das Zielformular mit den Daten des FDF Dokuments. + füllt das Zielformular mit den Daten des FDF Dokuments. </simpara> + <simpara> Betrachtet man ein FDF Dokument mit einem Text Editor, findet sich - dort ein Katalog Objekt <literal>FDF</literal>. Dieses Objekt kann + dort ein Katalog-Objekt <literal>FDF</literal>. Dieses Objekt kann mehrere Einträge der Art <literal>Fields</literal>, <literal>F</literal>, <literal>Status</literal> etc.. enthalten. Die gebräuchlichsten Einträge sind @@ -54,16 +49,57 @@ <function>fdf_set_file</function> und <function>fdf_set_status</function> vorgenommen. Felder werden u.a. mit <function>fdf_set_value</function>, - <function>fdf_set_opt</function> modifiziert. - </simpara> - <simpara> - Das Beispiel zeigt die Auswertung der Formular Daten. - </simpara> - <simpara> + <function>fdf_set_opt</function> modifiziert. </simpara> - <example> - <title>Auswertung eines FDF Dokuments</title> - <programlisting role="php"> + </section> + + <section id="fdf.requirements"> + &reftitle.required; + <para> + Benötigt wird das FDF-Toolkit-SDK, welches unter + <ulink url="&spec.pdf.fdf;">&spec.pdf.fdf;</ulink> + heruntergeladen werden kann. + Ab PHP-Version 4.3 ist mindestens die Version 5.0 + des FDF-SDKs erforderlich. + Die FDF-Toolkit Bibliothek steht ausschließlich vorkompiliert + zur Verfügung. Von Adobe unterstütze Plattformen sind Win32, Linux, + Solaris und AIX. + </para> + </section> + + &reference.fdf.configure; + + <section id="fdf.configuration"> + &reftitle.runtime; + &no.config; + </section> + + <section id="fdf.resources"> + &reftitle.resources; + <section id="fdf.resources.fdf"> + <title>fdf</title> + <para> + Die meisten FDF-Funktionen benötigen an erster Stelle einen + <parameter>fdf</parameter> Ressource-Parameter. + Der Parameter <parameter>fdf</parameter> ist ein Zeiger auf + eine geöffnete FDF-Datei. + <parameter>fdf</parameter> Ressource-Parameter werden von den + Funktionen <function>fdf_create</function>, + <function>fdf_open</function> und <function>fdf_open_string</function> + zurückgegeben. + </para> + </section> + </section> + + &reference.fdf.constants; + + <section id="fdf.examples"> + &reftitle.examples; + <para> + Das Beispiel zeigt die Auswertung der Formular Daten. + <example> + <title>Auswertung eines FDF_Dokuments</title> + <programlisting role="php"> <![CDATA[ <?php // Speichern der FDF Daten in eine temporäre Datei @@ -102,10 +138,12 @@ fdf_close($fdf); ?> ]]> - </programlisting> - </example> - </partintro> - + </programlisting> + </example> + </para> + </section> + </partintro> + &reference.fdf.functions; </reference> @@ -125,5 +163,10 @@ 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 +--> + + Index: phpdoc-de/reference/fdf/functions/fdf-add-template.xml diff -u phpdoc-de/reference/fdf/functions/fdf-add-template.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-add-template.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-add-template.xml:1.3 Sun Jun 9 06:55:36 2002 +++ phpdoc-de/reference/fdf/functions/fdf-add-template.xml Mon Dec 16 09:50:43 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.17 --> <!-- last change to 'fdf-add-template' in en/ tree in rev 1.12 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.2 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.12 --> <refentry id='function.fdf-add-template'> <refnamediv> Index: phpdoc-de/reference/fdf/functions/fdf-close.xml diff -u phpdoc-de/reference/fdf/functions/fdf-close.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-close.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-close.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-close.xml Mon Dec 16 09:50:43 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-close' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-close"> <refnamediv> @@ -13,7 +13,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_close</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> </methodsynopsis> <para> Die Funktion <function>fdf_close</function> schließt das FDF Index: phpdoc-de/reference/fdf/functions/fdf-create.xml diff -u phpdoc-de/reference/fdf/functions/fdf-create.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-create.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-create.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-create.xml Mon Dec 16 09:50:43 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-create' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-create"> <refnamediv> @@ -12,7 +12,7 @@ <refsect1> <title>Beschreibung</title> <methodsynopsis> - <type>int</type><methodname>fdf_create</methodname> + <type>resource</type><methodname>fdf_create</methodname> <void/> </methodsynopsis> <para> Index: phpdoc-de/reference/fdf/functions/fdf-get-file.xml diff -u phpdoc-de/reference/fdf/functions/fdf-get-file.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-get-file.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-get-file.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-get-file.xml Mon Dec 16 09:50:43 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-get-file' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-get-file"> <refnamediv> @@ -13,7 +13,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>fdf_get_file</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> </methodsynopsis> <para> Die Funktion <function>fdf_set_file</function> gibt den Wert Index: phpdoc-de/reference/fdf/functions/fdf-get-status.xml diff -u phpdoc-de/reference/fdf/functions/fdf-get-status.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-get-status.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-get-status.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-get-status.xml Mon Dec 16 09:50:44 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-get-status' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-get-status"> <refnamediv> @@ -15,7 +15,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>fdf_get_status</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> </methodsynopsis> <para> Die Funktion <function>fdf_get_status</function> gibt den Wert Index: phpdoc-de/reference/fdf/functions/fdf-get-value.xml diff -u phpdoc-de/reference/fdf/functions/fdf-get-value.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-get-value.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-get-value.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-get-value.xml Mon Dec 16 09:50:44 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-get-value' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-get-value"> <refnamediv> @@ -13,13 +13,29 @@ <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>fdf_get_value</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>fieldname</parameter></methodparam> + <methodparam choice='opt'><type>int</type><parameter>which</parameter></methodparam> </methodsynopsis> <para> Die Funktion <function>fdf_get_value</function> gibt den Wert - eines Feldes zurück. + für den Parameter <parameter>fieldname</parameter> zurück. </para> + + <para> + Elemente eines Arrays können abgefragt werden, indem der optionale + Parameter <parameter>which</parameter> übergeben wird. Die Elemente des + abzufragenden Arrays starten bei Null. + Bei Nicht-Array-Feldern wird der Parameter <parameter>which</parameter> + ignoriert. + </para> + <note> + <para> + Der optionale Parameter <parameter>which</parameter> und die Möglichkeit + Arrays abzufragen wurden ab PHP-Version 4.3 hinzugefügt. + </para> + </note> + <para> Siehe auch <function>fdf_set_value</function>. </para> Index: phpdoc-de/reference/fdf/functions/fdf-next-field-name.xml diff -u phpdoc-de/reference/fdf/functions/fdf-next-field-name.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-next-field-name.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-next-field-name.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-next-field-name.xml Mon Dec 16 09:50:44 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-next-field-name' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-next-field-name"> <refnamediv> @@ -13,7 +13,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>fdf_next_field_name</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>fieldname</parameter></methodparam> </methodsynopsis> <para> @@ -22,6 +22,25 @@ Namen des ersten Feldes zurück, wenn der Parameter &null; ist. </para> + + <para> + <example> + <title>Detecting all fieldnames in a FDF</title> + <programlisting> +<![CDATA[ +<?php + $fdf = fdf_open($HTTP_FDF_DATA); + for($field = fdf_next_field_name($fdf); + $field != ""; + $field = fdf_next_field_name($fdf, $field)) { + echo "field: $field\n"; + } +?> +]]> + </programlisting> + </example> + </para> + <para> Siehe auch <function>fdf_set_field</function>, <function>fdf_get_field</function>. Index: phpdoc-de/reference/fdf/functions/fdf-open.xml diff -u phpdoc-de/reference/fdf/functions/fdf-open.xml:1.4 phpdoc-de/reference/fdf/functions/fdf-open.xml:1.5 --- phpdoc-de/reference/fdf/functions/fdf-open.xml:1.4 Wed Oct 23 07:07:22 2002 +++ phpdoc-de/reference/fdf/functions/fdf-open.xml Mon Dec 16 09:50:44 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-open' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-open"> <refnamediv> @@ -12,23 +12,29 @@ <refsect1> <title>Beschreibung</title> <methodsynopsis> - <type>int</type><methodname>fdf_open</methodname> + <type>resource</type><methodname>fdf_open</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> + <para> - Die Funktion <function>fdf_open</function> öffnet eine Datei mit - Formulardaten. Diese Datei muss die von einem PDF Formular - zurückgegebenen Formulardaten enthalten. Momentan muss diese - Datei 'manuell' erzeugt werden. Mit Hilfe von - <function>fopen</function> schreibt man den Inhalt von - HTTP_FDF_DATA mit <function>fwrite</function> in die Datei. Eine - automatische Vorbelegung von Variablen mit den Daten der - Eingabefelder, wie sie bei HTML Formularen möglich ist, existiert - in diesem Fall nicht. + Die Funktion <function>fdf_open</function> öffnet eine Datei + mit Formulardaten. Diese Datei muss entweder die von einem PDF Formular + zurückgegebenen Formulardaten oder Formulardaten, die mit + <function>fdf_create</function> und + <function>fdf_save</function> erzeugt wurden, enthalten. </para> <para> + Das Ergebnis eines per POST übergebenen PDF-Formulars kann verarbeitet werden, + indem die Daten aus <varname>$HTTP_FDF_DATA</varname> in eine Datei + geschrieben und mit Hilfe von <function>fdf_open</function> zugänglich + gemacht werden. + Ab PHP-Version 4.3 steht darüber hinaus die Funktion <function>fdf_open_string</function> + zur Verfügung, die die temporäre Dateierzeugung und -löschung übernimmt. + </para> + + <para> <example> - <title>Zugang zu den Fornmulardaten</title> + <title>Zugang zu den Formulardaten</title> <programlisting> <![CDATA[ <?php @@ -47,7 +53,11 @@ </example> </para> <para> - Siehe auch <function>fdf_close</function>. + Siehe auch + <function>fdf_open_string</function>, + <function>fdf_close</function>, + <function>fdf_create</function> und + <function>fdf_save</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/fdf/functions/fdf-save.xml diff -u phpdoc-de/reference/fdf/functions/fdf-save.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-save.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-save.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-save.xml Mon Dec 16 09:50:44 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-save' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-save"> <refnamediv> @@ -12,23 +12,25 @@ <refsect1> <title>Beschreibung</title> <methodsynopsis> - <type>int</type><methodname>fdf_save</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <type>bool</type><methodname>fdf_save</methodname> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> + <para> - Die Funktion <function>fdf_save</function> speichert ein FDF - Dokument. Das FDF Toolkit stellt eine Möglichkeit zur Verfügung, - das Dokument an der Standardausgabe auszugeben, wenn der - Parameter <parameter>filename</parameter> '.' ist. Dies - funktioniert allerdings nicht, wenn PHP als Apache Module - verwendet wird. In diesem Fall sollte man die Ausgabe in eine - Datei schreiben und die Funktion <function>fpassthru</function> - verwenden, um den Inhalt anzuzeigen. + Die Funktion <function>fdf_save</function> function speichert ein FDF + Dokument. + Das erzeugte Dokument wird in der Datei <parameter>filename</parameter> + gespeichert. + Ohne den Parameter <parameter>filename</parameter> gibt + <function>fdf_save</function> das Dokument an der Standardausgabe aus. </para> <para> - Siehe auch <function>fdf_close</function> and example for - <function>fdf_create</function>. - </para> + Siehe auch <function>fdf_save_string</function>, + <function>fdf_create</function> und + <function>fdf_close</function>. + </para> + </refsect1> </refentry> Index: phpdoc-de/reference/fdf/functions/fdf-set-ap.xml diff -u phpdoc-de/reference/fdf/functions/fdf-set-ap.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-set-ap.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-set-ap.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-set-ap.xml Mon Dec 16 09:50:44 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-set-ap' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-set-ap"> <refnamediv> @@ -13,7 +13,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_set_ap</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>field_name</parameter></methodparam> <methodparam><type>int</type><parameter>face</parameter></methodparam> <methodparam><type>string</type><parameter>filename</parameter></methodparam> @@ -21,9 +21,10 @@ </methodsynopsis> <para> Die Funktion <function>fdf_set_ap</function> legt das Aussehen - eines Feldes (d.h den Wert des /AP Schlüssels) fest. Mögliche - Werte von <parameter>face</parameter> sind 1=FDFNormalAP, - 2=FDFRolloverAP, 3=FDFDownAP. + eines Feldes (d.h. den Wert des /AP Schlüssels) fest. Mögliche + Werte von <parameter>face</parameter> sind + <constant>FDFNormalAP</constant>, <constant>FDFRolloverAP</constant> + und <constant>FDFDownAP</constant>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/fdf/functions/fdf-set-encoding.xml diff -u phpdoc-de/reference/fdf/functions/fdf-set-encoding.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-set-encoding.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-set-encoding.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-set-encoding.xml Mon Dec 16 09:50:44 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.8 --> <!-- last change to 'fdf-set-encoding' in en/ tree in rev 1.24 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.24 --> <refentry id="function.fdf-set-encoding"> <refnamediv> @@ -15,7 +15,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_set_encoding</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>encoding</parameter></methodparam> </methodsynopsis> <para> @@ -25,6 +25,8 @@ "<literal>Shift_JIS</literal>", "<literal>UHC</literal>", "<literal>GBK</literal>","<literal>BigFive</literal>" gültige Werte für den Parameter <parameter>encoding</parameter>. + Ein leerer String setzt die Kodierung auf den voreingestellten Wert + PDFDocEncoding/Unicode. </para> <para> Die Funktion <function>fdf_set_encoding</function> ist ab Index: phpdoc-de/reference/fdf/functions/fdf-set-file.xml diff -u phpdoc-de/reference/fdf/functions/fdf-set-file.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-set-file.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-set-file.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-set-file.xml Mon Dec 16 09:50:44 2002 @@ -1,35 +1,65 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-set-file' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-set-file"> <refnamediv> <refname>fdf_set_file</refname> - <refpurpose>Setzt den Wert des /F Schlüssels</refpurpose> + <refpurpose>Definiert ein PDF-Dokument, das FDF-Daten anzeigen soll</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_set_file</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>target_frame</parameter></methodparam> </methodsynopsis> <para> - Die Funktion <function>fdf_set_file</function> setzt den Wert des - /F Schlüssels. Der /F Schlüssel ist eine Referenz zu einem PDF - Formular welches mit Daten gefüllt werden soll. In einer Web - Umgebung ist diese Referenz ein URL - (z.B. http:/testfdf/resultlabel.pdf). + Die Funktion <function>fdf_set_file</function> wählt ein PDF-Dokument + aus, in dem FDF-Formulardaten angezeigt werden sollen. + Der Parameter <parameter>url</parameter> muss als absolute URL angegeben + werden. </para> <para> - Siehe auch <function>fdf_get_file</function> und das Beispiel zu - <function>fdf_create</function>. + Der Rahmen in den das Dokument angezeigt werden soll, kann mit dem + optionalen Parameter <parameter>target_frame</parameter> oder der + Funktion <function>fdf_set_target_frame</function> festgelegt werden. </para> + <example> + <title>FDF-Daten in einem anderen Dokument anzeigen</title> + <programlisting> +<![CDATA[ +<?php + /* set content type for Adobe FDF */ + fdf_header(); + + /* start new fdf */ + $fdf = fdf_create(); + + /* set field "foo" to value "bar" */ + $fdf_set_value($fdf, "foo", "bar"); + + /* tell client to display FDF data using "fdf_form.pdf" */ + fdf_set_file($fdf, "http://www.example.com/fdf_form.pdf"); + + /* output fdf */ + fdf_save(); + + /* clean up */ + fdf_close(); +?> +]]> + </programlisting> + </example> + <para> + Siehe auch <function>fdf_get_file</function> und + <function>fdf_set_target_frame</function>. + </para> </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml Index: phpdoc-de/reference/fdf/functions/fdf-set-flags.xml diff -u phpdoc-de/reference/fdf/functions/fdf-set-flags.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-set-flags.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-set-flags.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-set-flags.xml Mon Dec 16 09:50:45 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.5 --> <!-- last change to 'fdf-set-flags' in en/ tree in rev 1.6 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.6 --> <refentry id="function.fdf-set-flags"> <refnamediv> @@ -13,7 +13,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_set_flags</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>fieldname</parameter></methodparam> <methodparam><type>int</type><parameter>whichFlags</parameter></methodparam> <methodparam><type>int</type><parameter>newFlags</parameter></methodparam> Index: phpdoc-de/reference/fdf/functions/fdf-set-javascript-action.xml diff -u phpdoc-de/reference/fdf/functions/fdf-set-javascript-action.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-set-javascript-action.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-set-javascript-action.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-set-javascript-action.xml Mon Dec 16 09:50:45 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.5 --> <!-- last change to 'fdf-set-javascript-action' in en/ tree in rev 1.6 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.6 --> <refentry id="function.fdf-set-javascript-action"> <refnamediv> @@ -15,7 +15,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_set_javascript_action</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>fieldname</parameter></methodparam> <methodparam><type>int</type><parameter>trigger</parameter></methodparam> <methodparam><type>string</type><parameter>script</parameter></methodparam> Index: phpdoc-de/reference/fdf/functions/fdf-set-opt.xml diff -u phpdoc-de/reference/fdf/functions/fdf-set-opt.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-set-opt.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-set-opt.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-set-opt.xml Mon Dec 16 09:50:45 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.5 --> <!-- last change to 'fdf-set-opt' in en/ tree in rev 1.6 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.6 --> <refentry id="function.fdf-set-opt"> <refnamediv> @@ -13,7 +13,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_set_opt</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>fieldname</parameter></methodparam> <methodparam><type>int</type><parameter>element</parameter></methodparam> <methodparam><type>string</type><parameter>str1</parameter></methodparam> Index: phpdoc-de/reference/fdf/functions/fdf-set-status.xml diff -u phpdoc-de/reference/fdf/functions/fdf-set-status.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-set-status.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-set-status.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-set-status.xml Mon Dec 16 09:50:45 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-set-status' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-set-status"> <refnamediv> @@ -13,12 +13,13 @@ <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_set_status</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>status</parameter></methodparam> </methodsynopsis> <para> Die Funktion <function>fdf_set_status</function> setzt den Wert - des /STATUS Schlüssels. + des /STATUS Schlüssels. Dieser wird bei der Anzeige in einem + Warnungsfeld angezeigt. </para> <para> Siehe auch <function>fdf_get_status</function>. Index: phpdoc-de/reference/fdf/functions/fdf-set-submit-form-action.xml diff -u phpdoc-de/reference/fdf/functions/fdf-set-submit-form-action.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-set-submit-form-action.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-set-submit-form-action.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-set-submit-form-action.xml Mon Dec 16 09:50:45 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.5 --> <!-- last change to 'fdf-set-submit-form-action' in en/ tree in rev 1.6 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.6 --> <refentry id="function.fdf-set-submit-form-action"> <refnamediv> @@ -15,7 +15,7 @@ <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_set_submit_form_action</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>fieldname</parameter></methodparam> <methodparam><type>int</type><parameter>trigger</parameter></methodparam> <methodparam><type>string</type><parameter>script</parameter></methodparam> Index: phpdoc-de/reference/fdf/functions/fdf-set-value.xml diff -u phpdoc-de/reference/fdf/functions/fdf-set-value.xml:1.3 phpdoc-de/reference/fdf/functions/fdf-set-value.xml:1.4 --- phpdoc-de/reference/fdf/functions/fdf-set-value.xml:1.3 Sun Jun 9 06:55:37 2002 +++ phpdoc-de/reference/fdf/functions/fdf-set-value.xml Mon Dec 16 09:50:45 2002 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/fdf.xml, last change in rev 1.2 --> <!-- last change to 'fdf-set-value' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: stefan_saasen Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: sts Status: ready --> <!-- OLD-Revision: 1.29/EN.1.2 --> <refentry id="function.fdf-set-value"> <refnamediv> @@ -13,20 +13,34 @@ <title>Beschreibung</title> <methodsynopsis> <type>bool</type><methodname>fdf_set_value</methodname> - <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam> + <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam> <methodparam><type>string</type><parameter>fieldname</parameter></methodparam> <methodparam><type>string</type><parameter>value</parameter></methodparam> - <methodparam><type>int</type><parameter>isName</parameter></methodparam> + <methodparam choice='opt'><type>int</type><parameter>isName</parameter></methodparam> </methodsynopsis> <para> Die Funktion <function>fdf_set_value</function> setzt den Wert - eines Feldes. Der letzte Parameter bestimmt, ob der Wert des - Feldes in einen PDF Namen (<parameter>isName</parameter> = 1) - konvertiert oder als PDF String (<parameter>isName</parameter> = - 0) behandelt wird. + <parameter>value</parameter> eines Feldes <parameter>fieldname</parameter>. + Der Parameter <parameter>value</parameter> wird als String, falls der übergebene + Wert ein Array ist, als Array gespeichert. </para> + <note> + <para> + In älteren Versionen des FDF-Toolkits legte der letzte Parameter fest, + ob der Wert in einen PDF-Namen (<parameter>isName</parameter> = 1) konvertiert + oder als PDf-String (<parameter>isName</parameter> = 0) behandelt werden sollte. + Dieser Parameter wird in Version 5.0 des Toolkits nicht mehr benutzt. + Aus Kompatibilitätsgründen wird der Parameter ab PHP-Version 4.3 + als optional unterstützt aber ignoriert. + </para> + <para> + die Unterstützung für Arrays als Parameter <parameter>value</parameter> wurde + ab PHP-Version 4.3 hinzugefügt. + </para> + </note> <para> - Siehe auch <function>fdf_get_value</function>. + Siehe auch <function>fdf_get_value</function> und + <function>fdf_remove_item</function>. </para> </refsect1> </refentry>