1. IronPDF
  2. Tutoriais
  3. Fundos e primeiros planos

Como adicionar fundo e sobrepor primeiro plano em PDFs usando Java

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

O IronPDF for Java fornece métodos addBackgroundPdf e addForegroundPdf que colocam conteúdo adicional em PDF tanto atrás quanto acima de páginas existentes. Esses métodos cobrem todo o espectro de cenários práticos de sobreposição: cabeçalhos de carta, preenchimentos de cor, marcas d'água, carimbos de aprovação e indicadores de revisão. A biblioteca renderiza HTML para PDF internamente, então qualquer expressão CSS válida (gradientes, imagens, tipografia) pode se tornar uma camada de fundo ou de primeiro plano sem manipulação manual de fluxo PDF.

Adicione o IronPDF ao seu projeto declarando a dependência em pom.xml via Maven Central, em seguida ative sua chave de licença antes de fazer quaisquer chamadas de API.

Início rápido: Adicionar plano de fundo e primeiro plano a PDFs

 :title=Quickstart
//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/quickstart.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.nio.file.Paths;

// Load the target PDF
PdfDocument pdf = PdfDocument.fromFile(Paths.get("document.pdf"));

// Render a background from HTML and apply it to all pages
PdfDocument background = PdfDocument.renderHtmlAsPdf("<body style='background-color: #f0f0f0;'></body>");
pdf.addBackgroundPdf(background);

// Render a foreground overlay and apply it to all pages
PdfDocument foreground = PdfDocument.renderHtmlAsPdf("<h1 style='opacity: 0.3;'>DRAFT</h1>");
pdf.addForegroundPdf(foreground);

pdf.saveAs(Paths.get("output.pdf"));
 :title=Quickstart
//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/quickstart.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.nio.file.Paths;

// Load the target PDF
PdfDocument pdf = PdfDocument.fromFile(Paths.get("document.pdf"));

// Render a background from HTML and apply it to all pages
PdfDocument background = PdfDocument.renderHtmlAsPdf("<body style='background-color: #f0f0f0;'></body>");
pdf.addBackgroundPdf(background);

// Render a foreground overlay and apply it to all pages
PdfDocument foreground = PdfDocument.renderHtmlAsPdf("<h1 style='opacity: 0.3;'>DRAFT</h1>");
pdf.addForegroundPdf(foreground);

pdf.saveAs(Paths.get("output.pdf"));
JAVA

Fluxo de trabalho mínimo (5 etapas)

  1. Instale a biblioteca Java IronPDF via Maven
  2. Carregue o PDF alvo com PdfDocument.fromFile()
  3. Renderize ou importe o PDF de fundo ou de primeiro plano
  4. Chame addBackgroundPdf para camada de conteúdo atrás das páginas existentes
  5. Chame addForegroundPdf para sobrepor conteúdo no topo das páginas existentes

Como Adicionar um Fundo a um PDF?

Para adicionar um fundo a um PDF existente, chame addBackgroundPdf em uma instância de PdfDocument e passe uma segunda PdfDocument como a fonte do fundo. O método compõe o fundo abaixo de cada página do documento alvo. Antes de executar o código, configure o IronPDF com sua chave de licença para ativar a biblioteca.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-background.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import java.nio.file.Paths;

// Activate the license
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// Load the target PDF
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Render a background from an HTML color definition
PdfDocument background = PdfDocument.renderHtmlAsPdf("<body style='background-color: cyan;'></body>");

// Apply the background to all pages
pdf.addBackgroundPdf(background);

pdf.saveAs(Paths.get("addBackground.pdf"));
//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-background.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import java.nio.file.Paths;

// Activate the license
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// Load the target PDF
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Render a background from an HTML color definition
PdfDocument background = PdfDocument.renderHtmlAsPdf("<body style='background-color: cyan;'></body>");

// Apply the background to all pages
pdf.addBackgroundPdf(background);

pdf.saveAs(Paths.get("addBackground.pdf"));
JAVA

