Formatage de texte à l'intérieur d'un PDF en utilisant Python

Comment ajouter une indentation de ligne au PDF

Aspose.PDF pour .NET offre la propriété SubsequentLinesIndent dans la classe TextFormattingOptions. Elle peut être utilisée pour spécifier l’indentation de ligne dans les scénarios de génération de PDF avec TextFragment et la collection Paragraphs.

Veuillez utiliser l’extrait de code suivant pour utiliser la propriété :

// Pour des exemples complets et des fichiers de données, veuillez visiter https://github.com/aspose-pdf/Aspose.PDF-for-.NET
// Le chemin vers le répertoire des documents.
string dataDir = RunExamples.GetDataDir_AsposePdf_Text();
// Créer un nouvel objet document
Aspose.Pdf.Document document = new Aspose.Pdf.Document();
Aspose.Pdf.Page page = document.Pages.Add();

string textFragment = string.Concat(Enumerable.Repeat("Un rapide renard brun a sauté par-dessus le chien paresseux. ", 10));

Aspose.Pdf.Text.TextFragment text = new Aspose.Pdf.Text.TextFragment(textFragment);

// Initialiser TextFormattingOptions pour le fragment de texte et spécifier la valeur de SubsequentLinesIndent
text.TextState.FormattingOptions = new Aspose.Pdf.Text.TextFormattingOptions()
{
    SubsequentLinesIndent = 20
};

page.Paragraphs.Add(text);

text = new Aspose.Pdf.Text.TextFragment("Ligne2");
page.Paragraphs.Add(text);

text = new Aspose.Pdf.Text.TextFragment("Ligne3");
page.Paragraphs.Add(text);

text = new Aspose.Pdf.Text.TextFragment("Ligne4");
page.Paragraphs.Add(text);

text = new Aspose.Pdf.Text.TextFragment("Ligne5");
page.Paragraphs.Add(text);

document.Save(dataDir + "SubsequentIndent_out.pdf");

Comment ajouter une bordure de texte

Le code suivant montre comment ajouter une bordure à un texte en utilisant TextBuilder et en réglant la propriété DrawTextRectangleBorder de TextState :

// Pour des exemples complets et des fichiers de données, veuillez consulter https://github.com/aspose-pdf/Aspose.PDF-for-.NET
// Le chemin vers le répertoire des documents.
string dataDir = RunExamples.GetDataDir_AsposePdf_Text();
// Créer un nouvel objet document
Document pdfDocument = new Document();
// Obtenir une page particulière
Page pdfPage = (Page)pdfDocument.Pages.Add();
// Créer un fragment de texte
TextFragment textFragment = new TextFragment("texte principal");
textFragment.Position = new Position(100, 600);
// Définir les propriétés du texte
textFragment.TextState.FontSize = 12;
textFragment.TextState.Font = FontRepository.FindFont("TimesNewRoman");
textFragment.TextState.BackgroundColor = Aspose.Pdf.Color.LightGray;
textFragment.TextState.ForegroundColor = Aspose.Pdf.Color.Red;
// Définir la propriété StrokingColor pour dessiner une bordure autour du rectangle de texte
textFragment.TextState.StrokingColor = Aspose.Pdf.Color.DarkRed;
// Définir la valeur de la propriété DrawTextRectangleBorder à true
textFragment.TextState.DrawTextRectangleBorder = true;
TextBuilder tb = new TextBuilder(pdfPage);
tb.AppendText(textFragment);
// Enregistrer le document
pdfDocument.Save(dataDir + "PDFWithTextBorder_out.pdf");

Comment ajouter du texte souligné

Le code suivant vous montre comment ajouter du texte souligné lors de la création d’un nouveau fichier PDF.

// Pour des exemples complets et des fichiers de données, veuillez visiter https://github.com/aspose-pdf/Aspose.PDF-for-.NET
// Le chemin d'accès au répertoire des documents.
string dataDir = RunExamples.GetDataDir_AsposePdf_Text();

// Créer un objet de documentation
Document pdfDocument = new Document();
// Ajouter une page vierge au document PDF
pdfDocument.Pages.Add();
// Créer un TextBuilder pour la première page
TextBuilder tb = new TextBuilder(pdfDocument.Pages[1]);
// TextFragment avec un texte d'exemple
TextFragment fragment = new TextFragment("Message de test");
// Définir la police pour TextFragment
fragment.TextState.Font = FontRepository.FindFont("Arial");
fragment.TextState.FontSize = 10;
// Définir le formatage du texte comme souligné
fragment.TextState.Underline = true;
// Spécifier la position où le TextFragment doit être placé
fragment.Position = new Position(10, 800);
// Ajouter le TextFragment au fichier PDF
tb.AppendText(fragment);

dataDir = dataDir + "AddUnderlineText_out.pdf";

// Enregistrer le document PDF résultant.
pdfDocument.Save(dataDir);

Comment ajouter une bordure autour du texte ajouté

