1. IronPDF
  2. Guías
  3. Fondos y Primeros Planos
Cómo agregar fondos y primeros planos en PDFs

Cómo añadir superposición de fondo y primer plano en PDF con C

Curtis Chau
Curtis Chau
Actualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF le permite añadir imágenes de fondo o PDF detrás del contenido existente y superponer elementos de primer plano encima. Cree marcas de agua, membretes, sellos y anotaciones en sus aplicaciones C#. Esta función agiliza la personalización de documentos, permitiéndole mejorar los PDF con elementos de marca profesionales y superposiciones importantes sin modificar la estructura del contenido original. En el entorno empresarial español, estas capacidades son fundamentales para los sistemas de facturación que deben cumplir con VeriFactu y Facturae: las facturas requieren fondos corporativos reconocibles, sellos de duplicado ("DUPLICADO", "COPIA AUTORIZADA") sobre las copias, y en algunos casos la superposición del código QR VERI*FACTU generado por la AEAT como elemento de primer plano verificable. Los documentos enviados a través de FACe o al SII deben mantener una estructura visual consistente definida por las plantillas corporativas aprobadas.

Añadir fondos para insertar imágenes o documentos PDF como capa de fondo detrás del contenido existente. Utilice esta técnica para membretes, marcas de agua o elementos decorativos. Mantiene la coherencia de la marca en todos los documentos corporativos, crea formularios oficiales con plantillas prediseñadas y añade sutiles elementos de seguridad detrás del contenido principal.

Superposición de primeros planos para colocar texto, imágenes u otro contenido encima de los PDF existentes. Entre los usos comunes se incluyen la adición de sellos de "CONFIDENCIAL", sellos de fecha/hora, firmas de aprobación o notas específicas de página que aparecen de forma destacada sobre el contenido del documento.

Tanto las funciones de fondo como las de primer plano funcionan con PDF en IronPDF. Aplique estas mejoras a páginas individuales, a varias páginas o a documentos enteros para tener un control total sobre su flujo de trabajo de personalización de PDF.

Inicio rápido: Cómo agregar fondo a sus documentos PDF

Mejore sus documentos PDF añadiendo fondos con IronPDF. Esta guía muestra cómo insertar archivos PDF como capas de fondo para membretes o marcas de agua. Sigue el fragmento de código para empezar. En primer lugar, instale IronPDF a través de NuGet.

  1. Instala IronPDF con el Administrador de Paquetes NuGet

    PM > Install-Package IronPdf

  2. Copie y ejecute este fragmento de código.

    var pdf = new IronPdf.PdfDocument("input.pdf");
pdf.AddBackgroundPdf("background.pdf");
pdf.SaveAs("output.pdf");

  3. Despliegue para probar en su entorno real

    Comienza a usar IronPDF en tu proyecto hoy mismo con una prueba gratuita

    arrow pointer

Flujo de trabajo mínimo (5 pasos)

  1. Descargar la biblioteca IronPDF de NuGet
  2. Usar un PDF recién renderizado o existente como fondo o primer plano
  3. Utilice el método AddBackgroundPdf para añadir un fondo
  4. Utilice el método AddForegroundOverlayPdf para superponer un primer plano
  5. Especificar a qué páginas aplicar el fondo o el primer plano


¿Cómo añado un fondo a mi PDF?

Utilice el método AddBackgroundPdf para añadir fondos a documentos PDF nuevos o existentes. El ejemplo a continuación muestra el uso de un objeto PdfDocument en el método. También puedes especificar una ruta de archivo para importar y añadir un PDF como fondo en una sola línea. Esta flexibilidad funciona tanto con fondos generados dinámicamente como con archivos de plantilla preexistentes.

IronPDF crea capas de contenido de forma inteligente al añadir fondos. El texto y las imágenes del PDF original permanecen visibles mientras que el fondo aparece detrás de ellos. Esto funciona especialmente bien con contenido original transparente o semitransparente, ya que los fondos se muestran adecuadamente. Para escenarios de fondo complejos, explore la funcionalidad de marca de agua personalizada para obtener un control adicional sobre la opacidad y el posicionamiento.

¿Cuál es el código completo para añadir un fondo?

:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-background.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>");

// Render background
PdfDocument background = renderer.RenderHtmlAsPdf("<body style='background-color: cyan;'></body>");

// Add background
pdf.AddBackgroundPdf(background);

pdf.SaveAs("addBackground.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>")

' Render background
Private background As PdfDocument = renderer.RenderHtmlAsPdf("<body style='background-color: cyan;'></body>")

' Add background
pdf.AddBackgroundPdf(background)

pdf.SaveAs("addBackground.pdf")
$vbLabelText   $csharpLabel

¿Cómo es el PDF de fondo?

