Symboles remplaçables dans l'en-tête du pied de page

Dans ce didacticiel, nous expliquerons comment utiliser des symboles remplaçables dans l’en-tête et le pied de page d’un document PDF à l’aide de la bibliothèque Aspose.PDF pour .NET. Nous passerons en revue le processus étape par étape de création d’un PDF, de définition des marges, d’ajout d’en-tête et de pied de page avec des symboles remplaçables et d’enregistrement du PDF à l’aide du code source C# fourni.

Conditions préalables

Avant de commencer, assurez-vous d’avoir les éléments suivants :

La bibliothèque Aspose.PDF pour .NET installée.
Une compréhension de base de la programmation C#.

Étape 1 : configurer le répertoire de documents

Tout d’abord, vous devez définir le chemin d’accès au répertoire dans lequel vous souhaitez enregistrer le fichier PDF généré. Remplacer"YOUR DOCUMENT DIRECTORY" dans ledataDirvariable avec le chemin d’accès au répertoire souhaité.

string dataDir = "YOUR DOCUMENT DIRECTORY";

Étape 2 : Créer un document et une page PDF

Ensuite, nous créons un nouveau document PDF et y ajoutons une page à l’aide duDocument classe etPage classe de la bibliothèque Aspose.PDF.

Document doc = new Document();
Page page = doc.Pages.Add();

Étape 3 : Définir les marges

Nous définissons les marges de la page en utilisant leMarginInfoclasse. Ajustez les valeurs de marge en fonction de vos besoins.

MarginInfo marginInfo = new MarginInfo();
marginInfo.Top = 90;
marginInfo.Bottom = 50;
marginInfo.Left = 50;
marginInfo.Right = 50;
page.PageInfo.Margin = marginInfo;

Étape 4 : ajouter un en-tête avec des symboles remplaçables

Nous créons unHeaderFooter objet pour la page et ajoutez unTextFragment avec des symboles remplaçables.

HeaderFooter hfFirst = new HeaderFooter();
page.Header = hfFirst;
hfFirst.Margin.Left = 50;
hfFirst.Margin.Right = 50;

TextFragment t1 = new TextFragment("report title");
// Définir les propriétés du texte si vous le souhaitez
t1.TextState.Font = FontRepository.FindFont("Arial");
t1.TextState.FontSize = 16;
t1.TextState.ForegroundColor = Aspose.Pdf.Color.Black;
t1.TextState.FontStyle = FontStyles.Bold;
t1.TextState.HorizontalAlignment = Aspose.Pdf.HorizontalAlignment.Center;
t1.TextState.LineSpacing = 5f;

hfFirst.Paragraphs.Add(t1);

// Ajoutez plus de TextFragments ou personnalisez-les selon vos besoins

Étape 5 : ajouter un pied de page avec des symboles remplaçables

De même, nous créons unHeaderFooter objet pour le pied de page et ajoutezTextFragment objets avec des symboles remplaçables.

HeaderFooter hfFoot = new HeaderFooter();
page.Footer = hfFoot;
hfFoot.Margin.Left = 50;
hfFoot.Margin.Right = 50;

TextFragment t3 = new TextFragment("Generated on test date");
TextFragment t4 = new TextFragment("report name ");
TextFragment t5 = new TextFragment("Page $p of $P");

// Ajoutez plus de TextFragments ou personnalisez-les selon vos besoins

hfFoot.Paragraphs.Add(tab2);

Étape 6 : Enregistrez le document PDF

Enfin, nous enregistrons le document PDF dans le fichier de sortie spécifié.

dataDir = dataDir + "ReplaceableSymbolsInHeaderFooter_out.pdf";
doc.Save(dataDir);
Console.WriteLine("\nReplaceable symbols replaced successfully in the header and footer.\nFile saved at " + dataDir);

Exemple de code source pour les symboles remplaçables dans le pied de page d’en-tête à l’aide d’Aspose.PDF pour .NET