Vous avez le contrôle sur l’apparence du texte que vous ajoutez. L’exemple ci-dessous montre comment ajouter une bordure autour d’un texte que vous avez ajouté en dessinant un rectangle autour de celui-ci. Découvrez plus sur la classe PdfContentEditor.

// Pour des exemples complets et des fichiers de données, veuillez visiter https://github.com/aspose-pdf/Aspose.PDF-for-.NET
// Le chemin vers le répertoire des documents.
string dataDir = RunExamples.GetDataDir_AsposePdf_Text();

PdfContentEditor editor = new PdfContentEditor();
editor.BindPdf(dataDir + "input.pdf");
LineInfo lineInfo = new LineInfo();
lineInfo.LineWidth = 2;
lineInfo.VerticeCoordinate = new float[] { 0, 0, 100, 100, 50, 100 };
lineInfo.Visibility = true;
editor.CreatePolygon(lineInfo, 1, new System.Drawing.Rectangle(0, 0, 0, 0), "");

dataDir = dataDir + "AddingBorderAroundAddedText_out.pdf";

// Enregistrer le document PDF résultant.
editor.Save(dataDir);

Comment ajouter un saut de ligne

TextFragment ne prend pas en charge le saut de ligne à l’intérieur du texte. Cependant, pour ajouter du texte avec saut de ligne, veuillez utiliser TextFragment avec TextParagraph :

utilisez “\r\n” ou Environment.NewLine dans TextFragment au lieu d’un seul “\n” ;
créez un objet TextParagraph. Il ajoutera du texte avec découpage de ligne ;
ajoutez le TextFragment avec TextParagraph.AppendLine ;
ajoutez le TextParagraph avec TextBuilder.AppendParagraph. Veuillez utiliser l’extrait de code ci-dessous.

// Pour des exemples complets et des fichiers de données, veuillez consulter https://github.com/aspose-pdf/Aspose.PDF-for-.NET
// Le chemin vers le répertoire des documents.
string dataDir = RunExamples.GetDataDir_AsposePdf_Text();
Aspose.Pdf.Document pdfApplicationDoc = new Aspose.Pdf.Document();
Aspose.Pdf.Page applicationFirstPage = (Aspose.Pdf.Page)pdfApplicationDoc.Pages.Add();

// Initialiser un nouveau TextFragment avec texte contenant les marqueurs de nouvelle ligne requis
Aspose.Pdf.Text.TextFragment textFragment = new Aspose.Pdf.Text.TextFragment("Nom du candidat : " + Environment.NewLine + " Joe Smoe");

// Définir les propriétés du fragment de texte si nécessaire
textFragment.TextState.FontSize = 12;
textFragment.TextState.Font = Aspose.Pdf.Text.FontRepository.FindFont("TimesNewRoman");
textFragment.TextState.BackgroundColor = Aspose.Pdf.Color.LightGray;
textFragment.TextState.ForegroundColor = Aspose.Pdf.Color.Red;

// Créer un objet TextParagraph
TextParagraph par = new TextParagraph();

// Ajouter un nouveau TextFragment au paragraphe
par.AppendLine(textFragment);

// Définir la position du paragraphe
par.Position = new Aspose.Pdf.Text.Position(100, 600);

// Créer un objet TextBuilder
TextBuilder textBuilder = new TextBuilder(applicationFirstPage);
// Ajouter le TextParagraph en utilisant TextBuilder
textBuilder.AppendParagraph(par);

dataDir = dataDir + "AddNewLineFeed_out.pdf";

// Enregistrer le document PDF résultant.
pdfApplicationDoc.Save(dataDir);

Comment ajouter du texte barré

La classe TextState fournit les fonctionnalités pour définir le formatage des TextFragments placés à l’intérieur d’un document PDF. Vous pouvez utiliser cette classe pour définir le formatage du texte en Gras, Italique, Souligné et à partir de cette version, l’API a fourni la possibilité de marquer le formatage du texte comme Barré. Veuillez essayer d’utiliser l’extrait de code suivant pour ajouter un TextFragment avec un formatage barré.

Veuillez utiliser l’extrait de code complet :

// Pour des exemples complets et des fichiers de données, veuillez consulter https://github.com/aspose-pdf/Aspose.PDF-for-.NET
// Le chemin vers le répertoire des documents.
string dataDir = RunExamples.GetDataDir_AsposePdf_Text();
// Ouvrir le document
Document pdfDocument = new Document();
// Obtenir une page particulière
Page pdfPage = (Page)pdfDocument.Pages.Add();

// Créer un fragment de texte
TextFragment textFragment = new TextFragment("main text");
textFragment.Position = new Position(100, 600);

// Définir les propriétés du texte
textFragment.TextState.FontSize = 12;
textFragment.TextState.Font = FontRepository.FindFont("TimesNewRoman");
textFragment.TextState.BackgroundColor = Aspose.Pdf.Color.LightGray;
textFragment.TextState.ForegroundColor = Aspose.Pdf.Color.Red;
// Définir la propriété Barré
textFragment.TextState.StrikeOut = true;
// Marquer le texte comme Gras
textFragment.TextState.FontStyle = FontStyles.Bold;

