Etiquetar texto e imágenes en PDF con C# e 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 es compatible con PNG, JPEG, GIF y SVG mediante referencias URI o rutas de archivo. 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 stamper. Combina 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. Por defecto: HorizontalAlignment.Center.
• AlineaciónVertical: Alineación vertical relativa a la página. Por defecto: AlineaciónVertical.Media.
• HorizontalOffset: Desplazamiento horizontal. Por defecto: 0, unidad: UnidadMedida.Porcentaje. Valores positivos desplazados a la derecha, valores negativos desplazados a la izquierda.
• VerticalOffset: Desplazamiento vertical. Por defecto: 0, unidad: UnidadMedida.Porcentaje. 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 su PDF. Las referencias externas a JavaScript, CSS e imágenes son relativas a HtmlBaseUrl.
• HtmlBaseUrl: URL base para referencias externas a archivos CSS, JavaScript e imágenes.
• CssMediaType: activa los estilos CSS Media="screen". Si se define AllowScreenCss=false, los sellos se mostrarán con CSS media="print". Por defecto: 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 sello. Ideal para marcas de agua o cabeceras de 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: Cadena de valor del código de barras.
• BarcodeType: tipo de codificación compatible con QRCode, Code128 y Code39. Predeterminado: QRCode.
• Ancho: Ancho del código de barras renderizado en píxeles. Predeterminado: 250px.
• Altura: 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?

• Opacidad: Controla la transparencia. 0 es invisible, 100 es opaco.
• Rotación: Rota 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.
• Hiperenlace: Añade hipervínculos al hacer clic en elementos estampados. Nota: Los enlaces HTML (etiquetas a) no se conservan al estamparlos.
• Escala: Aplica escala porcentual a los sellos. Predeterminado: 100 (sin efecto).
• IsStampBehindContent: Coloca el sello detrás del contenido. El sello puede ser invisible si el contenido es opaco.
• WaitFor: Espera eventos o tiempo. Véase utilizar WaitFor para retrasar el renderizado de PDF.
• Timeout: Tiempo de espera de renderizado en segundos. Predeterminado: 60.

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

Opacidad y IsStampBehindContent crean marcas de agua. Escala y Rotación ajustan el posicionamiento visual y el tamaño. 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
};