A chamada renderHtmlAsPdf converte qualquer HTML e CSS válido em uma página PDF que o IronPDF compõe atrás do seu conteúdo existente. Você pode usar estilização CSS personalizada no tutorial HTML para PDF para produzir preenchimentos de gradiente, padrões repetitivos ou fundos baseados em imagem. O engine de renderização HTML processa propriedades CSS modernas, então designs que funcionam em um navegador são traduzidos diretamente para a camada de fundo.

PontasUse padding:0;'> em seu template de fundo HTML para eliminar margens padrão do navegador e garantir que a cor ou imagem preencha a página inteira.

Como é o PDF de Saída do Fundo?

Por que Usar HTML para Criar Fundos de PDF?

Adicionar um fundo posiciona uma imagem ou página de documento atrás de conteúdo existente, permitindo cabeçalhos de carta, preenchimentos de cor, marcas d'água e elementos de design decorativos. Sobrepor um primeiro plano posiciona o conteúdo no topo, tornando-o útil para anotações, carimbos e indicadores de aprovação.

A abordagem baseada em HTML oferece várias vantagens concretas sobre importações de imagem:

  • Controle preciso de CSS: Use qualquer cor, gradiente, imagem ou layout CSS para definir o design do fundo.
  • Adaptabilidade ao tamanho de página: Fundos renderizados a partir de HTML se ajustam automaticamente para corresponder às dimensões das páginas do PDF alvo.
  • Geração dinâmica: Construa fundos programaticamente a partir de dados, preferências do usuário ou lógica de templates.
  • Saída leve: Fundos definidos em CSS são menores que as imagens rasterizadas com qualidade visual equivalente.

Esta funcionalidade é adequada para criar formulários com cabeçalhos de empresa ou adicionar marcas d'água personalizadas a documentos legais e financeiros.

Como Adicionar um Fundo a Páginas Específicas?

O método addBackgroundPdf aceita um argumento opcional PageSelection que limita a operação às páginas que você especificar. Use PageSelection.firstPage(), PageSelection.lastPage(), PageSelection.singlePage(int index), ou PageSelection.pageRange(int start, int end) para segmentar qualquer subconjunto de páginas. Documentação completa PageSelection está disponível na Referência da API IronPDF for Java.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-background-specific-page.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.nio.file.Paths;

// Load the target PDF
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Load a background from an existing PDF file
PdfDocument background = PdfDocument.fromFile(Paths.get("background.pdf"));

// Apply only the first page of the background PDF to the first page of the target
pdf.addBackgroundPdf(background, 0, PageSelection.firstPage());

pdf.saveAs(Paths.get("addBackgroundToSpecificPage.pdf"));
//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-background-specific-page.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.nio.file.Paths;

// Load the target PDF
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Load a background from an existing PDF file
PdfDocument background = PdfDocument.fromFile(Paths.get("background.pdf"));

// Apply only the first page of the background PDF to the first page of the target
pdf.addBackgroundPdf(background, 0, PageSelection.firstPage());

pdf.saveAs(Paths.get("addBackgroundToSpecificPage.pdf"));
JAVA

O segundo argumento (0) é o backgroundPdfPageIndex, um índice baseado em zero que seleciona qual página do PDF de fundo usar como fonte. Quando seu template de fundo contém múltiplos designs de página, este parâmetro permite aplicar diferentes designs a diferentes seções do documento alvo. Combine fundos seletivos com exemplos de divisão e mesclagem de PDF para construir fluxos de trabalho de montagem de documentos em várias etapas.

Quando Você Deveria Aplicar Fundos a Páginas Específicas?

A aplicação seletiva de fundos abrange uma gama de cenários comuns de documentos:

  • Páginas de capa: Marque a primeira página com um design de sangria total enquanto mantém as páginas do corpo limpas.
  • Divisores de capítulos: Aplique fundos de seção à primeira página de cada capítulo.
  • Autenticação legal: Adicione um cabeçalho oficial apenas às páginas que requerem certificação formal.
  • Seções confidenciais: Tinte ou marque páginas específicas para indicar conteúdo restrito.
  • Layouts prontos para impressão: Aplique fundos seguros para sangria em páginas destinadas à impressão física.

