Fondos y primeros planos
Para añadir elementos específicos de fondo o primer plano a sus documentos PDF, IronPDF proporciona los métodos addBackground
y addForeground
. Estos métodos permiten a los desarrolladores utilizar el contenido de un PDF como fondo o primer plano de otro PDF. Estos métodos son especialmente útiles para generar grupos de PDF basados en una plantilla de diseño común.
addBackground(PdfDocument backgroundPdf);
addForeground(PdfDocument foregroundPdf);
Dado que estos métodos trabajan con objetos PdfDocument
, los desarrolladores pueden obtenerlos de archivos existentes utilizando el método fromFile
, o generarlos de nuevo utilizando uno de los métodos de renderizado PDF disponibles.
addBackground
y addForeground
utilizarán por defecto la primera página de los documentos PDF multipágina como fondo o primer plano. Para utilizar una página diferente de los PDF que contienen varias páginas, añada el índice de la página deseada como segundo argumento de la llamada al método.
// Utilice la tercera página del PDF de fondo como fondo de cada página
// en el PDF de trabajo
pdf.addBackground(backgroundPdf, 2);
// Utilizar la segunda página del PDF en primer plano como primer plano de cada página
// del PDF de trabajo
pdf.addForeground(foregroundPdf, 1);
Para superponer un PDF como fondo o primer plano en páginas específicas de un PDF de trabajo, especifique las páginas que desea superponer mediante un objeto PageSelection
. El ejemplo siguiente muestra cómo hacerlo para una sola página y para un intervalo de páginas de un documento PDF.
// Añadir el fondo a la página 5 del PDF de trabajo
pdf.addBackground(backgroundPdf, PageSelection.singlePage(6));
// Añadir un fondo diferente en las páginas 7 a 16 del PDF de trabajo
pdf.addBackground(backgroundPdf, PageSelection.pageRange(6, 15));
// Añade otro fondo sólo a la primera página.
pdf.addBackground(backgroundPdf, PageSelection.firstPage());
Para colocar marcas de agua en sus documentos PDF, utilice el método addWatermark
como alternativa a addBackground
para controlar más fácilmente la posición y la opacidad del fondo.