Como deletar páginas de um PDF em Java

Como deletar um intervalo de páginas de um PDF?

O método removePages(PageSelection) exclui todas as páginas cobertas pela seleção fornecida em uma única operação atômica, o que evita o problema de deslocamento de índice que surge ao chamar removePage várias vezes. Use PageSelection.pageRange(int fromIndex, int toIndex) para especificar o intervalo -- ambos os pontos finais são inclusivos e começam em zero.

O exemplo abaixo remove as páginas 3, 4 e 5 de um documento passando fromIndex = 2 e toIndex = 4. Como todas as três páginas são removidas de uma vez, não ocorre deslocamento intermediário de índice durante a operação.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-delete-pdf-pages-tutorial/page-range.java
import java.io.IOException;
import java.nio.file.Path;
import IronPDF;
import IronPDF;
import com.ironsoftware.ironpdf.edit.PageSelection;

public class Main {
    public static void main(String[] args) throws IOException {
        // Defina a chave de licença antes de chamar qualquer método do IronPDF
        License.setLicenseKey("IronPDF-MYLICENSE-KEY-1EF01");

        // Load a multi-page PDF from disk
        PdfDocument pdf = PdfDocument.fromFile(Path.of("annual-report.pdf"));

        // Remove pages 3, 4, and 5 using a zero-based inclusive range (indexes 2 to 4)
        pdf.removePages(PageSelection.pageRange(2, 4));

        // Save the result to a new file
        pdf.saveAs(Path.of("annual-report-trimmed.pdf"));
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-delete-pdf-pages-tutorial/page-range.java
import java.io.IOException;
import java.nio.file.Path;
import IronPDF;
import IronPDF;
import com.ironsoftware.ironpdf.edit.PageSelection;

public class Main {
    public static void main(String[] args) throws IOException {
        // Defina a chave de licença antes de chamar qualquer método do IronPDF
        License.setLicenseKey("IronPDF-MYLICENSE-KEY-1EF01");

        // Load a multi-page PDF from disk
        PdfDocument pdf = PdfDocument.fromFile(Path.of("annual-report.pdf"));

        // Remove pages 3, 4, and 5 using a zero-based inclusive range (indexes 2 to 4)
        pdf.removePages(PageSelection.pageRange(2, 4));

        // Save the result to a new file
        pdf.saveAs(Path.of("annual-report-trimmed.pdf"));
    }
}

PageSelection.pageRange é a abordagem preferida sempre que você precisar remover um bloco de páginas adjacentes. É mais limpo e eficiente do que percorrer chamadas individuais de removePage, e a semântica de operação única significa que a contagem de páginas é atualizada apenas uma vez.

Como deletar múltiplas páginas não consecutivas?

Quando você precisa remover páginas que não são adjacentes umas às outras, você tem duas opções práticas: usar removePages com um PageSelection que tenha como alvo índices individuais, ou chamar removePage várias vezes em uma sequência cuidadosamente ordenada.

Se você chamar removePage várias vezes, sempre trabalhe do índice mais alto para o mais baixo. Remover uma página com índice mais baixo primeiro desloca todos os índices mais altos para baixo em uma posição, o que faz com que as chamadas subsequentes apontem para as páginas erradas. Começando pelo final do documento e trabalhando de forma regressiva, cada remoção deixa os índices restantes mais baixos inalterados.

O exemplo abaixo remove a primeira página, uma página do meio, e a última página de um documento de seis páginas. As chamadas são ordenadas do índice mais alto para o mais baixo -- 5, 3, 0 -- para evitar desvio de índice.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-delete-pdf-pages-tutorial/non-consecutive-pages.java
import java.io.IOException;
import java.nio.file.Path;
import IronPDF;
import IronPDF;

public class Main {
    public static void main(String[] args) throws IOException {
        // Defina a chave de licença antes de chamar qualquer método do IronPDF
        License.setLicenseKey("IronPDF-MYLICENSE-KEY-1EF01");

        // Load a six-page PDF from disk
        PdfDocument pdf = PdfDocument.fromFile(Path.of("contract.pdf"));

        // Remove non-consecutive pages: always work from highest index to lowest
        // to prevent index shifting from affecting subsequent removals.

        // Remove the last page (index 5 in a six-page document)
        pdf.removePage(5);

        // Remove a page in the middle (index 3 -- now safe because no lower index has shifted)
        pdf.removePage(3);

        // Remove the first page (index 0 -- lowest, so processed last)
        pdf.removePage(0);

        // Save the modified PDF
        pdf.saveAs(Path.of("contract-redacted.pdf"));
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-delete-pdf-pages-tutorial/non-consecutive-pages.java
import java.io.IOException;
import java.nio.file.Path;
import IronPDF;
import IronPDF;

public class Main {
    public static void main(String[] args) throws IOException {
        // Defina a chave de licença antes de chamar qualquer método do IronPDF
        License.setLicenseKey("IronPDF-MYLICENSE-KEY-1EF01");

        // Load a six-page PDF from disk
        PdfDocument pdf = PdfDocument.fromFile(Path.of("contract.pdf"));

        // Remove non-consecutive pages: always work from highest index to lowest
        // to prevent index shifting from affecting subsequent removals.

        // Remove the last page (index 5 in a six-page document)
        pdf.removePage(5);

        // Remove a page in the middle (index 3 -- now safe because no lower index has shifted)
        pdf.removePage(3);

        // Remove the first page (index 0 -- lowest, so processed last)
        pdf.removePage(0);

        // Save the modified PDF
        pdf.saveAs(Path.of("contract-redacted.pdf"));
    }
}

Se o conjunto de páginas a remover for determinado dinamicamente, um padrão conciso é ordenar sua lista de índices em ordem reversa e fazer um laço:

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-delete-pdf-pages-tutorial/dynamic-removal.java
import java.io.IOException;
import java.nio.file.Path;
import java.util.Arrays;
import java.util.Comparator;
import java.util.List;
import IronPDF;
import IronPDF;

public class Main {
    public static void main(String[] args) throws IOException {
        // Defina a chave de licença antes de chamar qualquer método do IronPDF
        License.setLicenseKey("IronPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF from disk
        PdfDocument pdf = PdfDocument.fromFile(Path.of("document.pdf"));

        // Define the zero-based page indexes to remove
        List<Integer> pagesToRemove = Arrays.asList(0, 3, 5);

        // Sort descending to avoid index-shift errors during sequential removal
        pagesToRemove.sort(Comparator.reverseOrder());

        // Remove each page in reverse-index order
        for (int pageIndex : pagesToRemove) {
            pdf.removePage(pageIndex);
        }

        // Save the modified PDF
        pdf.saveAs(Path.of("document-pages-removed.pdf"));
    }
}

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-delete-pdf-pages-tutorial/dynamic-removal.java
import java.io.IOException;
import java.nio.file.Path;
import java.util.Arrays;
import java.util.Comparator;
import java.util.List;
import IronPDF;
import IronPDF;

public class Main {
    public static void main(String[] args) throws IOException {
        // Defina a chave de licença antes de chamar qualquer método do IronPDF
        License.setLicenseKey("IronPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF from disk
        PdfDocument pdf = PdfDocument.fromFile(Path.of("document.pdf"));

        // Define the zero-based page indexes to remove
        List<Integer> pagesToRemove = Arrays.asList(0, 3, 5);

        // Sort descending to avoid index-shift errors during sequential removal
        pagesToRemove.sort(Comparator.reverseOrder());

        // Remove each page in reverse-index order
        for (int pageIndex : pagesToRemove) {
            pdf.removePage(pageIndex);
        }

        // Save the modified PDF
        pdf.saveAs(Path.of("document-pages-removed.pdf"));
    }
}

Ordenar a lista de índices em ordem decrescente antes do loop é um padrão seguro e de uso geral que funciona independentemente do número de páginas com as quais se está lidando ou de como a lista de entrada está ordenada.

Quais são os próximos passos para deletar páginas de PDF em Java?

Os métodos removePage e removePages do IronPDF oferecem controle preciso sobre a exclusão de páginas — seja para remover uma única página, excluir um intervalo ou remover um conjunto disperso de páginas. O modelo de indexação zero-based é consistente em toda a API Java do IronPDF, então as mesmas convenções se aplicam quando você segue para divisão, mesclagem ou reordenação de páginas.

Para continuar trabalhando com a estrutura de páginas de PDF e manipulação de documentos, explore esses recursos relacionados:

• Divida PDFs em Java: extraia páginas específicas ou intervalos de páginas em arquivos PDF separados
• Mescle PDFs em Java: combine múltiplos documentos em um único PDF com controle total de páginas
• Comprimir PDFs em Java: reduza o tamanho do arquivo após remover páginas para otimizar a saída para distribuição
• Estruturas de navegação e marcadores em Java: gerencie estruturas de navegação que podem referenciar as páginas que você removeu
• Exemplos de IronPDF for Java: amostras de código para copiar e colar para toda a API Java do IronPDF

Comece seu teste gratuito para remover páginas de PDFs em seu fluxo de trabalho Java. Para adquirir uma licença para uso em produção, veja as opções de licenciamento.