Após aplicar imagens de fundo de alta resolução, considere comprimir o PDF de saída para manter os tamanhos de arquivo gerenciáveis para distribuição ou arquivamento.

Icon Quote related to Quando Você Deveria Aplicar Fundos a Páginas Específicas?

Minha biblioteca favorita desse tipo é o IronPDF. Ele permite a manipulação rápida e eficiente de arquivos PDF. Além disso, possui muitos recursos valiosos, como a exportação para o formato PDF/A e a assinatura digital de documentos PDF.

Milan Jovanovic related to Quando Você Deveria Aplicar Fundos a Páginas Específicas?

Milan Jovanovic

Microsoft MVP

Veja o estudo de caso
Icon Quote related to Quando Você Deveria Aplicar Fundos a Páginas Específicas?

Com o IronOCR, podemos economizar US$ 40.000 por ano em processamento manual, ao mesmo tempo que aumentamos a produtividade e liberamos recursos para tarefas de alto impacto. Eu o recomendo fortemente.

Brent Matzelle related to Quando Você Deveria Aplicar Fundos a Páginas Específicas?

Brent Matzelle

Diretor de Tecnologia, OPYN

Veja o estudo de caso
Icon Quote related to Quando Você Deveria Aplicar Fundos a Páginas Específicas?

O IronSuite desempenha um papel crucial nas nossas operações. Estas são ferramentas que aumentam a eficiência no negócio, incluindo a criação de plantas baixas e melhoria na gestão de inventário.

David Jones related to Quando Você Deveria Aplicar Fundos a Páginas Específicas?

David Jones

Engenheiro(a) de Software Líder, Agorus Build

Veja o estudo de caso

Como Adicionar uma Sobreposição de Primeiro Plano a um PDF?

O método addForegroundPdf compõe uma camada PDF sobre o conteúdo da página existente. O primeiro plano renderizado aparece acima de todo o texto, imagens e gráficos existentes em cada página de destino. Este método é a abordagem padrão para marcas d'água, carimbos de aprovação e indicadores de revisão que devem permanecer visíveis independentemente do conteúdo subjacente. Para exemplos de código funcionando, veja os exemplos de Java de fundos e primeiros planos.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-foreground.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import java.nio.file.Paths;

// Activate the license
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// Load the target PDF
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Render a diagonal text stamp as the foreground layer
PdfDocument foreground = PdfDocument.renderHtmlAsPdf(
    "<h1 style='transform: rotate(-45deg); opacity: 0.5;'>Foreground Example</h1>"
);

// Apply the foreground to all pages
pdf.addForegroundPdf(foreground);

pdf.saveAs(Paths.get("overlayForeground.pdf"));
//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-foreground.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import java.nio.file.Paths;

// Activate the license
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// Load the target PDF
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Render a diagonal text stamp as the foreground layer
PdfDocument foreground = PdfDocument.renderHtmlAsPdf(
    "<h1 style='transform: rotate(-45deg); opacity: 0.5;'>Foreground Example</h1>"
);

// Apply the foreground to all pages
pdf.addForegroundPdf(foreground);

pdf.saveAs(Paths.get("overlayForeground.pdf"));
JAVA

A propriedade CSS opacity controla a transparência para que o carimbo de primeiro plano não obscureça completamente o conteúdo subjacente. A propriedade transform: rotate() aplica orientação diagonal, que é padrão para marcas-d'água provisórias e confidenciais. A biblioteca trata toda a composição internamente; não é necessário manipulação manual de fluxo de PDF.

ObserveO renderização de primeiro plano usa o mesmo motor HTML-para-PDF como renderHtmlAsPdf. Qualquer CSS que funcione em um navegador moderno (incluindo @font-face, flexbox e variáveis CSS) produzirá saída idêntica na camada de primeiro plano.

