cvs: phpdoc /de/functions fdf.xml
| From: | Egon Schmid | Date: | Sun, 16 Sep 2001 23:22:41 +0000 |
| Subject: | cvs: phpdoc /de/functions fdf.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969337595@lists.php.net to get a copy of this message | ||
eschmid Sun Sep 16 19:22:41 2001 EDT
Modified files:
/phpdoc/de/functions fdf.xml
Log:
Whitespace fix.
Index: phpdoc/de/functions/fdf.xml diff -u phpdoc/de/functions/fdf.xml:1.11 phpdoc/de/functions/fdf.xml:1.12 --- phpdoc/de/functions/fdf.xml:1.11 Sun Sep 16 15:34:10 2001 +++ phpdoc/de/functions/fdf.xml Sun Sep 16 19:22:41 2001 @@ -5,57 +5,65 @@ <titleabbrev>FDF</titleabbrev> <partintro> - <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. + 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> - + <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 Übertragung der Daten nach Absenden des Formulars (dies ist das 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 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 jeweiligen Input Felder (<function>fdf_set_value</function>) und verbindet es - mit dem jeweiligen PDF Formular (<function>fdf_set_file</function>). - Nachdem man das FDF Dokument, mit dem passenden MimeType <literal>application/vnd.fdf</literal> - versehen, ausgegeben hat, erkennt das Acrobat Reader PlugIn des Browsers den MimeType und + Der Ansatz den FDF verfolgt, ist vergleichbar mit dem üblicher + HTML Formulare. Die wesentlichen Unterschiede liegen in der + Übertragung der Daten nach Absenden des Formulars (dies ist das + 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 + 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 + jeweiligen Input Felder (<function>fdf_set_value</function>) und + verbindet es mit dem jeweiligen PDF Formular + (<function>fdf_set_file</function>). Nachdem man das FDF + 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. </simpara> - <simpara> - Betrachtet man ein FDF Dokument mit einem Text Editor, findet sich 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 <literal>Fields</literal>, welches zu einer - Anzahl von Input Feldern verweist, sowie <literal>F</literal> das den Dateinamen des - zugehörigen PDF Dokuments enthält. Diese Einträge finden sich in der FDF Dokumentation - unter /F-Key oder /Status-Key. - Modifikationen dieser Einträge werden mit Hilfe der Funktionen <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. + Betrachtet man ein FDF Dokument mit einem Text Editor, findet sich + 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 + <literal>Fields</literal>, welches zu einer Anzahl von Input + Feldern verweist, sowie <literal>F</literal> das den Dateinamen + des zugehörigen PDF Dokuments enthält. Diese Einträge finden sich + in der FDF Dokumentation unter /F-Key oder /Status-Key. + Modifikationen dieser Einträge werden mit Hilfe der Funktionen + <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></simpara> - <example> - <title>Auswertung eines FDF Dokuments</title> - <programlisting> + <simpara> + </simpara> + <example> + <title>Auswertung eines FDF Dokuments</title> + <programlisting role="php"> <?php // Speichern der FDF Daten in eine temporäre Datei $fdffp = fopen("test.fdf", "w"); @@ -77,22 +85,23 @@ $kommentar = fdf_get_value($fdf, "kommentar"); echo "Das Feld Kommentar hat den Wert '<B>$kommentar</B>'<BR>"; -if(fdf_get_value($fdf, "zeige_verleger") == "On") { - $verleger = fdf_get_value($fdf, "verleger"); - echo "Das Feld Verleger hat den Wert '<B>$verleger</B>'<BR>"; -} else +if (fdf_get_value($fdf, "zeige_verleger") == "On") { + $verleger = fdf_get_value($fdf, "verleger"); + echo "Das Feld Verleger hat den Wert '<B>$verleger</B>'<BR>"; +} else { echo "Verleger soll nicht angezeigt werden.<BR>"; +} -if(fdf_get_value($fdf, "zeige_bearbeiter") == "On") { +if (fdf_get_value($fdf, "zeige_bearbeiter") == "On") { $bearbeiter = fdf_get_value($fdf, "bearbeiter"); echo "Das Feld Bearbeiter hat den Wert '<B>$bearbeiter</B>'<BR>"; -} else +} else { echo "Bearbeiter soll nicht angezeigt werden.<BR>"; +} fdf_close($fdf); ?> - </programlisting> - </example> - + </programlisting> + </example> </partintro> <refentry id="function.fdf-open"> @@ -109,18 +118,20 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>fdf_open</function> öffnet - eine Datei mit Formulardaten. Diese Datei muß 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.</para> - <para> - <example> - <title>Zugang zu den Fornmulardaten</title> - <programlisting> + Die Funktion <function>fdf_open</function> öffnet eine Datei mit + Formulardaten. Diese Datei muß 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. + </para> + <para> + <example> + <title>Zugang zu den Fornmulardaten</title> + <programlisting> <?php // Speichern der FDF Daten in eine temporäre Datei $fdffp = fopen("test.fdf", "w"); @@ -132,12 +143,12 @@ ... fdf_close($fdf); ?> - </programlisting> - </example></para> - + </programlisting> + </example> + </para> <para> - Siehe auch <function>fdf_close</function>.</para> - + Siehe auch <function>fdf_close</function>. + </para> </refsect1> </refentry> @@ -155,11 +166,12 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>fdf_close</function> schließt das FDF Dokument.</para> - + Die Funktion <function>fdf_close</function> schließt das FDF + Dokument. + </para> <para> - Siehe auch <function>fdf_open</function>.</para> - + Siehe auch <function>fdf_open</function>. + </para> </refsect1> </refentry> @@ -177,13 +189,15 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>fdf_create</function> erzeugt ein neues FDF Dokument. - Diese Funktion wird benötigt, wenn man Eingabefelder in einem PDF Dokument - mit Daten belegen möchte.</para> - <para> - <example> - <title>Füllen von Formularwerten in einem PDF Dokument</title> - <programlisting> + Die Funktion <function>fdf_create</function> erzeugt ein neues + FDF Dokument. Diese Funktion wird benötigt, wenn man + Eingabefelder in einem PDF Dokument mit Daten belegen + möchte. + </para> + <para> + <example> + <title>Füllen von Formularwerten in einem PDF Dokument</title> + <programlisting> <?php $outfdf = fdf_create(); fdf_set_value($outfdf, "band", $band, 0); @@ -196,14 +210,14 @@ fpassthru($fp); unlink("outtest.fdf"); ?> - </programlisting> - </example></para> - + </programlisting> + </example> + </para> <para> Siehe auch <function>fdf_close</function>, - <function>fdf_save</function>, - <function>fdf_open</function>.</para> - + <function>fdf_save</function>, + <function>fdf_open</function>. + </para> </refsect1> </refentry> @@ -221,16 +235,19 @@ </funcprototype> </funcsynopsis> <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.</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. + </para> <para> Siehe auch <function>fdf_close</function> and example for - <function>fdf_create</function>.</para> - + <function>fdf_create</function>. + </para> </refsect1> </refentry> @@ -249,12 +266,12 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>fdf_get_value</function> gibt den Wert eines - Feldes zurück.</para> - + Die Funktion <function>fdf_get_value</function> gibt den Wert + eines Feldes zurück. + </para> <para> - Siehe auch <function>fdf_set_value</function>.</para> - + Siehe auch <function>fdf_set_value</function>. + </para> </refsect1> </refentry> @@ -275,14 +292,15 @@ </funcprototype> </funcsynopsis> <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.</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. + </para> <para> - Siehe auch <function>fdf_get_value</function>.</para> - + Siehe auch <function>fdf_get_value</function>. + </para> </refsect1> </refentry> @@ -301,14 +319,15 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>fdf_next_field_name</function> gibt den Namen - des Feldes nach <parameter>fieldname</parameter> oder den Namen des - ersten Feldes zurück, wenn der Parameter &null; ist.</para> - + Die Funktion <function>fdf_next_field_name</function> gibt den + Namen des Feldes nach <parameter>fieldname</parameter> oder den + Namen des ersten Feldes zurück, wenn der Parameter &null; + ist. + </para> <para> Siehe auch <function>fdf_set_field</function>, - <function>fdf_get_field</function>.</para> - + <function>fdf_get_field</function>. + </para> </refsect1> </refentry> @@ -330,11 +349,11 @@ </funcprototype> </funcsynopsis> <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.</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. + </para> </refsect1> </refentry> @@ -354,18 +373,20 @@ </funcsynopsis> <para> Die Funktion <function>fdf_set_status</function> setzt den Wert - des /STATUS Schlüssels.</para> - + des /STATUS Schlüssels. + </para> <para> - Siehe auch <function>fdf_get_status</function>.</para> - + Siehe auch <function>fdf_get_status</function>. + </para> </refsect1> </refentry> <refentry id="function.fdf-get-status"> <refnamediv> <refname>fdf_get_status</refname> - <refpurpose>Gibt den Wert des /STATUS Schlüssels zurück</refpurpose> + <refpurpose> + Gibt den Wert des /STATUS Schlüssels zurück + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -376,12 +397,12 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>fdf_get_status</function> gibt den Wert - des /STATUS Schlüssels zurück.</para> - + Die Funktion <function>fdf_get_status</function> gibt den Wert + des /STATUS Schlüssels zurück. + </para> <para> - Siehe auch <function>fdf_set_status</function>.</para> - + Siehe auch <function>fdf_set_status</function>. + </para> </refsect1> </refentry> @@ -400,14 +421,16 @@ </funcprototype> </funcsynopsis> <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).</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). + </para> <para> - Siehe auch <function>fdf_get_file</function> und das Beispiel zu - <function>fdf_create</function>.</para> - + Siehe auch <function>fdf_get_file</function> und das Beispiel zu + <function>fdf_create</function>. + </para> </refsect1> </refentry> @@ -426,11 +449,11 @@ </funcsynopsis> <para> Die Funktion <function>fdf_set_file</function> gibt den Wert - des /F Schlüssels zurück.</para> - + des /F Schlüssels zurück. + </para> <para> - Siehe auch <function>fdf_set_file</function>.</para> - + Siehe auch <function>fdf_set_file</function>. + </para> </refsect1> </refentry> @@ -451,9 +474,9 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>fdf_set_flags</function> setzt bestimmte Flags - des Feldes <parameter>fieldname</parameter>.</para> - + Die Funktion <function>fdf_set_flags</function> setzt bestimmte + Flags des Feldes <parameter>fieldname</parameter>. + </para> <para> Siehe auch <function>fdf_set_opt</function>. </para> @@ -490,13 +513,17 @@ <refentry id="function.fdf-set-submit-form-action"> <refnamediv> <refname>fdf_set_submit_form_action</refname> - <refpurpose>Setzt die 'Submit Form Action' für ein Feld</refpurpose> + <refpurpose> + Setzt die 'Submit Form Action' für ein Feld + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>fdf_set_submit_form_action</function></funcdef> + <funcdef>bool + <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> @@ -505,8 +532,9 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>fdf_set_submit_form_action</function> setzt die - 'Submit Form Action' für das Feld <parameter>fieldname</parameter>. + Die Funktion <function>fdf_set_submit_form_action</function> + setzt die 'Submit Form Action' für das Feld + <parameter>fieldname</parameter>. </para> <para> Siehe auch <function>fdf_set_javascript_action</function>. @@ -517,13 +545,17 @@ <refentry id="function.fdf-set-javascript-action"> <refnamediv> <refname>fdf_set_javascript_action</refname> - <refpurpose>Weist einem Feld eine Javascript Aktion zu</refpurpose> + <refpurpose> + Weist einem Feld eine Javascript Aktion zu + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>fdf_set_javascript_action</function></funcdef> + <funcdef>bool + <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> @@ -531,8 +563,8 @@ </funcprototype> </funcsynopsis> <para> - <function>fdf_set_javascript_action</function> weist dem Feld <parameter>fieldname</parameter> - eine Javascript Aktion zu. + <function>fdf_set_javascript_action</function> weist dem Feld + <parameter>fieldname</parameter> eine Javascript Aktion zu. </para> <para> Siehe auch <function>fdf_set_submit_form_action</function>. @@ -543,7 +575,9 @@ <refentry id="function.fdf-set-encoding"> <refnamediv> <refname>fdf_set_encoding</refname> - <refpurpose>Legt die Kodierung des FDF Zeichensatzes fest</refpurpose> + <refpurpose> + Legt die Kodierung des FDF Zeichensatzes fest + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -555,15 +589,16 @@ </funcprototype> </funcsynopsis> <para> - <function>fdf_set_encoding</function> legt die Kodierung des - Zeichensatzes innerhalb des FDF Dokuments <parameter>fdf_document</parameter> fest. - In Acrobat 5.0 sind "<literal>Shift_JIS</literal>", "<literal>UHC</literal>", - "<literal>GBK</literal>","<literal>BigFive</literal>" gültige Werte für den Parameter - <parameter>encoding</parameter>. + <function>fdf_set_encoding</function> legt die Kodierung des + Zeichensatzes innerhalb des FDF Dokuments + <parameter>fdf_document</parameter> fest. In Acrobat 5.0 sind + "<literal>Shift_JIS</literal>", "<literal>UHC</literal>", + "<literal>GBK</literal>","<literal>BigFive</literal>" gültige + Werte für den Parameter <parameter>encoding</parameter>. </para> <para> - Die Funktion <function>fdf_set_encoding</function> ist ab PHP-4.0.7 oder - später verfügbar. + Die Funktion <function>fdf_set_encoding</function> ist ab + PHP-4.0.7 oder später verfügbar. </para> </refsect1> </refentry>
Index: phpdoc/de/functions/fdf.xml diff -u phpdoc/de/functions/fdf.xml:1.11 phpdoc/de/functions/fdf.xml:1.12 --- phpdoc/de/functions/fdf.xml:1.11 Sun Sep 16 15:34:10 2001 +++ phpdoc/de/functions/fdf.xml Sun Sep 16 19:22:41 2001 @@ -5,57 +5,65 @@ <titleabbrev>FDF</titleabbrev> <partintro> - <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. + 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> - + <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 Übertragung der Daten nach Absenden des Formulars (dies ist das 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 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 jeweiligen Input Felder (<function>fdf_set_value</function>) und verbindet es - mit dem jeweiligen PDF Formular (<function>fdf_set_file</function>). - Nachdem man das FDF Dokument, mit dem passenden MimeType <literal>application/vnd.fdf</literal> - versehen, ausgegeben hat, erkennt das Acrobat Reader PlugIn des Browsers den MimeType und + Der Ansatz den FDF verfolgt, ist vergleichbar mit dem üblicher + HTML Formulare. Die wesentlichen Unterschiede liegen in der + Übertragung der Daten nach Absenden des Formulars (dies ist das + 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 + 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 + jeweiligen Input Felder (<function>fdf_set_value</function>) und + verbindet es mit dem jeweiligen PDF Formular + (<function>fdf_set_file</function>). Nachdem man das FDF + 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. </simpara> - <simpara> - Betrachtet man ein FDF Dokument mit einem Text Editor, findet sich 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 <literal>Fields</literal>, welches zu einer - Anzahl von Input Feldern verweist, sowie <literal>F</literal> das den Dateinamen des - zugehörigen PDF Dokuments enthält. Diese Einträge finden sich in der FDF Dokumentation - unter /F-Key oder /Status-Key. - Modifikationen dieser Einträge werden mit Hilfe der Funktionen <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. + Betrachtet man ein FDF Dokument mit einem Text Editor, findet sich + 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 + <literal>Fields</literal>, welches zu einer Anzahl von Input + Feldern verweist, sowie <literal>F</literal> das den Dateinamen + des zugehörigen PDF Dokuments enthält. Diese Einträge finden sich + in der FDF Dokumentation unter /F-Key oder /Status-Key. + Modifikationen dieser Einträge werden mit Hilfe der Funktionen + <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></simpara> - <example> - <title>Auswertung eines FDF Dokuments</title> - <programlisting> + <simpara> + </simpara> + <example> + <title>Auswertung eines FDF Dokuments</title> + <programlisting role="php"> <?php // Speichern der FDF Daten in eine temporäre Datei $fdffp = fopen("test.fdf", "w"); @@ -77,22 +85,23 @@ $kommentar = fdf_get_value($fdf, "kommentar"); echo "Das Feld Kommentar hat den Wert '<B>$kommentar</B>'<BR>"; -if(fdf_get_value($fdf, "zeige_verleger") == "On") { - $verleger = fdf_get_value($fdf, "verleger"); - echo "Das Feld Verleger hat den Wert '<B>$verleger</B>'<BR>"; -} else +if (fdf_get_value($fdf, "zeige_verleger") == "On") { + $verleger = fdf_get_value($fdf, "verleger"); + echo "Das Feld Verleger hat den Wert '<B>$verleger</B>'<BR>"; +} else { echo "Verleger soll nicht angezeigt werden.<BR>"; +} -if(fdf_get_value($fdf, "zeige_bearbeiter") == "On") { +if (fdf_get_value($fdf, "zeige_bearbeiter") == "On") { $bearbeiter = fdf_get_value($fdf, "bearbeiter"); echo "Das Feld Bearbeiter hat den Wert '<B>$bearbeiter</B>'<BR>"; -} else +} else { echo "Bearbeiter soll nicht angezeigt werden.<BR>"; +} fdf_close($fdf); ?> - </programlisting> - </example> - + </programlisting> + </example> </partintro> <refentry id="function.fdf-open"> @@ -109,18 +118,20 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>fdf_open</function> öffnet - eine Datei mit Formulardaten. Diese Datei muß 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.</para> - <para> - <example> - <title>Zugang zu den Fornmulardaten</title> - <programlisting> + Die Funktion <function>fdf_open</function> öffnet eine Datei mit + Formulardaten. Diese Datei muß 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. + </para> + <para> + <example> + <title>Zugang zu den Fornmulardaten</title> + <programlisting> <?php // Speichern der FDF Daten in eine temporäre Datei $fdffp = fopen("test.fdf", "w"); @@ -132,12 +143,12 @@ ... fdf_close($fdf); ?> - </programlisting> - </example></para> - + </programlisting> + </example> + </para> <para> - Siehe auch <function>fdf_close</function>.</para> - + Siehe auch <function>fdf_close</function>. + </para> </refsect1> </refentry> @@ -155,11 +166,12 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>fdf_close</function> schließt das FDF Dokument.</para> - + Die Funktion <function>fdf_close</function> schließt das FDF + Dokument. + </para> <para> - Siehe auch <function>fdf_open</function>.</para> - + Siehe auch <function>fdf_open</function>. + </para> </refsect1> </refentry> @@ -177,13 +189,15 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>fdf_create</function> erzeugt ein neues FDF Dokument. - Diese Funktion wird benötigt, wenn man Eingabefelder in einem PDF Dokument - mit Daten belegen möchte.</para> - <para> - <example> - <title>Füllen von Formularwerten in einem PDF Dokument</title> - <programlisting> + Die Funktion <function>fdf_create</function> erzeugt ein neues + FDF Dokument. Diese Funktion wird benötigt, wenn man + Eingabefelder in einem PDF Dokument mit Daten belegen + möchte. + </para> + <para> + <example> + <title>Füllen von Formularwerten in einem PDF Dokument</title> + <programlisting> <?php $outfdf = fdf_create(); fdf_set_value($outfdf, "band", $band, 0); @@ -196,14 +210,14 @@ fpassthru($fp); unlink("outtest.fdf"); ?> - </programlisting> - </example></para> - + </programlisting> + </example> + </para> <para> Siehe auch <function>fdf_close</function>, - <function>fdf_save</function>, - <function>fdf_open</function>.</para> - + <function>fdf_save</function>, + <function>fdf_open</function>. + </para> </refsect1> </refentry> @@ -221,16 +235,19 @@ </funcprototype> </funcsynopsis> <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.</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. + </para> <para> Siehe auch <function>fdf_close</function> and example for - <function>fdf_create</function>.</para> - + <function>fdf_create</function>. + </para> </refsect1> </refentry> @@ -249,12 +266,12 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>fdf_get_value</function> gibt den Wert eines - Feldes zurück.</para> - + Die Funktion <function>fdf_get_value</function> gibt den Wert + eines Feldes zurück. + </para> <para> - Siehe auch <function>fdf_set_value</function>.</para> - + Siehe auch <function>fdf_set_value</function>. + </para> </refsect1> </refentry> @@ -275,14 +292,15 @@ </funcprototype> </funcsynopsis> <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.</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. + </para> <para> - Siehe auch <function>fdf_get_value</function>.</para> - + Siehe auch <function>fdf_get_value</function>. + </para> </refsect1> </refentry> @@ -301,14 +319,15 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>fdf_next_field_name</function> gibt den Namen - des Feldes nach <parameter>fieldname</parameter> oder den Namen des - ersten Feldes zurück, wenn der Parameter &null; ist.</para> - + Die Funktion <function>fdf_next_field_name</function> gibt den + Namen des Feldes nach <parameter>fieldname</parameter> oder den + Namen des ersten Feldes zurück, wenn der Parameter &null; + ist. + </para> <para> Siehe auch <function>fdf_set_field</function>, - <function>fdf_get_field</function>.</para> - + <function>fdf_get_field</function>. + </para> </refsect1> </refentry> @@ -330,11 +349,11 @@ </funcprototype> </funcsynopsis> <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.</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. + </para> </refsect1> </refentry> @@ -354,18 +373,20 @@ </funcsynopsis> <para> Die Funktion <function>fdf_set_status</function> setzt den Wert - des /STATUS Schlüssels.</para> - + des /STATUS Schlüssels. + </para> <para> - Siehe auch <function>fdf_get_status</function>.</para> - + Siehe auch <function>fdf_get_status</function>. + </para> </refsect1> </refentry> <refentry id="function.fdf-get-status"> <refnamediv> <refname>fdf_get_status</refname> - <refpurpose>Gibt den Wert des /STATUS Schlüssels zurück</refpurpose> + <refpurpose> + Gibt den Wert des /STATUS Schlüssels zurück + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -376,12 +397,12 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>fdf_get_status</function> gibt den Wert - des /STATUS Schlüssels zurück.</para> - + Die Funktion <function>fdf_get_status</function> gibt den Wert + des /STATUS Schlüssels zurück. + </para> <para> - Siehe auch <function>fdf_set_status</function>.</para> - + Siehe auch <function>fdf_set_status</function>. + </para> </refsect1> </refentry> @@ -400,14 +421,16 @@ </funcprototype> </funcsynopsis> <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).</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). + </para> <para> - Siehe auch <function>fdf_get_file</function> und das Beispiel zu - <function>fdf_create</function>.</para> - + Siehe auch <function>fdf_get_file</function> und das Beispiel zu + <function>fdf_create</function>. + </para> </refsect1> </refentry> @@ -426,11 +449,11 @@ </funcsynopsis> <para> Die Funktion <function>fdf_set_file</function> gibt den Wert - des /F Schlüssels zurück.</para> - + des /F Schlüssels zurück. + </para> <para> - Siehe auch <function>fdf_set_file</function>.</para> - + Siehe auch <function>fdf_set_file</function>. + </para> </refsect1> </refentry> @@ -451,9 +474,9 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>fdf_set_flags</function> setzt bestimmte Flags - des Feldes <parameter>fieldname</parameter>.</para> - + Die Funktion <function>fdf_set_flags</function> setzt bestimmte + Flags des Feldes <parameter>fieldname</parameter>. + </para> <para> Siehe auch <function>fdf_set_opt</function>. </para> @@ -490,13 +513,17 @@ <refentry id="function.fdf-set-submit-form-action"> <refnamediv> <refname>fdf_set_submit_form_action</refname> - <refpurpose>Setzt die 'Submit Form Action' für ein Feld</refpurpose> + <refpurpose> + Setzt die 'Submit Form Action' für ein Feld + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>fdf_set_submit_form_action</function></funcdef> + <funcdef>bool + <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> @@ -505,8 +532,9 @@ </funcprototype> </funcsynopsis> <para> - Die Funktion <function>fdf_set_submit_form_action</function> setzt die - 'Submit Form Action' für das Feld <parameter>fieldname</parameter>. + Die Funktion <function>fdf_set_submit_form_action</function> + setzt die 'Submit Form Action' für das Feld + <parameter>fieldname</parameter>. </para> <para> Siehe auch <function>fdf_set_javascript_action</function>. @@ -517,13 +545,17 @@ <refentry id="function.fdf-set-javascript-action"> <refnamediv> <refname>fdf_set_javascript_action</refname> - <refpurpose>Weist einem Feld eine Javascript Aktion zu</refpurpose> + <refpurpose> + Weist einem Feld eine Javascript Aktion zu + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>fdf_set_javascript_action</function></funcdef> + <funcdef>bool + <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> @@ -531,8 +563,8 @@ </funcprototype> </funcsynopsis> <para> - <function>fdf_set_javascript_action</function> weist dem Feld <parameter>fieldname</parameter> - eine Javascript Aktion zu. + <function>fdf_set_javascript_action</function> weist dem Feld + <parameter>fieldname</parameter> eine Javascript Aktion zu. </para> <para> Siehe auch <function>fdf_set_submit_form_action</function>. @@ -543,7 +575,9 @@ <refentry id="function.fdf-set-encoding"> <refnamediv> <refname>fdf_set_encoding</refname> - <refpurpose>Legt die Kodierung des FDF Zeichensatzes fest</refpurpose> + <refpurpose> + Legt die Kodierung des FDF Zeichensatzes fest + </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -555,15 +589,16 @@ </funcprototype> </funcsynopsis> <para> - <function>fdf_set_encoding</function> legt die Kodierung des - Zeichensatzes innerhalb des FDF Dokuments <parameter>fdf_document</parameter> fest. - In Acrobat 5.0 sind "<literal>Shift_JIS</literal>", "<literal>UHC</literal>", - "<literal>GBK</literal>","<literal>BigFive</literal>" gültige Werte für den Parameter - <parameter>encoding</parameter>. + <function>fdf_set_encoding</function> legt die Kodierung des + Zeichensatzes innerhalb des FDF Dokuments + <parameter>fdf_document</parameter> fest. In Acrobat 5.0 sind + "<literal>Shift_JIS</literal>", "<literal>UHC</literal>", + "<literal>GBK</literal>","<literal>BigFive</literal>" gültige + Werte für den Parameter <parameter>encoding</parameter>. </para> <para> - Die Funktion <function>fdf_set_encoding</function> ist ab PHP-4.0.7 oder - später verfügbar. + Die Funktion <function>fdf_set_encoding</function> ist ab + PHP-4.0.7 oder später verfügbar. </para> </refsect1> </refentry>