Stamp Text & Image on PDFs using C# and IronPDF

Jak wygląda plik PDF z tłumaczeniem?

Jak utworzyć stemple tekstowe z wieloma liniami?

Użyj znacznika <br> dla tekstu wieloliniowego w TextStamper. Na przykład "linia 1
linia 2" tworzy "linia 1" na pierwszej linii i "linia 2" na drugiej linii. To tworzy stemple adresowe lub znaki wodne z wieloma liniami.

Jak wygląda wynik stemplowania obrazu?

Jakie formaty obrazów są obsługiwane?

ImageStamper obsługuje PNG, JPEG, GIF i SVG poprzez URI lub ścieżki do plików. Upewnij się, że masz odpowiednie połączenie z siecią dla zdalnych obrazów. Dla środowisk Azure rozważ użycie obrazów z Azure Blob Storage.

Co się stanie, gdy stemple się pokrywają?

Czy mogę mieszać różne typy stempli?

ApplyMultipleStamps akceptuje tablice zawierające dowolne typy stemplów. Kombinuj TextStamper, ImageStamper, HTMLStamper i BarcodeStamper w jednej operacji. Twórz zaawansowane układy dokumentów z nagłówkami, stopkami, znakami wodnymi i kodami identyfikacyjnymi jednocześnie.

Jakie są kluczowe właściwości pozycjonowania?

• HorizontalAlignment: Wyrównanie poziome względem strony. Domyślne: HorizontalAlignment.Center.
• VerticalAlignment: Wyrównanie pionowe względem strony. Domyślne: VerticalAlignment.Middle.
• HorizontalOffset: Przesunięcie poziome. Domyślnie: 0, jednostka: MeasurementUnit.Percentage. Wartości dodatnie przesuwają w prawo, ujemne przesuwają w lewo.
• VerticalOffset: Przesunięcie pionowe. Domyślnie: 0, jednostka: MeasurementUnit.Percentage. Wartości dodatnie przesuwają w dół, ujemne przesuwają w górę.

Jak ustawić precyzyjne przesunięcia?

Określ HorizontalOffset i VerticalOffset za pomocą klasy Length. Domyślna jednostka miary to procent. Dostępne jednostki to cale, milimetry, centymetry, piksele i punkty. Umożliwia to precyzyjne pozycjonowanie, takie jak ustawianie niestandardowych marginesów w dokumentach PDF.

Kod

: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),
};

Imports IronPdf.Editing
Imports System

' Create text stamper
Private imageStamper As New ImageStamper(New Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg")) With {
	.HorizontalAlignment = HorizontalAlignment.Center,
	.VerticalAlignment = VerticalAlignment.Top,
	.HorizontalOffset = New Length(10),
	.VerticalOffset = New Length(10)
}

Kod

: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");

Imports IronPdf
Imports IronPdf.Editing

Private renderer As New ChromePdfRenderer()

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

' Create two text stampers
Private stamper1 As New TextStamper() With {
	.Text = "Text stamp 1",
	.VerticalAlignment = VerticalAlignment.Top,
	.HorizontalAlignment = HorizontalAlignment.Left
}

Private stamper2 As New TextStamper() With {
	.Text = "Text stamp 2",
	.VerticalAlignment = VerticalAlignment.Top,
	.HorizontalAlignment = HorizontalAlignment.Right
}

Private stampersToApply() As Stamper = { stamper1, stamper2 }

' Apply multiple stamps
pdf.ApplyMultipleStamps(stampersToApply)

pdf.SaveAs("multipleStamps.pdf")

Jakie są podstawowe właściwości stempla HTML?

• Html: Fragment HTML do wystemplowania na PDFie. Zewnętrzne odniesienia do JavaScript, CSS i obrazów są relatywne do HtmlBaseUrl.
• HtmlBaseUrl: Bazowy URL dla zewnętrznych odniesień do plików CSS, JavaScript i obrazów.
• CssMediaType: Aktywuje style CSS Media="screen". Ustawienie AllowScreenCss=false renderuje stemple za pomocą CSS media="print". Domyślne: PdfCssMediaType.Screen.

Dlaczego używać stempla HTML zamiast tekstowego?

HTMLStamper oferuje pełne wsparcie HTML i CSS dla zaawansowanych układów, wielu czcionek, kolorów i osadzonych obrazów w jednym stemplu. Idealne do bogatych treści znaków wodnych lub nagłówków. Utrzymuje spójność marki i działa z responsywnymi projektami CSS.

Kod

: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");

Imports IronPdf
Imports IronPdf.Editing

Private renderer As New ChromePdfRenderer()

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

' Create text stamper
Private textStamper As New TextStamper() With {
	.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")

Jakie opcje konfiguracji są dostępne dla kodów kreskowych?

• Value: Wartość tekstowa kodu kreskowego.
• BarcodeType: Typ kodowania obsługujący QRCode, Code128 i Code39. Domyślnie: QRCode.
• Width: Szerokość renderowanego kodu kreskowego w pikselach. Domyślnie: 250px.
• Height: Wysokość renderowanego kodu kreskowego w pikselach. Domyślnie: 250px.

Kiedy używać każdego z typów kodów kreskowych?

QRCode obsługuje adresy URL i duże zestawy danych (do 4 296 znaków alfanumerycznych). Code128 nadaje się do danych alfanumerycznych z wysokimi wymaganiami co do gęstości. Code39 działa dla prostych kombinacji cyfr lub wielkich liter. Pod uwagę weź kompatybilność sprzętu skanującego przy wyborze typów kodów kreskowych.

Jak kontrolować wygląd stempla?

• Opacity: Kontroluje przezroczystość. 0 jest niewidoczne, 100 jest nieprzezroczyste.
• Rotation: Obraca stempel zgodnie z ruchem wskazówek zegara od 0 do 360 stopni.
• MaxWidth: Maksymalna szerokość wyjściowego stempla.
• MaxHeight: Maksymalna wysokość wyjściowego stempla.
• MinWidth: Minimalna szerokość wyjściowego stempla.
• MinHeight: Minimalna wysokość wyjściowego stempla.
• Hyperlink: Dodaje łącze hypertekstowe klikane do wystemplowanych elementów. Uwaga: Łącza HTML (znaczniki a) nie są zachowywane podczas stemplowania.
• Scale: Zastosowuje skalę procentową do stempli. Domyślnie: 100 (bez efektu).
• IsStampBehindContent: Umieszcza stempel za zawartością. Stempel może być niewidoczny, jeśli zawartość jest nieprzezroczysta.
• WaitFor: Czeka na wydarzenia lub czas. Zobacz używanie WaitFor, aby opóźnić renderowanie PDFa.
• Timeout: Czas oczekiwania na renderowanie w sekundach. Domyślnie: 60.

Które właściwości są najczęściej używane?

Opacity i IsStampBehindContent tworzą znaki wodne. Scale i Rotation dostosowują wizualne pozycjonowanie i rozmiarowanie. Przykład:

// 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
};

' Create a semi-transparent watermark behind content
Dim watermark As New TextStamper() With {
    .Text = "CONFIDENTIAL",
    .FontSize = 60,
    .FontColorCode = "#CCCCCC",
    .Opacity = 25,
    .Rotation = -45,
    .IsStampBehindContent = True,
    .VerticalAlignment = VerticalAlignment.Middle,
    .HorizontalAlignment = HorizontalAlignment.Center
}