Qual é a aparência da saída em primeiro plano?

Por que usar sobreposições em primeiro plano em vez de planos de fundo?

Sobreposições de primeiro plano têm um papel diferente dos fundos e são a escolha correta quando o conteúdo adicionado deve aparecer sobre o material existente da página:

  • Carimbos de rascunho e confidencial: Coloque texto proeminente, mas transparente, através das páginas sem remover o conteúdo existente.
  • Anotações de aprovação e revisão: Sobreponha indicadores de aprovação ou notas do revisor em documentos concluídos.
  • Identificadores de segurança: Adicione códigos de rastreamento ou identificadores de documentos únicos que fiquem acima de todo o conteúdo da página.
  • Indicadores de expiração: Marcar documentos sensíveis ao tempo com avisos visíveis que apareçam acima de tabelas de dados ou gráficos.
  • Marcas de certificação: Aplique logos ou selos sobre o conteúdo finalizado de forma que não possam ser cobertos por elementos de página existentes.

Sobreposições de primeiro plano funcionam bem com preenchimento de formulário em PDF em Java quando você precisa colocar indicadores de status ou carimbos de aprovação sobre dados de formulário concluídos.

Como Adicionar um Primeiro Plano a Páginas Específicas?

O método addForegroundPdf aceita um argumento PageSelection da mesma forma que addBackgroundPdf. Use PageSelection.pageRange(int start, int end) para limitar o primeiro plano a um intervalo contíguo, ou passe um List<Integer> para segmentar páginas não sequenciais.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-foreground-page-range.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.nio.file.Paths;

// Load the target PDF
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Render the foreground overlay
PdfDocument foreground = PdfDocument.renderHtmlAsPdf(
    "<h1 style='transform: rotate(-45deg); opacity: 0.5;'>Foreground Example</h1>"
);

// Apply the foreground to pages 2 through 8 (zero-based index: 1 to 7)
pdf.addForegroundPdf(foreground, PageSelection.pageRange(2, 8));

pdf.saveAs(Paths.get("overlayForeground.pdf"));
//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-foreground-page-range.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.nio.file.Paths;

// Load the target PDF
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Render the foreground overlay
PdfDocument foreground = PdfDocument.renderHtmlAsPdf(
    "<h1 style='transform: rotate(-45deg); opacity: 0.5;'>Foreground Example</h1>"
);

// Apply the foreground to pages 2 through 8 (zero-based index: 1 to 7)
pdf.addForegroundPdf(foreground, PageSelection.pageRange(2, 8));

pdf.saveAs(Paths.get("overlayForeground.pdf"));
JAVA

ImportanteO índice pageRange é baseado em um em algumas sobrecargas e baseado em zero em outras, dependendo de qual sobrecarga você chamar. Verifique a Referência de API Java do IronPDF para a assinatura específica de sobrecarga para confirmar a convenção de indexação na sua versão.

Quando Devo Usar Intervalos de Página para Primeiros Planos?

A aplicação de primeiro plano por página é útil em vários cenários de produção:

  • Seções de documento: Carimbe uma sobreposição de "RASCUNHO" apenas no apêndice ou nas páginas suplementares.
  • Rastreamento de versão: Marque as páginas atualizadas com um carimbo de revisão enquanto deixa as páginas inalteradas.
  • Confidencialidade seletiva: Aplique uma sobreposição "RESTRITO" apenas nas páginas que contêm dados financeiros ou médicos sensíveis.
  • Documentos multilíngues: Coloque avisos específicos de idioma nas páginas relevantes de um documento bilíngue.
  • Gerenciamento de contratos: Adicione uma sobreposição "NULO" às páginas de contratos expirados sem modificar o documento completo.

Quais São os Padrões Comuns de Seleção de Página?

Os seguintes padrões cobrem a maioria dos cenários de sobreposição seletiva:

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/page-selection-patterns.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.util.ArrayList;
import java.util.List;
import java.nio.file.Paths;

PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));
PdfDocument foreground = PdfDocument.renderHtmlAsPdf("<h1 style='opacity: 0.4;'>DRAFT</h1>");
PdfDocument background1 = PdfDocument.fromFile(Paths.get("cover-background.pdf"));
PdfDocument background2 = PdfDocument.fromFile(Paths.get("end-background.pdf"));

// Apply foreground to all even-numbered pages (zero-based)
List<Integer> evenPages = new ArrayList<>();
for (int i = 1; i < pdf.getPageCount(); i += 2) {
    evenPages.add(i);
}
pdf.addForegroundPdf(foreground, PageSelection.pageRange(evenPages));

// Apply different backgrounds to the first and last pages
pdf.addBackgroundPdf(background1, 0, PageSelection.firstPage());
pdf.addBackgroundPdf(background2, 0, PageSelection.lastPage());

// Apply foreground to all pages except the first and last
if (pdf.getPageCount() > 2) {
    pdf.addForegroundPdf(foreground, PageSelection.pageRange(1, pdf.getPageCount() - 2));
}

pdf.saveAs(Paths.get("selective-overlay.pdf"));
//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/page-selection-patterns.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.util.ArrayList;
import java.util.List;
import java.nio.file.Paths;

PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));
PdfDocument foreground = PdfDocument.renderHtmlAsPdf("<h1 style='opacity: 0.4;'>DRAFT</h1>");
PdfDocument background1 = PdfDocument.fromFile(Paths.get("cover-background.pdf"));
PdfDocument background2 = PdfDocument.fromFile(Paths.get("end-background.pdf"));

// Apply foreground to all even-numbered pages (zero-based)
List<Integer> evenPages = new ArrayList<>();
for (int i = 1; i < pdf.getPageCount(); i += 2) {
    evenPages.add(i);
}
pdf.addForegroundPdf(foreground, PageSelection.pageRange(evenPages));

// Apply different backgrounds to the first and last pages
pdf.addBackgroundPdf(background1, 0, PageSelection.firstPage());
pdf.addBackgroundPdf(background2, 0, PageSelection.lastPage());

// Apply foreground to all pages except the first and last
if (pdf.getPageCount() > 2) {
    pdf.addForegroundPdf(foreground, PageSelection.pageRange(1, pdf.getPageCount() - 2));
}

pdf.saveAs(Paths.get("selective-overlay.pdf"));
JAVA

PontasEncadeie múltiplas chamadas addBackgroundPdf e addForegroundPdf no mesmo PdfDocument para construir modelos em camadas. Por exemplo, aplique uma cor de marca como fundo e depois adicione um carimbo de confidencialidade como primeiro plano em um único pipeline.

Quais Métodos a Classe PageSelection Fornece?

A classe PageSelection controla quais páginas recebem as camadas de fundo ou primeiro plano. Todos os métodos de fábrica embutidos retornam um objeto PageSelection aceito por ambos addBackgroundPdf e addForegroundPdf.

Métodos de fábrica PageSelection para direcionar páginas específicas em addBackgroundPdf e addForegroundPdf
MétodoDescrição
firstPage()Alveja a primeira página do PDF
lastPage()Alveja a última página do PDF
singlePage(int index)Alveja uma página pelo índice baseado em zero
pageRange(int start, int end)Alveja um intervalo de páginas contínuo (inclusivo)
pageRange(List<Integer> pageList)Alveja uma lista de páginas não sequenciais
allPages()Alveja todas as páginas (padrão quando nenhuma seleção é passada)

Como Você Escolhe o Método PageSelection Certo?

A escolha do método depende da estrutura do documento e da extensão da sobreposição:

  • firstPage(): Páginas de capa, páginas de título e elementos de design introdutórios.
  • lastPage(): Blocos de assinatura, avisos de fim de documento e resumos de encerramento.
  • singlePage(): Certificados, formulários ou páginas individuais que requerem tratamento específico.
  • pageRange(start, end): Capítulos, apêndices ou qualquer seção de documento contínua.
  • pageRange(List): Seleções não sequenciais, como todas as páginas ímpares ou um conjunto especificado manualmente.

