Stamp Text & Image on PDFs using C# and IronPDF

¿Qué aspecto tiene el PDF de salida?

¿Cómo puedo crear sellos de texto de varias líneas?

Utilice la etiqueta <br> para texto de varias líneas en TextStamper. Por ejemplo, "línea 1
línea 2" produce "línea 1" en la primera línea y "línea 2" en la segunda. Así se crean sellos de dirección o marcas de agua de varias líneas.

¿Qué aspecto tiene la salida del sello de imagen?

¿Qué formatos de imagen son compatibles?

ImageStamper admite PNG, JPEG, GIF y SVG a través de referencias URI o rutas de archivos. Garantizar una conectividad de red adecuada para las imágenes remotas. Para entornos Azure, considere el uso de imágenes de Azure Blob Storage.

¿Qué ocurre cuando los sellos se superponen?

¿Puedo mezclar diferentes tipos de sellos?

ApplyMultipleStamps acepta matrices que contengan cualquier tipo de estampador. Combine TextStamper, ImageStamper, HTMLStamper y BarcodeStamper en una sola operación. Cree diseños de documentos complejos con encabezados, pies de página, marcas de agua y códigos de identificación simultáneamente.

¿Cuáles son las principales propiedades de posicionamiento?

• HorizontalAlignment: Alineación horizontal relativa a la página. Predeterminado: HorizontalAlignment.Center.
• VerticalAlignment: Alineación vertical relativa a la página. Predeterminado: VerticalAlignment.Middle.
• HorizontalOffset: Desplazamiento horizontal. Predeterminado: 0, unidad: MeasurementUnit.Percentage. Valores positivos desplazados a la derecha, valores negativos desplazados a la izquierda.
• VerticalOffset: Desplazamiento vertical. Predeterminado: 0, unidad: MeasurementUnit.Percentage. Los valores positivos se desplazan hacia abajo y los negativos hacia arriba.

¿Cómo puedo establecer desplazamientos precisos?

Especifique HorizontalOffset y VerticalOffset utilizando la clase Length. La unidad de medida por defecto es el porcentaje. Las unidades disponibles son pulgadas, milímetros, centímetros, píxeles y puntos. Esto permite un posicionamiento preciso, como establecer márgenes personalizados en documentos PDF.

Código

:path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-location.cs

using IronPdf.Editing;
using System;

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

    // Specify offsets
    HorizontalOffset = new Length(10),
    VerticalOffset = new Length(10),
};

Código

:path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-multiple-stamps.cs

using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create two text stampers
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,
};

Stamper[] stampersToApply = { stamper1, stamper2 };

// Apply multiple stamps
pdf.ApplyMultipleStamps(stampersToApply);

pdf.SaveAs("multipleStamps.pdf");

¿Cuáles son las propiedades esenciales de HTML Stamper?

• Html: Fragmento HTML para estampar en tu PDF. Las referencias externas a JavaScript, CSS e imágenes son relativas a HtmlBaseUrl.
• HtmlBaseUrl: URL base para referencias de archivos CSS, JavaScript e imágenes externos.
• CssMediaType: Habilita los estilos CSS Media="screen". La configuración AllowScreenCss=false renderiza los sellos usando CSS media="print". Predeterminado: PdfCssMediaType.Screen.

¿Por qué usar HTML Stamper en lugar de Text Stamper?

HTMLStamper ofrece compatibilidad total con HTML y CSS para diseños complejos, múltiples fuentes, colores e imágenes incrustadas en un solo sello. Ideal para marcas de agua o encabezados con contenido enriquecido. Mantiene la coherencia de la marca y trabaja con diseños CSS responsivos.

Código

:path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-text.cs

using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create text stamper
TextStamper textStamper = new TextStamper()
{
    Text = "Text Stamper!",
    FontFamily = "Bungee Spice",
    UseGoogleFont = true,
    FontSize = 30,
    IsBold = true,
    IsItalic = true,
    VerticalAlignment = VerticalAlignment.Top,
};

// Stamp the text stamper
pdf.ApplyStamp(textStamper);

pdf.SaveAs("stampText.pdf");

¿Qué opciones de configuración existen para los BarCodes?

• Value: Valor de cadena del código de barras.
• BarcodeType: Tipo de codificación compatible con QRCode, Code128 y Code39. Valor predeterminado: QRCode.
• Width: Ancho del código de barras renderizado en píxeles. Predeterminado: 250px.
• Height: Altura del código de barras renderizado en píxeles. Predeterminado: 250px.

¿Cuándo debo utilizar cada tipo de código de barras?

QRCode maneja URL y grandes conjuntos de datos (hasta 4.296 caracteres alfanuméricos). Code128 se adapta a datos alfanuméricos con requisitos de alta densidad. Code39 funciona para combinaciones simples de números o letras mayúsculas. Tenga en cuenta la compatibilidad de los equipos de escaneado a la hora de seleccionar los tipos de códigos de barras.

¿Cómo controlo la apariencia de los sellos?

• Opacity: Controla la transparencia. 0 es invisible, 100 es opaco.
• Rotation: Gira el sello en el sentido de las agujas del reloj de 0 a 360 grados.
• MaxWidth: Ancho máximo del sello de salida.
• MaxHeight: Altura máxima del sello de salida.
• MinWidth: Ancho mínimo del sello de salida.
• MinHeight: Altura mínima del sello de salida.
• Hyperlink: Agrega un hipervínculo al hacer clic a los elementos estampados. Nota: Los enlaces HTML (etiquetas a) no se conservan al estamparlos.
• Scale: Aplica escala de porcentaje a los sellos. Predeterminado: 100 (sin efecto).
• IsStampBehindContent: Coloca un sello detrás del contenido. El sello puede ser invisible si el contenido es opaco.
• WaitFor: Espera eventos o tiempo. Consulte el uso de WaitFor para retrasar la renderización de PDF .
• Timeout: Tiempo de espera de renderizado en segundos. Predeterminado: 60.

¿Cuáles son las propiedades más utilizadas?

Opacity y IsStampBehindContent crean marcas de agua. Scale y Rotation ajustan el posicionamiento y el tamaño visual. Ejemplo:

// Create a semi-transparent watermark behind content
TextStamper watermark = new TextStamper()
{
    Text = "CONFIDENTIAL",
    FontSize = 60,
    FontColorCode = "#CCCCCC",
    Opacity = 25,
    Rotation = -45,
    IsStampBehindContent = true,
    VerticalAlignment = VerticalAlignment.Middle,
    HorizontalAlignment = HorizontalAlignment.Center
};

// Create a semi-transparent watermark behind content
TextStamper watermark = new TextStamper()
{
    Text = "CONFIDENTIAL",
    FontSize = 60,
    FontColorCode = "#CCCCCC",
    Opacity = 25,
    Rotation = -45,
    IsStampBehindContent = true,
    VerticalAlignment = VerticalAlignment.Middle,
    HorizontalAlignment = HorizontalAlignment.Center
};