Saltar al pie de página
USANDO IRONPDF

Cómo Añadir Estampador de PDF en C#

Estampar texto e imágenes en un PDF implica superponer contenido adicional en un documento PDF existente. Este contenido, a menudo llamado "sello", puede ser texto, imágenes o una combinación. Normalmente, los usuarios añaden información, etiquetas, marcas de agua o anotaciones a un PDF utilizando sellos.

  1. TextStamper: TextStamper es su solución para agregar texto descriptivo a los archivos PDF. Ya sea que estés mejorando un documento existente, colocando texto en la misma página o incorporando detalles de otros documentos PDF, este sellador te permite personalizar tus archivos con descripciones e información.
  2. ImageStamper: ImageStamper es la herramienta ideal para colocar imágenes dentro de sus archivos PDF. Ya sea un logo para la descripción del archivo, una ilustración para un documento existente o un elemento visual para la misma página u otro documento PDF, este sellador asegura una integración perfecta de imágenes.
  3. HtmlStamper: HtmlStamper lleva la personalización al siguiente nivel, permitiéndole estampar contenido HTML en sus archivos PDF. Esto incluye la creación de elementos dinámicos como contenido interactivo, descripciones y especificaciones de archivos, proporcionando flexibilidad más allá de la personalización tradicional de PDF.
  4. BarcodeStamper para estampar códigos de barras: BarcodeStamper simplifica el proceso de agregar códigos de barras a sus PDF. Ya sea para fines de seguimiento en un documento firmado, archivo temporal o como adjunto, este sellador asegura la integración eficiente de códigos de barras en tus PDFs.
  5. BarcodeStamper para estampar códigos QR: BarcodeStamper también se especializa en colocar códigos QR en sus PDF. Perfecto para crear contenido interactivo o adjuntos de archivos, este sellador te permite incrustar códigos QR en la misma página u otros documentos PDF, asegurando un fácil acceso a información adicional.

Estas clases de selladores especializados facilitan a los usuarios mejorar fácilmente los documentos PDF con varios elementos, desde texto básico hasta diseños HTML intrincados y códigos de barras dinámicos. Este artículo explorará las funcionalidades de tres selladores principales: Añadir Texto con TextStamper, Colocar Imágenes con ImageStamper, y Integrar HTML con HtmlStamper. HTMLStamper es particularmente potente porque puede utilizar todas las características de HTML, junto con el estilo CSS, añadiendo una capa extra de versatilidad al proceso de estampado.

Cómo estampar texto e imágenes en PDF

  1. Descarga la biblioteca C# para estampar texto e imágenes.
  2. Crea y configura la clase de sellador deseada.
  3. Usa el método 'ApplyStamp' para aplicar el sello al PDF.
  4. Aplica múltiples sellos usando el método 'ApplyMultipleStamps'.
  5. Especifica páginas particulares para aplicar los sellos.

Configuración y aplicación de sellos de texto en PDF

Primero, crea un objeto de la clase TextStamper para soportar el estampado de texto en PDFs. El objeto de esta clase contiene todas las configuraciones para especificar cómo se presenta el sellador de texto. Pasa el objeto textStamper al método 'ApplyStamp'. La propiedad Text define el contenido que se mostrará en el PDF.

Además, es posible especificar la familia de fuentes, el estilo de fuente, así como la ubicación del Sello. Esta personalización se extiende a elementos interactivos, descripciones de archivos y contenido existente en el mismo u otros PDFs. Luego, exporta el PDF con el nombre real del archivo.

Al completar las configuraciones, exporta el archivo PDF de salida con el nombre de archivo designado, encapsulando todos los ajustes y proporcionando un toque profesional a tus documentos.

using IronPdf;
using IronPdf.Editing;

// Initialize the PDF renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Create a PDF document from HTML content
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create a TextStamper object and configure its properties
TextStamper textStamper = new TextStamper()
{
    Text = "Text Stamper!",
    FontFamily = "Bungee Spice",
    UseGoogleFont = true,
    FontSize = 30,
    IsBold = true,
    IsItalic = true,
    VerticalAlignment = VerticalAlignment.Top,
};