Para documentação completa dos parâmetros e assinaturas de sobrecarga de métodos, consulte a Referência de API Java do IronPDF.

Quais São os Próximos Passos para Adicionar Fundos e Primeiros Planos a PDFs?

Os métodos addBackgroundPdf e addForegroundPdf cobrem todo o espectro de cenários de sobreposição de PDF, desde preenchimentos de cor simples e marcas-d'água até fluxos de trabalho de montagem de documentos com múltiplos modelos. Combine-os com PageSelection para aplicar designs diferentes por seção, ou encadeie-os com outros métodos PdfDocument para construir pipelines de documentos prontos para produção. Para técnicas adicionais de sobreposição, como carimbos de texto e imagem, explore o guia de carimbos de texto e imagem ou exemplos de anotações para Java.

Para usar essas funções em seu projeto, comece um teste gratuito do IronPDF for Java ou veja as opções de licenciamento para implantação comercial. IronPDF está disponível via Maven Central e suporta Java 8 e versões posteriores no Windows, Linux e macOS.

Pronto para ver o que mais o IronPDF pode fazer? Explore o completo tutorial HTML para PDF for Java para um guia completo de renderização, manipulação e opções de exportação.

Perguntas frequentes

Como adiciono um fundo a um PDF existente em Java?

Carregar o PDF alvo com PdfDocument.fromFile(), criar um PDF de fundo usando PdfDocument.renderHtmlAsPdf() com seu HTML/CSS, então chame pdf.addBackgroundPdf(background) para compô-lo atrás de todas as páginas. Ative a biblioteca primeiro com License.setLicenseKey().

Qual é a diferença entre addBackgroundPdf e addForegroundPdf?

addBackgroundPdf posiciona a camada de PDF fonte atrás do conteúdo existente da página, tornando-o adequado para cabeçalhos de carta, preenchimentos de cor e modelos de design. addForegroundPdf posiciona a camada sobre o conteúdo existente, tornando-o adequado para marcas d'água, carimbos de rascunho, indicadores de aprovação e avisos de confidencialidade.

Posso aplicar um fundo ou primeiro plano apenas a páginas específicas?

Sim. Tanto addBackgroundPdf quanto addForegroundPdf aceitam um argumento opcional PageSelection. Use PageSelection.firstPage(), PageSelection.lastPage(), PageSelection.singlePage(int index), ou PageSelection.pageRange(int start, int end) para direcionar um subconjunto de páginas.

Como posso criar um fundo de PDF usando HTML e CSS?

Chame PdfDocument.renderHtmlAsPdf() e passe a sua string HTML. IronPDF suporta CSS moderno incluindo gradientes, imagens de fundo, fontes personalizadas e opacidade. A página renderizada é escalada automaticamente para coincidir com as dimensões do documento alvo.

O que o parâmetro backgroundPdfPageIndex controla?

O segundo argumento inteiro para addBackgroundPdf é o índice da página baseado em zero dentro do PDF de fundo a ser usado como fonte. Quando seu modelo de fundo tem múltiplos designs de página, passe diferentes valores de índice para aplicar diferentes designs a diferentes seções do documento alvo.

É necessário uma licença para adicionar fundos e primeiros planos no Java?

Sim. Defina uma chave de licença válida usando License.setLicenseKey() antes de qualquer chamada de API. Licenças de avaliação gratuitas estão disponíveis em ironpdf.com para avaliação. A biblioteca requer o licenciamento adequado para uso em produção.

Curtis Chau
Curtis Chau
  Converse agora mesmo com a equipe de engenharia.
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais
Pronto para começar?
Versão: 2026.6 recém-lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas?
executar um exemplo Veja seu HTML se transformar em um PDF.