Ajouter une bordure de texte dans un fichier PDF
Ce didacticiel vous guidera tout au long du processus d’ajout d’une bordure de texte dans un fichier PDF à l’aide d’Aspose.PDF pour .NET. Le code source C# fourni montre les étapes nécessaires.
Exigences
Avant de commencer, assurez-vous d’avoir les éléments suivants :
- Visual Studio ou tout autre compilateur C# installé sur votre machine.
- Aspose.PDF pour la bibliothèque .NET. Vous pouvez le télécharger depuis le site officiel d’Aspose ou utiliser un gestionnaire de packages comme NuGet pour l’installer.
Étape 1 : Configurer le projet
- Créez un nouveau projet C# dans votre environnement de développement préféré.
- Ajoutez une référence à la bibliothèque Aspose.PDF pour .NET.
Étape 2 : Importer les espaces de noms requis
Dans le fichier de code où vous souhaitez ajouter la bordure de texte, ajoutez la directive using suivante en haut du fichier :
using Aspose.Pdf;
using Aspose.Pdf.Text;
Étape 3 : Définir le répertoire des documents
Dans le code, localisez la ligne qui ditstring dataDir = "YOUR DOCUMENT DIRECTORY";
et remplacer"YOUR DOCUMENT DIRECTORY"
avec le chemin d’accès au répertoire où sont stockés vos documents.
Étape 4 : Créer un nouvel objet Document
Instancier un nouveauDocument
objet en ajoutant la ligne de code suivante :
Document pdfDocument = new Document();
Étape 5 : Ajouter une page au document
Ajoutez une nouvelle page au document en utilisant leAdd
méthode duPages
collection. Dans le code fourni, la nouvelle page est affectée à la variablepdfPage
.
Page pdfPage = (Page)pdfDocument.Pages.Add();
Étape 6 : Créer un TextFragment
Créer unTextFragment
objet et fournir le texte souhaité. Définissez la position du fragment de texte à l’aide duPosition
propriété. Dans le code fourni, le texte est défini sur “texte principal” et positionné en (100, 600) sur la page.
TextFragment textFragment = new TextFragment("main text");
textFragment.Position = new Position(100, 600);
Étape 7 : Définir les propriétés du texte
Personnalisez les propriétés du texte telles que la taille de la police, le type de police, la couleur d’arrière-plan, la couleur de premier plan, etc. Dans le code fourni, des propriétés telles que la taille de la police, la police, la couleur d’arrière-plan, la couleur de premier plan et la couleur de trait sont définies pour le fragment de 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;
textFragment.TextState.StrokingColor = Aspose.Pdf.Color.DarkRed;
Étape 8 : Activer la bordure de texte
Pour activer la bordure de texte, définissez leDrawTextRectangleBorder
propriété du fragment de texteTextState
àtrue
.
textFragment.TextState.DrawTextRectangleBorder = true;
Étape 9 : ajouter le TextFragment à la page
Utilisez leTextBuilder
classe pour ajouter leTextFragment
s’opposer à la page.
TextBuilder tb = new TextBuilder(pdfPage);
tb.AppendText(textFragment);
Étape 10 : Enregistrez le document PDF
Enregistrez le document PDF à l’aide duSave
méthode duDocument
objet. Spécifiez le chemin du fichier de sortie que vous avez défini à l’étape 3.
pdfDocument.Save(dataDir + "PDFWithTextBorder_out.pdf");
Exemple de code source pour Ajouter une bordure de texte à l’aide d’Aspose.PDF pour .NET
// Le chemin d'accès au répertoire des documents.
string dataDir = "YOUR DOCUMENT DIRECTORY";
// 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("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é StrokingColor pour dessiner une bordure (en caressant) autour du rectangle de texte
textFragment.TextState.StrokingColor = Aspose.Pdf.Color.DarkRed;
// Définir la valeur de la propriété DrawTextRectangleBorder sur true
textFragment.TextState.DrawTextRectangleBorder = true;
TextBuilder tb = new TextBuilder(pdfPage);
tb.AppendText(textFragment);
// Enregistrez le document
pdfDocument.Save(dataDir + "PDFWithTextBorder_out.pdf");
Conclusion
Vous avez réussi à ajouter une bordure de texte à votre document PDF à l’aide d’Aspose.PDF pour .NET. Le fichier PDF résultant peut maintenant être trouvé au chemin du fichier de sortie spécifié.
FAQ
Q : Quel est l’objectif principal de ce didacticiel ?
R : Ce didacticiel vous guide tout au long du processus d’ajout d’une bordure de texte à un fichier PDF à l’aide de la bibliothèque Aspose.PDF pour .NET. Le code source C# fourni montre les étapes nécessaires pour y parvenir.
Q : Quels espaces de noms dois-je importer pour ce didacticiel ?
R : Dans le fichier de code dans lequel vous souhaitez ajouter la bordure de texte, importez les espaces de noms suivants au début du fichier :
using Aspose.Pdf;
using Aspose.Pdf.Text;
Q : Comment spécifier le répertoire des documents ?
R : Dans le code, localisez la lignestring dataDir = "YOUR DOCUMENT DIRECTORY";
et remplacer"YOUR DOCUMENT DIRECTORY"
avec le chemin réel vers votre répertoire de documents.
Q : Comment créer un objet Document ?
R : À l’étape 4, vous allez instancier un nouveauDocument
objet en utilisant la ligne de code suivante :
Document pdfDocument = new Document();
Q : Comment ajouter une page au document ?
R : À l’étape 5, vous ajouterez une nouvelle page au document à l’aide de l’outilAdd
méthode duPages
collection:
Page pdfPage = (Page)pdfDocument.Pages.Add();
Q : Comment créer un TextFragment et définir sa position ?
R : À l’étape 6, vous allez créer unTextFragment
objet et définissez sa position sur la page à l’aide duPosition
propriété:
TextFragment textFragment = new TextFragment("main text");
textFragment.Position = new Position(100, 600);
Q : Comment puis-je personnaliser les propriétés du texte, y compris la bordure du texte ?
R : À l’étape 7, vous personnaliserez diverses propriétés de texte telles que la taille de la police, le type de police, la couleur d’arrière-plan, la couleur de premier plan et la bordure 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;
textFragment.TextState.StrokingColor = Aspose.Pdf.Color.DarkRed;
textFragment.TextState.DrawTextRectangleBorder = true;
Q : Comment ajouter le TextFragment au document PDF ?
R : À l’étape 9, vous utiliserez leTextBuilder
classe pour ajouter leTextFragment
s’opposer à la page :
TextBuilder tb = new TextBuilder(pdfPage);
tb.AppendText(textFragment);
Q : Comment puis-je enregistrer le document PDF obtenu ?
R : Après avoir ajouté le texte avec une bordure, utilisez leSave
méthode duDocument
objet pour enregistrer le document PDF :
pdfDocument.Save(dataDir + "PDFWithTextBorder_out.pdf");
Q : Quel est le principal point à retenir de ce didacticiel ?
R : En suivant ce didacticiel, vous avez appris avec succès comment améliorer votre document PDF en ajoutant une bordure de texte à l’aide d’Aspose.PDF pour .NET. Cela peut être particulièrement utile pour mettre en valeur un contenu textuel spécifique dans vos fichiers PDF.