// Apply the text stamp to the PDF document
pdf.ApplyStamp(textStamper);

// Save the modified PDF document
pdf.SaveAs("stampText.pdf");
using IronPdf;
using IronPdf.Editing;

// Initialize the PDF renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Create a PDF document from HTML content
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create a TextStamper object and configure its properties
TextStamper textStamper = new TextStamper()
{
    Text = "Text Stamper!",
    FontFamily = "Bungee Spice",
    UseGoogleFont = true,
    FontSize = 30,
    IsBold = true,
    IsItalic = true,
    VerticalAlignment = VerticalAlignment.Top,
};

// Apply the text stamp to the PDF document
pdf.ApplyStamp(textStamper);

// Save the modified PDF document
pdf.SaveAs("stampText.pdf");
$vbLabelText   $csharpLabel

Configuración y aplicación de sellos de imagen en PDF

Similar al sellador de texto, crea un objeto de la clase ImageStamper y luego utiliza el Método Aplicar de ImageStamper para aplicar la imagen al documento. El segundo parámetro de este método también acomoda un índice de página, permitiendo la aplicación del sello a una o múltiples páginas. Esta instancia específica puede instruir al sistema para aplicar la imagen como un sello, particularmente en la primera página del PDF.

Todos los índices de páginas siguen el índice basado en cero.

using IronPdf;
using IronPdf.Editing;