// Le chemin d'accès au répertoire des documents.
string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document();
Page page = doc.Pages.Add();
MarginInfo marginInfo = new MarginInfo();
marginInfo.Top = 90;
marginInfo.Bottom = 50;
marginInfo.Left = 50;
marginInfo.Right = 50;
// Attribuez l'instance marginInfo à la propriété Margin de sec1.PageInfo
page.PageInfo.Margin = marginInfo;
HeaderFooter hfFirst = new HeaderFooter();
page.Header = hfFirst;
hfFirst.Margin.Left = 50;
hfFirst.Margin.Right = 50;
// Instanciez un paragraphe de texte qui stockera le contenu à afficher comme en-tête
TextFragment t1 = new TextFragment("report title");
t1.TextState.Font = FontRepository.FindFont("Arial");
t1.TextState.FontSize = 16;
t1.TextState.ForegroundColor = Aspose.Pdf.Color.Black;
t1.TextState.FontStyle = FontStyles.Bold;
t1.TextState.HorizontalAlignment = Aspose.Pdf.HorizontalAlignment.Center;
t1.TextState.LineSpacing = 5f;
hfFirst.Paragraphs.Add(t1);
TextFragment t2 = new TextFragment("Report_Name");
t2.TextState.Font = FontRepository.FindFont("Arial");
t2.TextState.ForegroundColor = Aspose.Pdf.Color.Black;
t2.TextState.HorizontalAlignment = Aspose.Pdf.HorizontalAlignment.Center;
t2.TextState.LineSpacing = 5f;
t2.TextState.FontSize = 12;
hfFirst.Paragraphs.Add(t2);
// Créer un objet HeaderFooter pour la section
HeaderFooter hfFoot = new HeaderFooter();
// Définissez l'objet HeaderFooter sur un pied de page pair et impair.
page.Footer = hfFoot;
hfFoot.Margin.Left = 50;
hfFoot.Margin.Right = 50;
// Ajouter un paragraphe de texte contenant le numéro de page actuel du nombre total de pages
TextFragment t3 = new TextFragment("Generated on test date");
TextFragment t4 = new TextFragment("report name ");
TextFragment t5 = new TextFragment("Page $p of $P");
// Instancier un objet table
Table tab2 = new Table();
// Ajouter le tableau dans la collection de paragraphes de la section souhaitée
hfFoot.Paragraphs.Add(tab2);
// Définir avec les largeurs de colonnes du tableau
tab2.ColumnWidths = "165 172 165";
// Créez des lignes dans le tableau puis des cellules dans les lignes
Row row3 = tab2.Rows.Add();
row3.Cells.Add();
row3.Cells.Add();
row3.Cells.Add();
// Définissez l'alignement vertical du texte comme étant aligné au centre
row3.Cells[0].Alignment = Aspose.Pdf.HorizontalAlignment.Left;
row3.Cells[1].Alignment = Aspose.Pdf.HorizontalAlignment.Center;
row3.Cells[2].Alignment = Aspose.Pdf.HorizontalAlignment.Right;
row3.Cells[0].Paragraphs.Add(t3);
row3.Cells[1].Paragraphs.Add(t4);
row3.Cells[2].Paragraphs.Add(t5);
//Sec1.Paragraphs.Add(New Text("Aspose.Total pour Java est une compilation de tous les composants Java proposés par Aspose. Il est compilé quotidiennement pour garantir qu'il contient les versions les plus récentes de chacun de nos composants Java. #$NL " + "L'utilisation d'Aspose.Total pour Java permet aux développeurs de créer une large gamme d'applications. #$NL #$NL #$NP" + "Aspose.Total pour Java est une compilation de tous les composants Java proposé par Aspose. Il est compilé quotidiennement pour garantir qu'il contient les versions les plus récentes de chacun de nos composants Java. #$NL " + "L'utilisation d'Aspose.Total pour les développeurs Java peut créer une large gamme d'applications. #$NL #$NL #$NP" + "Aspose.Total pour Java est une compilation de tous les composants Java proposés par Aspose. Il est compilé quotidiennement pour garantir qu'il contient le plus versions à jour de chacun de nos composants Java. #$NL " + "L'utilisation d'Aspose.Total pour Java permet aux développeurs de créer une large gamme d'applications. #$NL #$NL"))
Table table = new Table();
table.ColumnWidths = "33% 33% 34%";
table.DefaultCellPadding = new MarginInfo();
table.DefaultCellPadding.Top = 10;
table.DefaultCellPadding.Bottom = 10;
// Ajouter le tableau dans la collection de paragraphes de la section souhaitée
page.Paragraphs.Add(table);
// Définir la bordure de cellule par défaut à l'aide de l'objet BorderInfo
table.DefaultCellBorder = new BorderInfo(BorderSide.All, 0.1f);
// Définir la bordure du tableau à l'aide d'un autre objet BorderInfo personnalisé
table.Border = new BorderInfo(BorderSide.All, 1f);
table.RepeatingRowsCount = 1;
// Créez des lignes dans le tableau puis des cellules dans les lignes
Row row1 = table.Rows.Add();
row1.Cells.Add("col1");
row1.Cells.Add("col2");
row1.Cells.Add("col3");
const string CRLF = "\r\n";
for (int i = 0; i <= 10; i++)
{
	Row row = table.Rows.Add();
	row.IsRowBroken = true;
	for (int c = 0; c <= 2; c++)
	{
		Cell c1;
		if (c == 2)
			c1 = row.Cells.Add("Aspose.Total for Java is a compilation of every Java component offered by Aspose. It is compiled on a" + CRLF + "daily basis to ensure it contains the most up to date versions of each of our Java components. " + CRLF + "daily basis to ensure it contains the most up to date versions of each of our Java components. " + CRLF + "Using Aspose.Total for Java developers can create a wide range of applications.");
		else
			c1 = row.Cells.Add("item1" + c);
		c1.Margin = new MarginInfo();
		c1.Margin.Left = 30;
		c1.Margin.Top = 10;
		c1.Margin.Bottom = 10;
	}
}
dataDir = dataDir + "ReplaceableSymbolsInHeaderFooter_out.pdf";
doc.Save(dataDir);
Console.WriteLine("\nSymbols replaced successfully in header and footer.\nFile saved at " + dataDir);

