CPDF_CONTINUE_TEXT

Syntaxe

Paramètres

Description

Cette fonction permet d'afficher le texte sur la ligne suivante dans un document de format PDF. Cette fonction est obsolète.

Remarques

• L'extension CLIBPDF initialement proposé à partir du PHP 3 a été progressivement retiré jusqu'à la version 5 du PHP où elle fut remplacé par l'extension PDFLIB, laquelle est utilisé par de nombreux langages de programmations autre que le PHP. Si vous ne pouvez pas installer un extension supplémentaire, vous pouvez utiliser la bibliothèque gratuite et open source entièrement écrit en PHP pure FPDF Library développé par Olivier PLATHEY.
• Son rôle principal est de continuer l'affichage du texte sur la ligne suivante dans un document PDF. Concrètement, elle permet de passer automatiquement à une nouvelle ligne tout en restant dans le bloc de texte ouvert avec cpdf_begin_text.
• Le paramètre $pdf_document est obligatoire puisqu'il identifie le document PDF sur lequel le texte doit être affiché. Sans ce paramètre, la fonction ne saurait pas dans quel contexte PDF écrire, ce qui la rendrait inutile ou provoque une erreur.
• Le paramètre $text contient le texte à afficher sur la ligne suivante. Il peut s'agir de n'importe quelle chaîne de caractères, mais la fonction ne gère pas directement les retours à la ligne multiples ou la mise en forme complexe, ce qui oblige à découper manuellement le texte si nécessaire.
• cpdf_continue_text doit être utilisée après avoir appelé cpdf_begin_text, car elle fait partie du flux de texte courant. Si cpdf_begin_text n'a pas été appelée, l'appel à cpdf_continue_text pourrait ne rien afficher ou générer une erreur.
• Comme la fonction est obsolète, elle n'est plus supportée dans les versions récentes de PHP. Les alternatives modernes incluent des bibliothèques comme TCPDF ou FPDF, gérant automatiquement le retour à la ligne, l'alignement et la justification du texte.
• La fonction illustre bien la philosophie des anciennes bibliothèques PDF, où le contrôle était très bas-niveau : le développeur devait gérer la position exacte du texte ligne par ligne, contrairement aux bibliothèques modernes qui permettent un rendu plus flexible et automatique.
• Ne pas utiliser cpdf_continue_text correctement, par exemple en oubliant d'ouvrir un bloc de texte ou en dépassant les marges, peut entraîner un texte mal positionné ou tronqué. Cela souligne l'importance de gérer l'ordre et la logique des appels dans CLIBPDF pour obtenir un rendu correct.