// Initialize the PDF renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Create a PDF document from HTML content
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create an ImageStamper object with the image URL
ImageStamper imageStamper = new ImageStamper(new Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg"))
{
    VerticalAlignment = VerticalAlignment.Top,
};

// Apply the image stamp to the first page of the PDF document
pdf.ApplyStamp(imageStamper, 0);

// Save the modified PDF document
pdf.SaveAs("stampImage.pdf");
using IronPdf;
using IronPdf.Editing;

// Initialize the PDF renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Create a PDF document from HTML content
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create an ImageStamper object with the image URL
ImageStamper imageStamper = new ImageStamper(new Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg"))
{
    VerticalAlignment = VerticalAlignment.Top,
};

// Apply the image stamp to the first page of the PDF document
pdf.ApplyStamp(imageStamper, 0);

// Save the modified PDF document
pdf.SaveAs("stampImage.pdf");
$vbLabelText   $csharpLabel

Aplicar varios sellos

Para añadir múltiples sellos a un documento, utiliza el método para Aplicación de Múltiples Sellos en IronPDF pasando un array de selladores. Esto te permite añadir varios elementos, como texto, imágenes o etiquetas, todo de una sola vez. En este ejemplo, se crearon dos selladores de texto con diferente texto y alineaciones, el pdf.ApplyMultipleStamps aplica ambos sellos al PDF, y el documento final se guarda como multipleStamps.pdf. Este método simplifica el proceso de añadir varios sellos, proporcionando una manera conveniente de mejorar tu PDF con múltiples elementos, ya sea en la misma página, otro PDF o incluso una página en blanco.

using IronPdf;
using IronPdf.Editing;

// Initialize the PDF renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Create a PDF document from HTML content
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create two TextStamper objects with different configurations
TextStamper stamper1 = new TextStamper()
{
    Text = "Text stamp 1",
    VerticalAlignment = VerticalAlignment.Top,
    HorizontalAlignment = HorizontalAlignment.Left,
};

TextStamper stamper2 = new TextStamper()
{
    Text = "Text stamp 2",
    VerticalAlignment = VerticalAlignment.Top,
    HorizontalAlignment = HorizontalAlignment.Right,
};

// Add the stampers to an array
Stamper[] stampersToApply = { stamper1, stamper2 };

// Apply multiple stamps to the PDF document
pdf.ApplyMultipleStamps(stampersToApply);

// Save the modified PDF document
pdf.SaveAs("multipleStamps.pdf");
using IronPdf;
using IronPdf.Editing;

// Initialize the PDF renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Create a PDF document from HTML content
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create two TextStamper objects with different configurations
TextStamper stamper1 = new TextStamper()
{
    Text = "Text stamp 1",
    VerticalAlignment = VerticalAlignment.Top,
    HorizontalAlignment = HorizontalAlignment.Left,
};

TextStamper stamper2 = new TextStamper()
{
    Text = "Text stamp 2",
    VerticalAlignment = VerticalAlignment.Top,
    HorizontalAlignment = HorizontalAlignment.Right,
};

// Add the stampers to an array
Stamper[] stampersToApply = { stamper1, stamper2 };

// Apply multiple stamps to the PDF document
pdf.ApplyMultipleStamps(stampersToApply);

// Save the modified PDF document
pdf.SaveAs("multipleStamps.pdf");
$vbLabelText   $csharpLabel

Especificación de la ubicación del sello en un documento PDF

Para definir la colocación del Sello, utiliza una cuadrícula de 3x3 con tres columnas horizontales y tres filas verticales. Tienes opciones para la alineación horizontal: izquierda, centro, derecha, y para la alineación vertical: arriba, medio, abajo. Puedes ajustar los desplazamientos horizontal y vertical para mayor precisión en cada posición. Por favor, consulta la imagen siguiente para una representación visual de este concepto.

Cómo Añadir Sello PDF en C#, Figura 1: Posicionamiento de sello PDF Posicionamiento del sello PDF

  • Alineación horizontal: la alineación horizontal del sello con respecto a la página.
  • Alineación vertical: la alineación vertical del sello con respecto a la página.
  • HorizontalOffset: El desplazamiento horizontal. El valor por defecto es 0, y la unidad por defecto es IronPdf.Editing.MeasurementUnit.Percentage. Los valores positivos indican un desplazamiento hacia la derecha, mientras que los negativos indican un desplazamiento hacia la izquierda.
  • VerticalOffset: El desplazamiento vertical. El valor por defecto es 0, y la unidad por defecto es IronPdf.Editing.MeasurementUnit.Percentage. Los valores positivos indican un desplazamiento hacia abajo, mientras que los negativos indican un desplazamiento hacia arriba.

Para especificar las propiedades DesplazamientoHorizontal y DesplazamientoVertical, instancia la Clase de Longitud Especificada para una medición detallada. La unidad de medida predeterminada para Longitud es un porcentaje, pero también puede usar unidades de medida como pulgadas, milímetros, centímetros, píxeles y puntos.

using IronPdf.Editing;

// Create an ImageStamper object with an image URL
ImageStamper imageStamper = new ImageStamper(new Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg"))
{
    HorizontalAlignment = HorizontalAlignment.Center,
    VerticalAlignment = VerticalAlignment.Top,

    // Specify offsets for precise positioning
    HorizontalOffset = new Length(10), // 10% offset to the right
    VerticalOffset = new Length(10), // 10% offset downward
};
using IronPdf.Editing;

// Create an ImageStamper object with an image URL
ImageStamper imageStamper = new ImageStamper(new Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg"))
{
    HorizontalAlignment = HorizontalAlignment.Center,
    VerticalAlignment = VerticalAlignment.Top,

    // Specify offsets for precise positioning
    HorizontalOffset = new Length(10), // 10% offset to the right
    VerticalOffset = new Length(10), // 10% offset downward
};
$vbLabelText   $csharpLabel

Configuración y aplicación de sellos HTML en PDF

Hay otra clase de selladores que pueden ser usados para estampar tanto texto como imágenes. La Clase HtmlStamper para Integración de HTML puede renderizar diseños HTML con estilo CSS y estamparlos en el documento PDF. La propiedad InnerHtmlBaseUrl se utiliza para especificar la URL base para los activos del string HTML, como archivos CSS e imágenes.

La clase HtmlStamper se aplica al PDF. Este objeto sellador incluye una imagen y texto, los cuales puedes definir en el fragmento HTML que será estampado en tu PDF. Todas las referencias externas a archivos JavaScript, CSS e imágenes serán relativas a la propiedad interna Html. Este código te permite personalizar el PDF de acuerdo con las especificaciones de archivo específicas mencionadas en el contenido HTML. Finalmente, el PDF modificado se guarda con el nombre de archivo 'stampHtml.pdf'.

using IronPdf;
using IronPdf.Editing;

// Initialize the PDF renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Create a PDF document from HTML content
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create an HtmlStamper object and configure its properties
HtmlStamper htmlStamper = new HtmlStamper()
{
    Html = @"<img src='https://ironpdf.com/img/svgs/iron-pdf-logo.svg'>
    <h1>Iron Software</h1>",
    VerticalAlignment = VerticalAlignment.Top,
};

// Apply the HTML stamp to the PDF document
pdf.ApplyStamp(htmlStamper);

// Save the modified PDF document
pdf.SaveAs("stampHtml.pdf");
using IronPdf;
using IronPdf.Editing;

// Initialize the PDF renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Create a PDF document from HTML content
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create an HtmlStamper object and configure its properties
HtmlStamper htmlStamper = new HtmlStamper()
{
    Html = @"<img src='https://ironpdf.com/img/svgs/iron-pdf-logo.svg'>
    <h1>Iron Software</h1>",
    VerticalAlignment = VerticalAlignment.Top,
};

// Apply the HTML stamp to the PDF document
pdf.ApplyStamp(htmlStamper);

// Save the modified PDF document
pdf.SaveAs("stampHtml.pdf");
$vbLabelText   $csharpLabel

Opciones de HTML Stamper

Además de las opciones mencionadas y explicadas anteriormente, a continuación hay más disponibles para las clases de selladores.

  • Opacidad: Permite que el sello sea transparente. 0 es completamente invisible, y 100 es completamente opaco.
  • Rotación: gira el sello en el sentido de las agujas del reloj de 0 a 360 grados según lo especificado.
  • MaxWidth: El ancho máximo del sello de salida.
  • MaxHeight: La altura máxima del sello de salida.
  • MinWidth: El ancho mínimo del sello de salida.
  • MinHeight: La altura mínima del sello de salida.
  • Hipervínculo: hace que los elementos estampados de este estampador tengan un hipervínculo al hacer clic. Nota: Los enlaces HTML creados por las etiquetas de vínculo(a) no se preservan al estampar en la salida final.
  • Escala: Aplica una escala de porcentaje a los sellos para hacerlos más grandes o más pequeños. El valor por defecto es 100 (Porcentaje), lo que no tiene efecto.
  • IsStampBehindContent: Establezca en verdadero para aplicar el sello detrás del contenido. Si el contenido es opaco, el Sello puede ser invisible.
  • WaitFor: Un contenedor conveniente para esperar varios eventos o algún tiempo.
  • Tiempo de espera: tiempo de espera de renderizado en segundos. El valor por defecto es 60.

Las opciones del sellador de IronPDF brindan personalización avanzada, permitiendo a los usuarios mejorar los PDFs con transparencia, rotación precisa y dimensiones controladas. Funciones como Hipervínculo y Escala facilitan la incorporación de todos los elementos interactivos, adhiriéndose a las especificaciones de archivos y enfatizando solo el contenido. La opción EsSelloDetrásDelContenido posiciona estratégicamente los sellos, asegurando que sean parte del mismo objeto, no de los campos. Al mismo tiempo, la función EsperaPor gestiona eficientemente los eventos de renderizado, haciendo de IronPDF una herramienta versátil para la personalización de PDF, incluyendo la rotación de la página original.

Conclusión

En conclusión, la Funcionalidad del sellador de IronPDF proporciona una solución versátil y fácil de usar para mejorar documentos PDF. Ya sea añadiendo etiquetas de texto simples, incorporando imágenes o aprovechando el poder de HTML y CSS con el HTMLStamper, IronPDF se adapta a una amplia gama de necesidades de personalización.

La facilidad de uso y los ejemplos prácticos que muestran la aplicación de sellos de texto e imagen lo hacen accesible para usuarios con diferentes niveles de experiencia técnica. Las opciones del sellador, incluyendo opacidad, rotación y escala, contribuyen a un conjunto de herramientas integral para usuarios que buscan personalizar PDFs sin esfuerzo. La función de sellador de IronPDF se destaca como una herramienta confiable y eficiente, empoderando a los usuarios para elevar fácilmente sus documentos PDF.

Esencialmente, Dominar Mejoras de PDF con IronPDF eleva sin esfuerzo los PDFs tanto para necesidades básicas como avanzadas, incluyendo Extracción de Textos e Imágenes Incrustados, Manipulación de Formularios PDF con Facilidad, Fusión o División Eficiente de Archivos PDF, y Formateo de PDFs con Encabezados y Pies de Página Personalizados programáticamente. Para consultas o solicitudes de características, el Equipo de Soporte de IronPDF está listo para ayudar.

Preguntas Frecuentes

¿Qué es el estampado de PDF y cómo se puede usar en C#?

El estampado de PDF implica añadir contenido como texto, imágenes o HTML a un documento PDF existente. En C#, puedes usar las clases de estampadores de IronPDF como TextStamper y ImageStamper para aplicar estos elementos de manera eficiente.

¿Qué clases de estampadores están disponibles para la personalización de PDF?

IronPDF ofrece varias clases de estampadores especializadas, incluyendo TextStamper para texto, ImageStamper para imágenes, HtmlStamper para contenido HTML y BarcodeStamper para códigos de barras y códigos QR.

¿Cómo aplico un sello de texto a un PDF usando C#?

Para aplicar un sello de texto, crea un objeto TextStamper, configura propiedades como el contenido de texto y la fuente, y luego aplícalo al PDF usando el método ApplyStamp.

¿Puedo incrustar contenido HTML en un documento PDF?

Sí, utilizando el HtmlStamper de IronPDF, puedes incrustar contenido HTML en documentos PDF, permitiendo elementos dinámicos y estilizados.

¿Cómo puedo controlar la ubicación de un sello en una página de PDF?

IronPDF te permite controlar la ubicación del sello utilizando un sistema de cuadrícula de 3x3 para la alineación y ajustes precisos con desplazamientos horizontales y verticales.

¿Qué opciones están disponibles para personalizar los sellos de PDF?

Puedes personalizar los sellos de PDF en IronPDF con opciones como opacidad, rotación, escalado, enlaces y la capacidad de colocar sellos detrás del contenido existente.

¿Cómo aplico múltiples tipos de sellos a un solo documento PDF?

Con IronPDF, utiliza el método ApplyMultipleStamps para aplicar varios tipos de sellos, como texto e imágenes, a un solo documento PDF de manera eficiente.

¿Es posible añadir códigos QR a un PDF?

Sí, puedes utilizar el BarcodeStamper de IronPDF para añadir códigos QR a los PDFs, que se pueden utilizar para fines interactivos e informativos.

¿Qué papel juega la Clase Abstracta Stamper en el estampado de PDF?

La Clase Abstracta Stamper en IronPDF es fundamental para crear clases de estampadores especializadas, proporcionando funcionalidades comunes para operaciones de estampado.

¿Cómo aplico estampas de imágenes en un PDF usando C#?

Crea un objeto ImageStamper, configura sus propiedades y usa el método ApplyStamp, especificando opcionalmente un índice de página, para estampar imágenes en documentos PDF.

¿IronPDF es compatible con .NET 10 para utilizar clases PDF Stamper?

Sí, IronPDF es totalmente compatible con .NET 10. La biblioteca es compatible con .NET 10 y versiones anteriores, como .NET 9, .NET 8, .NET Core, .NET Standard y .NET Framework. Esto significa que todas las clases de estampador, incluidas TextStamper , ImageStamper , HtmlStamper y BarcodeStamper , funcionan sin modificaciones en proyectos .NET 10.

Curtis Chau
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