Conclusion

Dans ce didacticiel, vous avez appris à utiliser des symboles remplaçables dans l’en-tête et le pied de page d’un document PDF à l’aide de la bibliothèque Aspose.PDF pour .NET. En suivant le guide étape par étape et en exécutant le code C# fourni, vous pouvez créer un PDF, définir des marges, ajouter un en-tête et un pied de page avec des symboles remplaçables et enregistrer le PDF.

FAQ

Q : Quel est l’objectif du didacticiel « Symboles remplaçables dans l’en-tête et le pied de page » ?

R : Le didacticiel « Symboles remplaçables dans le pied de page d’en-tête » vise à vous guider tout au long du processus d’utilisation de la bibliothèque Aspose.PDF pour .NET afin d’ajouter des symboles remplaçables à l’en-tête et au pied de page d’un document PDF. Les symboles remplaçables vous permettent de remplacer dynamiquement des espaces réservés spécifiques par des valeurs réelles lors de la génération du PDF.

Q : Que sont les symboles remplaçables dans le contexte d’un en-tête et d’un pied de page PDF ?

R : Les symboles remplaçables sont des espaces réservés que vous pouvez insérer dans l’en-tête et le pied de page d’un document PDF. Ces symboles agissent comme des espaces réservés dynamiques pour les valeurs qui peuvent être renseignées au moment de l’exécution, telles que les numéros de page, les dates et les informations personnalisées.

Q : Pourquoi voudrais-je utiliser des symboles remplaçables dans un en-tête et un pied de page PDF ?

R : Les symboles remplaçables dans l’en-tête et le pied de page sont utiles lorsque vous souhaitez inclure des informations dynamiques dans vos documents PDF, telles que des numéros de page, des dates ou d’autres données variables susceptibles de changer lors de la génération du document.

Q : Comment puis-je définir les marges de la page PDF ?

R : Vous pouvez définir les marges de la page PDF à l’aide duMarginInfo classe et l’attribuer à laMargin propriété duPageInfo de la page. Ajustez les valeurs de marge selon vos besoins.

Q : Comment ajouter des symboles remplaçables à l’en-tête et au pied de page ?

R : Vous pouvez ajouter des symboles remplaçables en créant unHeaderFooter objet pour l’en-tête et le pied de page de la page. Ensuite, vous pouvez ajouterTextFragmentobjets avec le texte souhaité, y compris les symboles remplaçables, auParagraphs collecte desHeaderFooter objet.

Q : Puis-je personnaliser l’apparence des symboles remplaçables ?

R : Oui, vous pouvez personnaliser l’apparence des symboles remplaçables en modifiant les propriétés duTextFragment objets qui contiennent les symboles. Vous pouvez définir des propriétés telles que la police, la taille de la police, la couleur, l’alignement et l’espacement des lignes.

Q : Quels types de symboles remplaçables puis-je utiliser ?

R : Vous pouvez utiliser une variété de symboles remplaçables, tels que :

$p: Numéro de la page actuelle.
$P: Nombre total de pages.
$d: Date actuelle.
$t: Heure actuelle.
Espaces réservés personnalisés que vous définissez.

Q : Puis-je inclure d’autres textes et mises en forme autour des symboles remplaçables ?

R : Oui, vous pouvez inclure d’autres textes et formats autour des symboles remplaçables dans leTextFragment objets. Cela vous permet de créer des en-têtes et des pieds de page plus complexes intégrant du contenu dynamique et statique.

Q : Comment puis-je enregistrer le document PDF généré ?

R : Pour enregistrer le document PDF généré, vous pouvez utiliser leSave méthode duDocumentclasse. Fournissez le chemin et le nom du fichier de sortie souhaité comme argument.

Q : Une licence Aspose valide est-elle requise pour ce didacticiel ?

R : Oui, une licence Aspose valide est requise pour exécuter correctement le code dans ce didacticiel. Vous pouvez obtenir une licence complète ou une licence temporaire de 30 jours sur le site Web Aspose.

Rendu des symboles remplaçables dans un fichier PDF Remplacer la première occurrence