cvs: peardoc /fr/package/fileformats/spreadsheet-excel-writer intro-format.xml intro.xml
| From: | Yannick Torres | Date: | Wed, 15 Mar 2006 20:27:08 +0000 |
| Subject: | cvs: peardoc /fr/package/fileformats/spreadsheet-excel-writer intro-format.xml intro.xml | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-7672@lists.php.net to get a copy of this message | ||
yannick Wed Mar 15 20:27:08 2006 UTC
Added files:
/peardoc/fr/package/fileformats/spreadsheet-excel-writer
intro-format.xml
intro.xml
Log:
initiale translation
http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/fileformats/spreadsheet-excel-writer/intro-format.xml?view=markup&rev=1.1 Index: peardoc/fr/package/fileformats/spreadsheet-excel-writer/intro-format.xml +++ peardoc/fr/package/fileformats/spreadsheet-excel-writer/intro-format.xml <?xml version="1.0" encoding="iso-8859-1" ?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <refentry id="package.fileformats.spreadsheet-excel-writer.intro-format"> <refnamediv> <refname>Tutoriel sur le formattage</refname> <refpurpose>Comment formatter des cellules dans une feuille de calcul</refpurpose> </refnamediv> <refsect1 id="package.fileformats.spreadsheet-excel-writer.intro-format.whatis"> <title>Qu'est-ce qu'un format ?</title> <para> Un format est un objet de type <classname>Spreadsheet_Excel_Writer_Format</classname>. Ce format peut être appliqué à des cellules d'une feuille de calcul ; ces cellules héritent des propriétés du format (alignement de texte, couleur d'arrière-plan, couleur des bordures, etc.). </para> </refsect1> <refsect1 id="package.fileformats.spreadsheet-excel-writer.intro-format.using-it"> <title>Utilisation</title> <para> Les formats peuvent être créés directement par un nouvel appel. Vous devez créer un format en utilisant la méthode <link linkend="package.fileformats.spreadsheet-excel-writer.spreadsheet-excel-writer-workbook.addformat"> <function>addFormat</function></link> d'un manuel de travail, en associant votre format à ce manuel de travail (vous pouvez utiliser ce format avec un autre manuel de travail). </para> <para> Voyons comment <link linkend="package.fileformats.spreadsheet-excel-writer.spreadsheet-excel-writer-workbook.addformat"> <function>addFormat</function></link> est utilisé : </para> <example> <title>Utilisation d'addFormat</title> <programlisting role="php"> <![CDATA[ <?php require_once 'Spreadsheet/Excel/Writer.php'; // Création d'un manuel de travail $workbook = new Spreadsheet_Excel_Writer(); // Création du format $format_bold =& $workbook->addFormat(); $format_bold->setBold(); ?> ]]> </programlisting> </example> <para> Ici, nous créons juste un format de mise en gras. Notez le signe ET commercial (&) qui apparait lorsque nous créons notre format. </para> </refsect1> <refsect1 id="package.fileformats.spreadsheet-excel-writer.intro-format.something-useful"> <title>Faire quelque chose d'utile !</title> <para> Nous avons juste créé notre premier format, mais nous ne l'avons pas utilisé. Pas très élégant ! </para> <para> Admettons que vous voulez créer votre première feuille de calcul contenant des données. A ce point, lorsque vous allez présenter votre superbe création à votre patron, ceci risque d'arriver : <blockquote> <para><classname>Le patron</classname> - Mmmmhhh, ca semble pas mal.</para> <para><classname>Vous</classname> - Oui, j'ai ajouté ces totaux comme vous me l'avez demandé.</para> <para><classname>Le patron</classname> - Mmmmhhh, vous savez, il va falloir personnaliser cette feuille de calcul...</para> <para><classname>Vous</classname> - Oui...</para> <para><classname>Le patron</classname> - Mmmmhhh, que pensez-vous de changer le style de ces en-têtes ci ?</para> <para><classname>Vous</classname> - ...</para> </blockquote> Bien sûr, il ne s'agit pas juste de ces en-têtes : "Pourquoi ne pas centre ce titre ?", "Pouvez-vous fusionner ces cellules ?", "que pensez-vous d'utiliser les couleurs de l'entreprises pour ces titres ?". </para> <para> Il y a plusieurs façons de résoudre ces situations, mais dans ce tutoriel, nous allons nous attacher à vous faire conserver votre emploi... </para> <para> Commençons le travail sur la feuille de calcul pour DotCom.com. </para> <example> <title>Premier exemple</title> <programlisting role="php"> <![CDATA[ <?php require_once 'Spreadsheet/Excel/Writer.php'; $workbook = new Spreadsheet_Excel_Writer(); $format_bold =& $workbook->addFormat(); $format_bold->setBold(); // Nous avons besoin d'une feuille de travail dans laquelle nous allons placer nos données $worksheet =& $workbook->addWorksheet(); // Ceci est notre titre $worksheet->write(0, 0, "Bénéfices de Dotcom.Com", $format_bold); // Et maintenant, les données $worksheet->write(0, 0, 0); ?> ]]> </programlisting> </example> <para> Ajoutons maintenant les couleurs de l'entreprise ! </para> <example> <title>Second exemple</title> <programlisting role="php"> <![CDATA[ <?php require_once 'Spreadsheet/Excel/Writer.php'; $workbook = new Spreadsheet_Excel_Writer(); $format_bold =& $workbook->addFormat(); $format_bold->setBold(); $format_title =& $workbook->addFormat(); $format_title->setBold(); $format_title->setColor('yellow'); $format_title->setPattern(1); $format_title->setFgColor('blue'); $worksheet =& $workbook->addWorksheet(); $worksheet->write(0, 0, "Bénéfices trimestriels de Dotcom.Com", $format_title); // Ajoutons quelques chiffres $worksheet->write(1, 0, "Trimestres", $format_bold); $worksheet->write(1, 1, "Bénéfices", $format_bold); $worksheet->write(2, 0, "T1"); $worksheet->write(2, 1, 0); $worksheet->write(3, 0, "T2"); $worksheet->write(3, 1, 0); $workbook->send('test.xls'); $workbook->close(); ?> ]]> </programlisting> </example> </refsect1> <refsect1 id="package.fileformats.spreadsheet-excel-writer.intro-format.merging-cells"> <title>Fusion de cellules</title> <para> Si vous avez testé l'exemple précédent, vous avez pu noter que le titre a besoin de plusieurs cellules afin d'être correctement affiché, mais le format que nous avons appliqué ne l'est que pour la premier cellule. Notre titre n'apparait donc pas de façon la plus jolie... </para> <para> Que pouvons-nous faire pour résoudre cela ? Vous pouvez toujours dire à votre patron que le titre vous parrait sympa tel que et qu'il devrait consulter un ophtalmologiste. Ou vous pouvez utiliser la fusion de cellule afin d'afficher correctement votre titre sur plusieurs cellules. </para> <para> Pour cela, vous devez utiliser la méthode <link linkend="package.fileformats.spreadsheet-excel-writer.spreadsheet-excel-writer-format.setalign"> <function>setAlign</function></link> avec 'merge' en tant qu'argument, et de créer quelques cellules vides que votre titre pourra utiliser en tant qu'arrière plan (il y aura une meilleure solution pour réaliser cela dans une future version de <classname>Spreadsheet_Excel_Writer</classname>). </para> <para> Reprenons notre exemple : </para> <example> <title>Fusion de cellules</title> <programlisting role="php"> <![CDATA[ <?php require_once 'Spreadsheet/Excel/Writer.php'; $workbook = new Spreadsheet_Excel_Writer(); $format_bold =& $workbook->addFormat(); $format_bold->setBold(); $format_title =& $workbook->addFormat(); $format_title->setBold(); $format_title->setColor('yellow'); $format_title->setPattern(1); $format_title->setFgColor('blue'); // Fusion $format_title->setAlign('merge'); $worksheet =& $workbook->addWorksheet(); $worksheet->write(0, 0, "Bénéfices trimestriels de Dotcom.Com", $format_title); // Plusieurs cellules vides pour rendre le tout plus jolie $worksheet->write(0, 1, "", $format_title); $worksheet->write(0, 2, "", $format_title); $worksheet->write(1, 0, "Trimestres", $format_bold); $worksheet->write(1, 1, "Bénéfices", $format_bold); $worksheet->write(2, 0, "Q1"); $worksheet->write(2, 1, 0); $worksheet->write(3, 0, "Q2"); $worksheet->write(3, 1, 0); $workbook->send('test.xls'); $workbook->close(); ?> ]]> </programlisting> </example> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/fileformats/spreadsheet-excel-writer/intro.xml?view=markup&rev=1.1 Index: peardoc/fr/package/fileformats/spreadsheet-excel-writer/intro.xml +++ peardoc/fr/package/fileformats/spreadsheet-excel-writer/intro.xml <?xml version="1.0" encoding="iso-8859-1" ?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <refentry id="package.fileformats.spreadsheet-excel-writer.intro"> <refnamediv> <refname>Introduction</refname> <refpurpose>Comment générer des fichiers Excel</refpurpose> </refnamediv> <refsect1 id="package.fileformats.spreadsheet-excel-writer.intro.whatis"> <title>Qu'est-ce Spreadsheet_Excel_Writer?</title> <para> <classname>Spreadsheet_Excel_Writer</classname> est un utilitaire pour créer des fichiers Excel sans avoir besoin des composants COM. Les fichiers générés par l'actuel version de <classname>Spreadsheet_Excel_Writer</classname> correspond au format Excel 5 (BIFF5), toutes les fonctionnalités jusqu'à cette version doivent donc être disponibles. </para> </refsect1> <refsect1 id="package.fileformats.spreadsheet-excel-writer.intro.using-it"> <title>Utilisation</title> <para> L'utilisation la plus commune de <classname>Spreadsheet_Excel_Writer</classname> est de mettre beaucoup d'informations dans un formulaire de feuille de calcul, qui sera facilement manipulable avec un programme de manipulation de feuilles de calcul comme Excel (ou OpenOffice). </para> <para> Voici un exemple concret : </para> <example> <title>Utilisation typique</title> <programlisting role="php"> <![CDATA[ <?php require_once 'Spreadsheet/Excel/Writer.php'; // Création d'un manuel de travail $workbook = new Spreadsheet_Excel_Writer(); // Envoi des en-têtes HTTP $workbook->send('test.xls'); // Création d'une feuille de travail $worksheet =& $workbook->addWorksheet('My first worksheet'); // Les données actuelles $worksheet->write(0, 0, 'Nom'); $worksheet->write(0, 1, 'Age'); $worksheet->write(1, 0, 'John Smith'); $worksheet->write(1, 1, 30); $worksheet->write(2, 0, 'Johann Schmidt'); $worksheet->write(2, 1, 31); $worksheet->write(3, 0, 'Juan Herrera'); $worksheet->write(3, 1, 32); // Envoi du fichier $workbook->close(); ?> ]]> </programlisting> </example> <para> La première chose à noter est que nous créons un manuel de travail avant d'ajouter une feuille de travail. Toutes les feuilles de travail sont contenues dans un manuel de travail, et un manuel de travail contient plusieurs feuilles de travail. </para> <para> Une autre chose importante, que vous devez avoir en tête lors de la programmation avec <classname>Spreadsheet_Excel_Writer</classname>, est l'utilisation du signe & (ET commercial) lors de la création de la feuille de travail. L'utilisation du ET commercial signifie que nous référençons un objet WorkSheet au lieu de le copier. Si vous ne savez pas ce que cela signifie, ne vous en faite pas, tout ce dont vous avez besoin de vous souvenir est de toujours utiliser ce "&" lors de l'appel à <link linkend="package.fileformats.spreadsheet-excel-writer.spreadsheet-excel-writer-workbook.addworksheet"> <function>addWorksheet</function></link> pour créer une feuille de travail ou <link linkend="package.fileformats.spreadsheet-excel-writer.spreadsheet-excel-writer-workbook.addformat"><function>addFormat</function></link> pour créer un format. </para> </refsect1> <refsect1 id="package.fileformats.spreadsheet-excel-writer.intro.saving-to-regular-file"> <title>Sauvegarde dans un fichier</title> <para> Vous avez du remarquer également la ligne suivante : <programlisting> <![CDATA[ // Envoi des en-têtes HTTP $workbook->send('test.xls'); ]]> </programlisting> Ce qui signifie que nous envoyons notre feuille de calcul au navigateur. Et si nous voulons uniquement sauvegarder cette feuille de calcul sur notre machine ? Vous n'avez qu'à ommettre cette ligne et passer un chemin de fichier valide au constructeur de WorkBook. </para> <para> Par exemple, si vous voulez sauvegarder la feuille de calcul créée dans notre premier exemple dans un fichier nommé 'test.xls', nous devons le faire comme cela : </para> <example> <title>Sauvegarder dans un fichier</title> <programlisting role="php"> <![CDATA[ <?php require_once 'Spreadsheet/Excel/Writer.php'; // Nous donnons un chemin à notre fichier ici $workbook = new Spreadsheet_Excel_Writer('test.xls'); $worksheet =& $workbook->addWorksheet('My first worksheet'); $worksheet->write(0, 0, 'Nom'); $worksheet->write(0, 1, 'Age'); $worksheet->write(1, 0, 'John Smith'); $worksheet->write(1, 1, 30); $worksheet->write(2, 0, 'Johann Schmidt'); $worksheet->write(2, 1, 31); $worksheet->write(3, 0, 'Juan Herrera'); $worksheet->write(3, 1, 32); // Nous devons toujours explicitement fermer le manuel de travail $workbook->close(); ?> ]]> </programlisting> </example> </refsect1> <refsect1 id="package.fileformats.spreadsheet-excel-writer.intro.more-tutorials"> <title>Plus d'exemples</title> <para> Si vous voulez avoir plus d'exemples concernant le formattage (police de caractères, couleur des cellules, alignement du texte, etc...) avec <classname>Spreadsheet_Excel_Writer</classname>, vous pouvez consulter le tutoriel sur le formattage <link linkend="package.fileformats.spreadsheet-excel-writer.intro-format"> ici</link>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/fileformats/spreadsheet-excel-writer/intro-format.xml?view=markup&rev=1.1 Index: peardoc/fr/package/fileformats/spreadsheet-excel-writer/intro-format.xml +++ peardoc/fr/package/fileformats/spreadsheet-excel-writer/intro-format.xml <?xml version="1.0" encoding="iso-8859-1" ?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <refentry id="package.fileformats.spreadsheet-excel-writer.intro-format"> <refnamediv> <refname>Tutoriel sur le formattage</refname> <refpurpose>Comment formatter des cellules dans une feuille de calcul</refpurpose> </refnamediv> <refsect1 id="package.fileformats.spreadsheet-excel-writer.intro-format.whatis"> <title>Qu'est-ce qu'un format ?</title> <para> Un format est un objet de type <classname>Spreadsheet_Excel_Writer_Format</classname>. Ce format peut être appliqué à des cellules d'une feuille de calcul ; ces cellules héritent des propriétés du format (alignement de texte, couleur d'arrière-plan, couleur des bordures, etc.). </para> </refsect1> <refsect1 id="package.fileformats.spreadsheet-excel-writer.intro-format.using-it"> <title>Utilisation</title> <para> Les formats peuvent être créés directement par un nouvel appel. Vous devez créer un format en utilisant la méthode <link linkend="package.fileformats.spreadsheet-excel-writer.spreadsheet-excel-writer-workbook.addformat"> <function>addFormat</function></link> d'un manuel de travail, en associant votre format à ce manuel de travail (vous pouvez utiliser ce format avec un autre manuel de travail). </para> <para> Voyons comment <link linkend="package.fileformats.spreadsheet-excel-writer.spreadsheet-excel-writer-workbook.addformat"> <function>addFormat</function></link> est utilisé : </para> <example> <title>Utilisation d'addFormat</title> <programlisting role="php"> <![CDATA[ <?php require_once 'Spreadsheet/Excel/Writer.php'; // Création d'un manuel de travail $workbook = new Spreadsheet_Excel_Writer(); // Création du format $format_bold =& $workbook->addFormat(); $format_bold->setBold(); ?> ]]> </programlisting> </example> <para> Ici, nous créons juste un format de mise en gras. Notez le signe ET commercial (&) qui apparait lorsque nous créons notre format. </para> </refsect1> <refsect1 id="package.fileformats.spreadsheet-excel-writer.intro-format.something-useful"> <title>Faire quelque chose d'utile !</title> <para> Nous avons juste créé notre premier format, mais nous ne l'avons pas utilisé. Pas très élégant ! </para> <para> Admettons que vous voulez créer votre première feuille de calcul contenant des données. A ce point, lorsque vous allez présenter votre superbe création à votre patron, ceci risque d'arriver : <blockquote> <para><classname>Le patron</classname> - Mmmmhhh, ca semble pas mal.</para> <para><classname>Vous</classname> - Oui, j'ai ajouté ces totaux comme vous me l'avez demandé.</para> <para><classname>Le patron</classname> - Mmmmhhh, vous savez, il va falloir personnaliser cette feuille de calcul...</para> <para><classname>Vous</classname> - Oui...</para> <para><classname>Le patron</classname> - Mmmmhhh, que pensez-vous de changer le style de ces en-têtes ci ?</para> <para><classname>Vous</classname> - ...</para> </blockquote> Bien sûr, il ne s'agit pas juste de ces en-têtes : "Pourquoi ne pas centre ce titre ?", "Pouvez-vous fusionner ces cellules ?", "que pensez-vous d'utiliser les couleurs de l'entreprises pour ces titres ?". </para> <para> Il y a plusieurs façons de résoudre ces situations, mais dans ce tutoriel, nous allons nous attacher à vous faire conserver votre emploi... </para> <para> Commençons le travail sur la feuille de calcul pour DotCom.com. </para> <example> <title>Premier exemple</title> <programlisting role="php"> <![CDATA[ <?php require_once 'Spreadsheet/Excel/Writer.php'; $workbook = new Spreadsheet_Excel_Writer(); $format_bold =& $workbook->addFormat(); $format_bold->setBold(); // Nous avons besoin d'une feuille de travail dans laquelle nous allons placer nos données $worksheet =& $workbook->addWorksheet(); // Ceci est notre titre $worksheet->write(0, 0, "Bénéfices de Dotcom.Com", $format_bold); // Et maintenant, les données $worksheet->write(0, 0, 0); ?> ]]> </programlisting> </example> <para> Ajoutons maintenant les couleurs de l'entreprise ! </para> <example> <title>Second exemple</title> <programlisting role="php"> <![CDATA[ <?php require_once 'Spreadsheet/Excel/Writer.php'; $workbook = new Spreadsheet_Excel_Writer(); $format_bold =& $workbook->addFormat(); $format_bold->setBold(); $format_title =& $workbook->addFormat(); $format_title->setBold(); $format_title->setColor('yellow'); $format_title->setPattern(1); $format_title->setFgColor('blue'); $worksheet =& $workbook->addWorksheet(); $worksheet->write(0, 0, "Bénéfices trimestriels de Dotcom.Com", $format_title); // Ajoutons quelques chiffres $worksheet->write(1, 0, "Trimestres", $format_bold); $worksheet->write(1, 1, "Bénéfices", $format_bold); $worksheet->write(2, 0, "T1"); $worksheet->write(2, 1, 0); $worksheet->write(3, 0, "T2"); $worksheet->write(3, 1, 0); $workbook->send('test.xls'); $workbook->close(); ?> ]]> </programlisting> </example> </refsect1> <refsect1 id="package.fileformats.spreadsheet-excel-writer.intro-format.merging-cells"> <title>Fusion de cellules</title> <para> Si vous avez testé l'exemple précédent, vous avez pu noter que le titre a besoin de plusieurs cellules afin d'être correctement affiché, mais le format que nous avons appliqué ne l'est que pour la premier cellule. Notre titre n'apparait donc pas de façon la plus jolie... </para> <para> Que pouvons-nous faire pour résoudre cela ? Vous pouvez toujours dire à votre patron que le titre vous parrait sympa tel que et qu'il devrait consulter un ophtalmologiste. Ou vous pouvez utiliser la fusion de cellule afin d'afficher correctement votre titre sur plusieurs cellules. </para> <para> Pour cela, vous devez utiliser la méthode <link linkend="package.fileformats.spreadsheet-excel-writer.spreadsheet-excel-writer-format.setalign"> <function>setAlign</function></link> avec 'merge' en tant qu'argument, et de créer quelques cellules vides que votre titre pourra utiliser en tant qu'arrière plan (il y aura une meilleure solution pour réaliser cela dans une future version de <classname>Spreadsheet_Excel_Writer</classname>). </para> <para> Reprenons notre exemple : </para> <example> <title>Fusion de cellules</title> <programlisting role="php"> <![CDATA[ <?php require_once 'Spreadsheet/Excel/Writer.php'; $workbook = new Spreadsheet_Excel_Writer(); $format_bold =& $workbook->addFormat(); $format_bold->setBold(); $format_title =& $workbook->addFormat(); $format_title->setBold(); $format_title->setColor('yellow'); $format_title->setPattern(1); $format_title->setFgColor('blue'); // Fusion $format_title->setAlign('merge'); $worksheet =& $workbook->addWorksheet(); $worksheet->write(0, 0, "Bénéfices trimestriels de Dotcom.Com", $format_title); // Plusieurs cellules vides pour rendre le tout plus jolie $worksheet->write(0, 1, "", $format_title); $worksheet->write(0, 2, "", $format_title); $worksheet->write(1, 0, "Trimestres", $format_bold); $worksheet->write(1, 1, "Bénéfices", $format_bold); $worksheet->write(2, 0, "Q1"); $worksheet->write(2, 1, 0); $worksheet->write(3, 0, "Q2"); $worksheet->write(3, 1, 0); $workbook->send('test.xls'); $workbook->close(); ?> ]]> </programlisting> </example> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewcvs.cgi/peardoc/fr/package/fileformats/spreadsheet-excel-writer/intro.xml?view=markup&rev=1.1 Index: peardoc/fr/package/fileformats/spreadsheet-excel-writer/intro.xml +++ peardoc/fr/package/fileformats/spreadsheet-excel-writer/intro.xml <?xml version="1.0" encoding="iso-8859-1" ?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <refentry id="package.fileformats.spreadsheet-excel-writer.intro"> <refnamediv> <refname>Introduction</refname> <refpurpose>Comment générer des fichiers Excel</refpurpose> </refnamediv> <refsect1 id="package.fileformats.spreadsheet-excel-writer.intro.whatis"> <title>Qu'est-ce Spreadsheet_Excel_Writer?</title> <para> <classname>Spreadsheet_Excel_Writer</classname> est un utilitaire pour créer des fichiers Excel sans avoir besoin des composants COM. Les fichiers générés par l'actuel version de <classname>Spreadsheet_Excel_Writer</classname> correspond au format Excel 5 (BIFF5), toutes les fonctionnalités jusqu'à cette version doivent donc être disponibles. </para> </refsect1> <refsect1 id="package.fileformats.spreadsheet-excel-writer.intro.using-it"> <title>Utilisation</title> <para> L'utilisation la plus commune de <classname>Spreadsheet_Excel_Writer</classname> est de mettre beaucoup d'informations dans un formulaire de feuille de calcul, qui sera facilement manipulable avec un programme de manipulation de feuilles de calcul comme Excel (ou OpenOffice). </para> <para> Voici un exemple concret : </para> <example> <title>Utilisation typique</title> <programlisting role="php"> <![CDATA[ <?php require_once 'Spreadsheet/Excel/Writer.php'; // Création d'un manuel de travail $workbook = new Spreadsheet_Excel_Writer(); // Envoi des en-têtes HTTP $workbook->send('test.xls'); // Création d'une feuille de travail $worksheet =& $workbook->addWorksheet('My first worksheet'); // Les données actuelles $worksheet->write(0, 0, 'Nom'); $worksheet->write(0, 1, 'Age'); $worksheet->write(1, 0, 'John Smith'); $worksheet->write(1, 1, 30); $worksheet->write(2, 0, 'Johann Schmidt'); $worksheet->write(2, 1, 31); $worksheet->write(3, 0, 'Juan Herrera'); $worksheet->write(3, 1, 32); // Envoi du fichier $workbook->close(); ?> ]]> </programlisting> </example> <para> La première chose à noter est que nous créons un manuel de travail avant d'ajouter une feuille de travail. Toutes les feuilles de travail sont contenues dans un manuel de travail, et un manuel de travail contient plusieurs feuilles de travail. </para> <para> Une autre chose importante, que vous devez avoir en tête lors de la programmation avec <classname>Spreadsheet_Excel_Writer</classname>, est l'utilisation du signe & (ET commercial) lors de la création de la feuille de travail. L'utilisation du ET commercial signifie que nous référençons un objet WorkSheet au lieu de le copier. Si vous ne savez pas ce que cela signifie, ne vous en faite pas, tout ce dont vous avez besoin de vous souvenir est de toujours utiliser ce "&" lors de l'appel à <link linkend="package.fileformats.spreadsheet-excel-writer.spreadsheet-excel-writer-workbook.addworksheet"> <function>addWorksheet</function></link> pour créer une feuille de travail ou <link linkend="package.fileformats.spreadsheet-excel-writer.spreadsheet-excel-writer-workbook.addformat"><function>addFormat</function></link> pour créer un format. </para> </refsect1> <refsect1 id="package.fileformats.spreadsheet-excel-writer.intro.saving-to-regular-file"> <title>Sauvegarde dans un fichier</title> <para> Vous avez du remarquer également la ligne suivante : <programlisting> <![CDATA[ // Envoi des en-têtes HTTP $workbook->send('test.xls'); ]]> </programlisting> Ce qui signifie que nous envoyons notre feuille de calcul au navigateur. Et si nous voulons uniquement sauvegarder cette feuille de calcul sur notre machine ? Vous n'avez qu'à ommettre cette ligne et passer un chemin de fichier valide au constructeur de WorkBook. </para> <para> Par exemple, si vous voulez sauvegarder la feuille de calcul créée dans notre premier exemple dans un fichier nommé 'test.xls', nous devons le faire comme cela : </para> <example> <title>Sauvegarder dans un fichier</title> <programlisting role="php"> <![CDATA[ <?php require_once 'Spreadsheet/Excel/Writer.php'; // Nous donnons un chemin à notre fichier ici $workbook = new Spreadsheet_Excel_Writer('test.xls'); $worksheet =& $workbook->addWorksheet('My first worksheet'); $worksheet->write(0, 0, 'Nom'); $worksheet->write(0, 1, 'Age'); $worksheet->write(1, 0, 'John Smith'); $worksheet->write(1, 1, 30); $worksheet->write(2, 0, 'Johann Schmidt'); $worksheet->write(2, 1, 31); $worksheet->write(3, 0, 'Juan Herrera'); $worksheet->write(3, 1, 32); // Nous devons toujours explicitement fermer le manuel de travail $workbook->close(); ?> ]]> </programlisting> </example> </refsect1> <refsect1 id="package.fileformats.spreadsheet-excel-writer.intro.more-tutorials"> <title>Plus d'exemples</title> <para> Si vous voulez avoir plus d'exemples concernant le formattage (police de caractères, couleur des cellules, alignement du texte, etc...) avec <classname>Spreadsheet_Excel_Writer</classname>, vous pouvez consulter le tutoriel sur le formattage <link linkend="package.fileformats.spreadsheet-excel-writer.intro-format"> ici</link>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->