¿Cómo superponer un primer plano en mi PDF?

Al igual que para añadir fondos, puedes especificar rutas de archivos PDF para importar documentos y superponerlos como primeros planos. Utilice el método AddForegroundOverlayPdf para superponer primeros planos en los PDFs principales. Este método añade eficazmente marcas de agua, sellos o anotaciones que aparecen sobre el contenido del documento.

La función de superposición en primer plano admite varios casos de uso, desde simples superposiciones de texto hasta elementos gráficos complejos. Al crear contenido en primer plano, utilice transformaciones CSS y ajustes de opacidad para obtener resultados profesionales. Esta técnica funciona a la perfección con conversión de HTML a PDF, lo que permite diseñar superposiciones utilizando tecnologías web conocidas.

¿Cuál es el código completo para superponer un primer plano?

:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-foreground.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>");

// Render foreground
PdfDocument foreground = renderer.RenderHtmlAsPdf("<h1 style='transform: rotate(-45deg); opacity: 50%;'>Overlay Watermark</h1>");

// Overlay foreground
pdf.AddForegroundOverlayPdf(foreground);

pdf.SaveAs("overlayForeground.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>")

' Render foreground
Private foreground As PdfDocument = renderer.RenderHtmlAsPdf("<h1 style='transform: rotate(-45deg); opacity: 50%;'>Overlay Watermark</h1>")

' Overlay foreground
pdf.AddForegroundOverlayPdf(foreground)

pdf.SaveAs("overlayForeground.pdf")
$vbLabelText   $csharpLabel

¿Qué aspecto tiene la superposición de primer plano?

¿Cómo selecciono páginas específicas para el fondo o el primer plano?

Elija qué página de un PDF desea utilizar como fondo o primer plano. Usando el ejemplo de fondo de la sección 'Add Background Example', generamos un PDF de dos páginas con diferentes colores para el fondo. Al especificar 1 como el segundo parámetro en AddBackgroundPdf, utilizamos la segunda página como fondo.

Esta función es útil cuando se tienen plantillas PDF de varias páginas y se desea que diferentes páginas sirvan de fondo para diferentes secciones del documento. Por ejemplo, las plantillas corporativas pueden tener diseños diferentes para las portadas, las páginas de contenido y los apéndices. La selección de páginas funciona bien con funciones de manipulación de páginas de PDF para un control exhaustivo del documento.

ConsejosTodos los índices de páginas siguen la indexación basada en cero.

¿Cómo utilizar una página específica como fondo?

:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-background-page-2.cs
using IronPdf;

string backgroundHtml = @"
<div style = 'background-color: cyan; height: 100%;'></div>
<div style = 'page-break-after: always;'></div>
<div style = 'background-color: lemonchiffon; height: 100%;'></div>";

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>");

// Render background
PdfDocument background = renderer.RenderHtmlAsPdf(backgroundHtml);

// Use page 2 as background
pdf.AddBackgroundPdf(background, 1);

pdf.SaveAs("addBackgroundFromPage2.pdf");
Imports IronPdf

Private backgroundHtml As String = "
<div style = 'background-color: cyan; height: 100%;'></div>
<div style = 'page-break-after: always;'></div>
<div style = 'background-color: lemonchiffon; height: 100%;'></div>"

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>")

' Render background
Private background As PdfDocument = renderer.RenderHtmlAsPdf(backgroundHtml)

' Use page 2 as background
pdf.AddBackgroundPdf(background, 1)

pdf.SaveAs("addBackgroundFromPage2.pdf")
$vbLabelText   $csharpLabel

¿Cuál es el resultado cuando se utiliza una página específica?

¿Cómo aplicar fondo o primer plano a páginas específicas?

Aplicar fondos o primeros planos a páginas individuales o múltiples páginas utilizando diferentes nombres de métodos. Utilice AddBackgroundPdfToPage y AddForegroundOverlayPdfToPage para añadir fondos y superponer primeros planos en páginas específicas de un PDF. Estos métodos proporcionan un control preciso sobre la mejora del documento para documentos profesionales con distintos diseños en las páginas.

Para documentos complejos que requieran tratamientos diferentes en páginas distintas, combine estos métodos con funciones de fusión y división de PDF para crear sofisticados flujos de trabajo de documentos. Esto funciona especialmente bien para la generación de informes en los que las portadas, las páginas de contenido y los apéndices requieren diferentes tratamientos de fondo.

ConsejosTodos los índices de páginas siguen la indexación basada en cero.

¿Cómo se aplica a una sola página?

:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-background.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>");

// Render background
PdfDocument background = renderer.RenderHtmlAsPdf("<body style='background-color: cyan;'></body>");

// Add background
pdf.AddBackgroundPdf(background);