// Créer un objet TextBuilder
TextBuilder textBuilder = new TextBuilder(pdfPage);
// Ajouter le fragment de texte à la page PDF
textBuilder.AppendText(textFragment);


dataDir = dataDir + "AddStrikeOutText_out.pdf";

// Enregistrer le document PDF résultant.
pdfDocument.Save(dataDir);

Appliquer un ombrage en dégradé au texte

Le formatage du texte a été encore amélioré dans l’API pour les scénarios d’édition de texte et vous pouvez désormais ajouter du texte avec un espace colorimétrique de motif dans le document PDF. La classe Aspose.Pdf.Color a été encore améliorée en introduisant une nouvelle propriété PatternColorSpace, qui peut être utilisée pour spécifier les couleurs d’ombrage pour le texte. Cette nouvelle propriété ajoute différents ombrages en dégradé au texte, par exemple, un ombrage axial, un ombrage radial (Type 3) comme indiqué dans l’extrait de code suivant :

// Pour des exemples complets et des fichiers de données, veuillez vous rendre sur https://github.com/aspose-pdf/Aspose.PDF-for-.NET
// Le chemin vers le répertoire des documents.
string dataDir = RunExamples.GetDataDir_AsposePdf_Text();

using (Document pdfDocument = new Document(dataDir + "text_sample4.pdf"))
{
    TextFragmentAbsorber absorber = new TextFragmentAbsorber("Lorem ipsum");
    pdfDocument.Pages.Accept(absorber);

    TextFragment textFragment = absorber.TextFragments[1];

    // Créer une nouvelle couleur avec un espace colorimétrique de motif
    textFragment.TextState.ForegroundColor = new Aspose.Pdf.Color()
    {
        PatternColorSpace = new Aspose.Pdf.Drawing.GradientAxialShading(Color.Red, Color.Blue)
    };
    textFragment.TextState.Underline = true;

    pdfDocument.Save(dataDir + "text_out.pdf");
}

Pour appliquer un dégradé radial, vous pouvez définir la propriété ‘PatternColorSpace’ égale à ‘Aspose.Pdf.Drawing.GradientRadialShading(startingColor, endingColor)’ dans l’extrait de code ci-dessus.

Comment aligner du texte sur du contenu flottant

Aspose.PDF prend en charge le réglage de l’alignement du texte pour le contenu à l’intérieur d’un élément Floating Box. Les propriétés d’alignement de l’instance Aspose.Pdf.FloatingBox peuvent être utilisées pour y parvenir comme montré dans l’exemple de code suivant.

// Pour des exemples complets et des fichiers de données, veuillez consulter https://github.com/aspose-pdf/Aspose.PDF-for-.NET
// Le chemin vers le répertoire des documents.
string dataDir = RunExamples.GetDataDir_AsposePdf_Text();

Aspose.Pdf.Document doc = new Document();
doc.Pages.Add();

Aspose.Pdf.FloatingBox floatBox = new Aspose.Pdf.FloatingBox(100, 100);
floatBox.VerticalAlignment = VerticalAlignment.Bottom;
floatBox.HorizontalAlignment = Aspose.Pdf.HorizontalAlignment.Right;
floatBox.Paragraphs.Add(new TextFragment("FloatingBox_bottom"));
floatBox.Border = new Aspose.Pdf.BorderInfo(Aspose.Pdf.BorderSide.All, Aspose.Pdf.Color.Blue);
doc.Pages[1].Paragraphs.Add(floatBox);

Aspose.Pdf.FloatingBox floatBox1 = new Aspose.Pdf.FloatingBox(100, 100);
floatBox1.VerticalAlignment = VerticalAlignment.Center;
floatBox1.HorizontalAlignment = Aspose.Pdf.HorizontalAlignment.Right;
floatBox1.Paragraphs.Add(new TextFragment("FloatingBox_center"));
floatBox1.Border = new Aspose.Pdf.BorderInfo(Aspose.Pdf.BorderSide.All, Aspose.Pdf.Color.Blue);
doc.Pages[1].Paragraphs.Add(floatBox1);

Aspose.Pdf.FloatingBox floatBox2 = new Aspose.Pdf.FloatingBox(100, 100);
floatBox2.VerticalAlignment = VerticalAlignment.Top;
floatBox2.HorizontalAlignment = Aspose.Pdf.HorizontalAlignment.Right;
floatBox2.Paragraphs.Add(new TextFragment("FloatingBox_top"));
floatBox2.Border = new Aspose.Pdf.BorderInfo(Aspose.Pdf.BorderSide.All, Aspose.Pdf.Color.Blue);
doc.Pages[1].Paragraphs.Add(floatBox2);

doc.Save(dataDir + "FloatingBox_alignment_review_out.pdf");

PDF Tooltip en utilisant Python Remplacer du Texte dans un PDF via Python