pdf.SaveAs("addBackground.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>")

' Render background
Private background As PdfDocument = renderer.RenderHtmlAsPdf("<body style='background-color: cyan;'></body>")

' Add background
pdf.AddBackgroundPdf(background)

pdf.SaveAs("addBackground.pdf")
$vbLabelText   $csharpLabel

¿Cómo se aplica a varias páginas?

Cuando trabaje con documentos de varias páginas, aplique fondos o primeros planos a intervalos de páginas específicos. El método AddBackgroundPdfToPageRange acepta una lista de índices de páginas para una flexibilidad completa al elegir qué páginas recibirán mejoras. Este enfoque funciona a la perfección con numeración de páginas y otras funciones de organización de documentos.

:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-multiple-pages.cs
using IronPdf;
using System.Collections.Generic;

string html = @"<p> This is 1st Page </p>
<div style = 'page-break-after: always;'></div>
<p> This is 2nd Page</p>
<div style = 'page-break-after: always;'></div>
<p> This is 3rd Page</p>";

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Render background
PdfDocument background = renderer.RenderHtmlAsPdf("<body style='background-color: cyan;'></body>");

// Create list of pages
List<int> pages = new List<int>() { 0, 2 };

// Add background to page 1 & 3
pdf.AddBackgroundPdfToPageRange(pages, background);

pdf.SaveAs("addBackgroundOnMultiplePage.pdf");
Imports IronPdf
Imports System.Collections.Generic

Private html As String = "<p> This is 1st Page </p>
<div style = 'page-break-after: always;'></div>
<p> This is 2nd Page</p>
<div style = 'page-break-after: always;'></div>
<p> This is 3rd Page</p>"

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

' Render background
Private background As PdfDocument = renderer.RenderHtmlAsPdf("<body style='background-color: cyan;'></body>")

' Create list of pages
Private pages As New List(Of Integer)() From {0, 2}

' Add background to page 1 & 3
pdf.AddBackgroundPdfToPageRange(pages, background)

pdf.SaveAs("addBackgroundOnMultiplePage.pdf")
$vbLabelText   $csharpLabel

¿Qué aspecto tiene el resultado multipágina?

Bestes prácticas y consejos avanzados

Tenga en cuenta estas estrategias de optimización al implementar fondos y primeros planos en sus flujos de trabajo PDF:

  1. Consideraciones de rendimiento: Renderice previamente los PDF de fondo y primer plano y reutilícelos en varias operaciones para documentos de gran tamaño. Esto mejora el rendimiento en comparación con la renderización de las mismas para cada documento.

  2. Gestión de Memoria: Disponga adecuadamente de los objetos PdfDocument al procesar múltiples PDFs para prevenir pérdidas de memoria. Implemente estas características dentro de las sentencias using para la limpieza automática de recursos.

  3. Gestión de plantillas: Cree una biblioteca de plantillas de fondo y primer plano cargadas desde el disco en lugar de generadas cada vez. Esto funciona bien con características de plantilla PDF para un estilo de documento coherente.

  4. Transparencia y estratificación: Utiliza la opacidad CSS y los colores RGBA al diseñar superposiciones de primer plano para crear marcas de agua profesionales que no oculten el contenido subyacente. Prueba diferentes niveles de opacidad para equilibrar la visibilidad y la legibilidad.

Conclusión

Las funciones de fondo y primer plano de IronPDF proporcionan potentes herramientas para mejorar los documentos PDF en aplicaciones C#. Añada membretes corporativos, marcas de agua de seguridad o anotaciones en documentos que se integren a la perfección en su flujo de trabajo de generación de PDF. Para conocer técnicas más avanzadas de manipulación de PDF, explore nuestras guías sobre edición de PDF y firmas digitales.

Fondos y primeros planos en la documentación fiscal española

En el ecosistema de facturación electrónica español, las capas de fondo y primer plano tienen aplicaciones específicas que van más allá de la personalización estética:

  • Sello VERI*FACTU como primer plano: La normativa VeriFactu requiere que cada factura electrónica incluya un código QR con la huella del registro ante la AEAT. Muchos ISVs implementan este QR como elemento de primer plano superpuesto sobre la factura base, garantizando que siempre aparezca en la posición requerida sin alterar la plantilla HTML subyacente. Con AddForegroundOverlayPdf, el QR generado dinámicamente se superpone con precisión.

  • Marca de agua "DUPLICADO" en copias de facturas Facturae: El formato Facturae exige que las copias de facturas ya registradas ante organismos públicos (FACe) lleven la indicación "DUPLICADO" de forma visible. Aplicar esta marca de agua como capa de primer plano mediante AddForegroundOverlayPdfToPage permite generar automáticamente copias marcadas sin crear plantillas HTML alternativas.

  • Membretes y fondos corporativos en documentos AEAT: Las declaraciones de IVA auxiliares, los listados de operaciones del SII y los dossiers de cumplimiento enviados a la AEAT suelen requerir el membrete corporativo como fondo de página. AddBackgroundPdf permite insertar este membrete de forma independiente al contenido del documento, facilitando la actualización de la imagen corporativa sin regenerar el contenido fiscal.

  • Documentos de auditoría con fondo de página de control: Los auditores que revisan expedientes fiscales de empresas bajo inspección de la AEPD o la AEAT valoran la identificación visual de cada sección. Aplicar fondos diferenciados a páginas de portada, páginas de contenido y apéndices —usando AddBackgroundPdfToPageRange— crea dossiers profesionales que guían al auditor a través del expediente de forma estructurada.

  • Plantillas para comunicaciones con TicketBAI: Los ISVs que desarrollan software para el País Vasco (Bizkaia, Gipuzkoa, Araba) bajo el sistema TicketBAI necesitan aplicar el logotipo y los datos de la hacienda foral correspondiente como fondo de los tiques generados. La selección de página (AddBackgroundPdf con índice de página) permite utilizar una única plantilla multihacienda y aplicar el fondo correcto según el territorio fiscal del emisor.

Preguntas Frecuentes

¿Cómo añado una imagen de fondo a un PDF en C#?

Con IronPDF, puede añadir fácilmente imágenes de fondo a los PDF mediante el método AddBackgroundPdf. Este método le permite insertar documentos PDF como capas de fondo detrás del contenido existente, perfecto para crear membretes, marcas de agua o elementos decorativos. IronPDF mantiene la visibilidad de su contenido original mientras coloca el fondo detrás de él.

¿Cuál es la diferencia entre añadir fondos y primeros planos a los PDF?

IronPDF proporciona dos métodos distintos para la mejora de PDF: AddBackgroundPdf coloca el contenido detrás de los elementos existentes (útil para membretes y marcas de agua), mientras que AddForegroundOverlayPdf coloca el contenido encima de las páginas existentes (ideal para sellos, firmas y marcas confidenciales). Ambos métodos funcionan a la perfección con el motor de renderizado de IronPDF.

¿Puedo aplicar fondos sólo a determinadas páginas?

Sí, IronPDF le permite especificar qué páginas deben recibir fondos o primeros planos. Puede aplicar estas mejoras a páginas individuales, a varias páginas o a documentos enteros, lo que le proporciona un control total sobre su flujo de trabajo de personalización de PDF a través de la flexible API de IronPDF.

¿Qué formatos de archivo puedo utilizar como fondo?

El método AddBackgroundPdf de IronPDF funciona con documentos PDF como fondos. Puede proporcionar un objeto PdfDocument o especificar una ruta de archivo para importar y añadir un PDF como fondo. Esta flexibilidad de IronPDF le permite trabajar tanto con fondos generados dinámicamente como con archivos de plantilla preexistentes.

¿Cómo funciona la transparencia al añadir fondos?

IronPDF gestiona de forma inteligente la transparencia al añadir fondos. El texto y las imágenes originales del PDF permanecen visibles mientras que el fondo aparece detrás de ellos. Esto funciona especialmente bien con contenido original transparente o semitransparente, ya que IronPDF se asegura de que los fondos se muestren de forma adecuada a la vez que se mantiene la legibilidad del documento.

¿Cómo añadir el sello VERI*FACTU como primer plano en facturas PDF con IronPDF?

La normativa VeriFactu requiere que cada factura incluya un código QR verificable ante la AEAT. Con AddForegroundOverlayPdf de IronPDF, los ISVs pueden superponer el QR VERI*FACTU generado dinámicamente sobre la plantilla de factura base, garantizando que aparezca en la posición correcta sin modificar la plantilla HTML subyacente.

¿Cómo gestionar plantillas de fondo para facturas TicketBAI de diferentes haciendas forales?

El sistema TicketBAI del País Vasco requiere que los tiques incluyan los datos de la hacienda foral correspondiente (Bizkaia, Gipuzkoa o Araba). Con AddBackgroundPdf e índice de página, los ISVs pueden mantener una única plantilla PDF con tres fondos de hacienda en páginas separadas y aplicar el fondo correcto según el territorio fiscal del emisor.

Curtis Chau
Curtis Chau
  Chatea con el equipo de ingeniería ahora
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más
¿Listo para empezar?
Nuget Descargas 18,926,724 | Versión: 2026.5 just released
Still Scrolling Icon

¿Aún desplazándote?

¿Quieres una prueba rápida? PM > Install-Package IronPdf
ejecutar una muestra Mira cómo tu HTML se convierte en PDF.