1. IronPDF
  2. Tutoriais
  3. Tamanho de papel personalizado
Como definir tamanhos de papel personalizados para PDFs usando C# | IronPDF

Como renderizar PDFs com tamanho de papel personalizado em C

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

O IronPDF permite renderizar PDFs com tamanhos de papel personalizados em C# usando a classe ChromePdfRenderer e definindo dimensões específicas por meio de métodos como SetCustomPaperSizeInInches(), permitindo um controle preciso sobre as dimensões do documento para layouts especiais, como pôsteres ou banners.

Um tamanho de papel personalizado refere-se a um tamanho de papel não padrão, definido pelo usuário, em vez de um tamanho padrão como A4 ou carta (8,5 x 11 polegadas). Tamanhos de papel personalizados são frequentemente usados ​​na impressão de documentos que exigem um layout único ou específico, como pôsteres, banners ou documentos especiais. Essa flexibilidade é essencial ao trabalhar com projetos de conversão de HTML para PDF que exigem dimensões específicas.

Descubra a vasta gama de tamanhos de papel disponíveis no IronPDF, que oferece uma ampla seleção para atender às suas necessidades!

Início rápido: Defina tamanhos de papel personalizados no IronPDF

Neste guia rápido, aprenda como definir tamanhos de papel personalizados usando o IronPDF com apenas algumas linhas de código. Com o IronPDF, você pode facilmente personalizar as dimensões do PDF definindo as medidas exatas de largura e altura em qualquer unidade de sua preferência. Essa flexibilidade é ideal para criar documentos com requisitos de layout específicos, como pôsteres ou banners. Comece baixando a biblioteca IronPDF via NuGet e siga este exemplo para definir o tamanho de papel desejado sem esforço.

  1. Instale IronPDF com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronPdf

  2. Copie e execute este trecho de código.

    var renderer = new IronPdf.ChromePdfRenderer { RenderingOptions = { PaperSize = IronPdf.Rendering.PdfPaperSize.Custom } };
renderer.RenderingOptions.SetCustomPaperSizeInInches(5, 7);
renderer.RenderHtmlAsPdf("<h1>Custom size</h1>").SaveAs("custom-size.pdf")

  3. Implante para testar em seu ambiente de produção.

    Comece a usar IronPDF em seu projeto hoje com uma avaliação gratuita

    arrow pointer

Fluxo de trabalho mínimo (5 etapas)

  1. Baixe o IronPDF do NuGet para definir tamanhos de papel personalizados em PDFs.
  2. Instancie a classe ChromePdfRenderer em C#
  3. Acesse as opções de renderização no novo objeto.
  4. Invoque um dos métodos `SetCustomPaperSize` com base na unidade de medida.
  5. Renderize e exporte o documento PDF.


Como usar tamanhos de papel padrão?

Primeiro, crie uma instância da classe ChromePdfRenderer. Em seguida, use a propriedade RenderingOptions do objeto recém-criado para modificar o PaperSize. Defina um dos valores predefinidos da enumeração PdfPaperSize para especificar o tamanho de papel desejado. Oferecemos mais de 100 tamanhos de papel padrão predefinidos para sua conveniência.

Ao trabalhar com opções de renderização de PDF , o IronPDF oferece controle abrangente sobre a formatação dos seus documentos. Os tamanhos de papel padrão incluem formatos comumente usados, como A4, Carta, Ofício e muitos padrões internacionais.

Quais são os tamanhos de papel padrão disponíveis?

Abaixo segue um exemplo de como definir um tamanho de papel padrão:

:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-standard-paper-size.cs
using IronPdf;
using IronPdf.Rendering;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set paper size to A4
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Standard Paper Size</h1>");

pdf.SaveAs("standardPaperSize.pdf");
Imports IronPdf
Imports IronPdf.Rendering

Private renderer As New ChromePdfRenderer()

' Set paper size to A4
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Standard Paper Size</h1>")

pdf.SaveAs("standardPaperSize.pdf")
$vbLabelText   $csharpLabel

O IronPDF suporta uma ampla variedade de tamanhos de papel padrão, incluindo:

  • Série ISO 216 : A0 a A10, B0 a B10
  • América do Norte : Carta, Jurídico, Tablóide, Executivo
  • Arquitetura : ANSI A a E
  • Japonês : JIS B0 a B10
  • Tamanhos de envelopes : Vários padrões internacionais de envelopes

Para obter uma lista completa dos tamanhos de papel disponíveis e suas dimensões, consulte a documentação de referência da API .

Quais propriedades controlam o tamanho do papel?

  • PaperSize: Defina um tamanho de papel de saída para páginas PDF com tamanhos predefinidos, como carta, A3, A4, etc.
  • ForcePaperSize: Força os tamanhos de página a serem exatamente o que é especificado por meio de IronPdf.ChromePdfRenderOptions.PaperSize redimensionando a página após gerar um PDF a partir de HTML. Essa funcionalidade é útil para contornar regras CSS que especificam o tamanho do papel.

Ao usar essas propriedades em conjunto com margens personalizadas , você pode obter um controle preciso sobre o layout do seu PDF.

Como faço para obter tamanhos de papel padrão em unidades diferentes?

Precisa encontrar as dimensões de tamanhos de papel padrão? Você pode fazer isso facilmente usando o método ToMillimeters. Este método retorna uma tupla contendo a largura e a altura do tamanho de papel padrão como objetos Length. A classe Length é incrivelmente versátil, permitindo que você converta facilmente essas dimensões em uma variedade de unidades, incluindo:

  • Milímetros
  • Centímetros
  • Polegadas
  • Pixels
  • Pontos
:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-standard-paper-size-in-other-unit.cs
using IronPdf.Rendering;

double A4WidthInPixel = PdfPaperSize.A4.ToMillimeters().width.ToPixel();
double A4HeightInCentimeter = PdfPaperSize.A4.ToMillimeters().height.ToCentimeter();
Imports IronPdf.Rendering

Private A4WidthInPixel As Double = PdfPaperSize.A4.ToMillimeters().width.ToPixel()
Private A4HeightInCentimeter As Double = PdfPaperSize.A4.ToMillimeters().height.ToCentimeter()
$vbLabelText   $csharpLabel

Essa funcionalidade é particularmente útil ao integrar com layouts responsivos em CSS ou quando você precisa calcular as dimensões exatas para layouts personalizados.

Como faço para criar tamanhos de papel personalizados?

Primeiro, começamos instanciando a classe ChromePdfRenderer. A partir do objeto recém-criado, podemos acessar o RenderingOptions para aplicar um tamanho de papel personalizado ao documento PDF recém-gerado. Existem quatro métodos que podem ser usados ​​para definir o tamanho do papel de saída para páginas PDF, cada um baseado em uma unidade de medida diferente:

  • SetCustomPaperSizeInCentimeters: As dimensões estão em centimeters.
  • SetCustomPaperSizeInInches: As dimensões estão em inches.
  • SetCustomPaperSizeInMillimeters: As dimensões estão em millimeters.
  • SetCustomPaperSizeInPixelsOrPoints: As dimensões estão em pixels or points.

Ao criar tamanhos de papel personalizados, é importante considerar como eles irão interagir com cabeçalhos e rodapés, bem como com as configurações de orientação da página .

Que unidades posso usar para dimensões personalizadas?

Abaixo, segue um exemplo de como definir um tamanho de papel personalizado em centímetros:

:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-cm.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set custom paper size in cm
renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(15, 15);

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Custom Paper Size</h1>");

pdf.SaveAs("customPaperSize.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Set custom paper size in cm
renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(15, 15)

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Custom Paper Size</h1>")

pdf.SaveAs("customPaperSize.pdf")
$vbLabelText   $csharpLabel

Seguem exemplos adicionais para cada unidade de medida:

// Example: Custom paper size in inches (for US letter-like custom size)
renderer.RenderingOptions.SetCustomPaperSizeInInches(8.5, 11.5);

// Example: Custom paper size in millimeters (for precise metric measurements)
renderer.RenderingOptions.SetCustomPaperSizeInMillimeters(297, 420); // A3 size

// Example: Custom paper size in pixels (useful for screen-based layouts)
renderer.RenderingOptions.SetCustomPaperSizeInPixelsOrPoints(1024, 768, 96); // 96 DPI
// Example: Custom paper size in inches (for US letter-like custom size)
renderer.RenderingOptions.SetCustomPaperSizeInInches(8.5, 11.5);

// Example: Custom paper size in millimeters (for precise metric measurements)
renderer.RenderingOptions.SetCustomPaperSizeInMillimeters(297, 420); // A3 size

// Example: Custom paper size in pixels (useful for screen-based layouts)
renderer.RenderingOptions.SetCustomPaperSizeInPixelsOrPoints(1024, 768, 96); // 96 DPI
' Example: Custom paper size in inches (for US letter-like custom size)
renderer.RenderingOptions.SetCustomPaperSizeInInches(8.5, 11.5)

' Example: Custom paper size in millimeters (for precise metric measurements)
renderer.RenderingOptions.SetCustomPaperSizeInMillimeters(297, 420) ' A3 size

' Example: Custom paper size in pixels (useful for screen-based layouts)
renderer.RenderingOptions.SetCustomPaperSizeInPixelsOrPoints(1024, 768, 96) ' 96 DPI
$vbLabelText   $csharpLabel

Ao trabalhar com tamanhos personalizados, você também pode explorar as configurações de viewport e zoom para garantir que seu conteúdo se ajuste corretamente às dimensões personalizadas.

Como posso modificar as dimensões do papel?

Em um documento PDF existente ou em um PDF recém-renderizado, o tamanho de cada página pode ser modificado usando o método ExtendPage. Este método permite especificar o índice da página de destino, os valores a serem modificados em cada um dos quatro lados e as unidades de medida. Os valores para cada lado podem ser negativos, o que reduzirá esse lado em particular, ou positivos, o que aumentará esse lado.

Essa funcionalidade é particularmente útil quando você precisa ajustar PDFs depois de criados, como ao mesclar vários PDFs com tamanhos de página diferentes ou ao preparar documentos para impressão.

Quais parâmetros o ExtendPage aceita?

O método ExtendPage aceita os seguintes parâmetros:

  • Índice da página : O índice baseado em zero da página a ser modificada.
  • Extensão Esquerda : Quantidade para estender/reduzir o lado esquerdo
  • Extensão direita : Quantidade para estender/reduzir o lado direito
  • Extensão superior : Quantidade para estender/reduzir a parte superior
  • Extensão inferior : Quantidade para estender/reduzir a lateral inferior
  • Unidade de medida : A unidade de medida (millimeters, inches, etc.)

Segue abaixo um exemplo de como modificar as dimensões do papel:

:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-modify-paper-size.cs
using IronPdf;
using IronPdf.Editing;

PdfDocument pdf = PdfDocument.FromFile("customPaperSize.pdf");

pdf.ExtendPage(0, 50, 0, 0, 0, MeasurementUnit.Millimeter);

pdf.SaveAs( "extendedLeftSide.pdf");
Imports IronPdf
Imports IronPdf.Editing

Private pdf As PdfDocument = PdfDocument.FromFile("customPaperSize.pdf")

pdf.ExtendPage(0, 50, 0, 0, 0, MeasurementUnit.Millimeter)

pdf.SaveAs("extendedLeftSide.pdf")
$vbLabelText   $csharpLabel

Aqui está um exemplo mais completo mostrando várias modificações na página:

// Extend all sides equally
pdf.ExtendPage(0, 10, 10, 10, 10, MeasurementUnit.Millimeter);

// Reduce page size (negative values)
pdf.ExtendPage(1, -20, -20, -10, -10, MeasurementUnit.Millimeter);

// Extend only top and bottom (useful for adding header/footer space)
pdf.ExtendPage(2, 0, 0, 25, 25, MeasurementUnit.Millimeter);

// Work with inches instead of millimeters
pdf.ExtendPage(3, 0.5, 0.5, 1, 1, MeasurementUnit.Inch);
// Extend all sides equally
pdf.ExtendPage(0, 10, 10, 10, 10, MeasurementUnit.Millimeter);

// Reduce page size (negative values)
pdf.ExtendPage(1, -20, -20, -10, -10, MeasurementUnit.Millimeter);

// Extend only top and bottom (useful for adding header/footer space)
pdf.ExtendPage(2, 0, 0, 25, 25, MeasurementUnit.Millimeter);

// Work with inches instead of millimeters
pdf.ExtendPage(3, 0.5, 0.5, 1, 1, MeasurementUnit.Inch);
' Extend all sides equally
pdf.ExtendPage(0, 10, 10, 10, 10, MeasurementUnit.Millimeter)

' Reduce page size (negative values)
pdf.ExtendPage(1, -20, -20, -10, -10, MeasurementUnit.Millimeter)

' Extend only top and bottom (useful for adding header/footer space)
pdf.ExtendPage(2, 0, 0, 25, 25, MeasurementUnit.Millimeter)

' Work with inches instead of millimeters
pdf.ExtendPage(3, 0.5, 0.5, 1, 1, MeasurementUnit.Inch)
$vbLabelText   $csharpLabel

Melhores práticas para tamanhos de papel personalizados

Ao trabalhar com tamanhos de papel personalizados no IronPDF, considere estas boas práticas:

  1. Teste diferentes unidades : Ao trabalhar com tamanhos personalizados, teste qual unidade de medida funciona melhor para o seu caso de uso. Pixels são ótimos para layouts em tela, enquanto milímetros ou polegadas são melhores para impressão.

  2. Considere as margens de impressão : Ao criar PDFs para impressão, lembre-se de levar em conta as margens da impressora. A maioria das impressoras não consegue imprimir até a borda do papel.

  3. Design responsivo : Ao converter HTML para PDF , certifique-se de que seu HTML utilize princípios de design responsivo para se adaptar a diferentes tamanhos de papel.

  4. Otimização de desempenho : Tamanhos de papel personalizados muito grandes podem afetar o desempenho. Considere usar compressão para documentos grandes.

  5. Compatibilidade : Teste seus PDFs de tamanho personalizado em diferentes visualizadores de PDF para garantir a compatibilidade, especialmente se estiver usando dimensões não padronizadas.

Pronto para ver o que mais você pode fazer? Confira nossa página de tutoriais aqui: Criar PDFs

Perguntas frequentes

Como faço para definir tamanhos de papel personalizados para documentos PDF em C#?

Com o IronPDF, você pode definir tamanhos de papel personalizados usando a classe ChromePdfRenderer. Basta definir a propriedade PaperSize como PdfPaperSize.Custom em RenderingOptions e, em seguida, usar métodos como SetCustomPaperSizeInInches() para definir suas dimensões específicas. Por exemplo: renderer.RenderingOptions.SetCustomPaperSizeInInches(5, 7).

Quais unidades de medida posso usar para tamanhos de papel personalizados?

O IronPDF suporta múltiplas unidades de medida para tamanhos de papel personalizados através de diferentes métodos SetCustomPaperSize. Você pode especificar dimensões em polegadas, centímetros, milímetros ou pixels, tornando-o flexível para diversos padrões internacionais e requisitos de projeto.

Em que situações eu precisaria usar tamanhos de papel personalizados em vez de tamanhos padrão?

Os tamanhos de papel personalizados no IronPDF são ideais para criar PDFs com layouts exclusivos, como pôsteres, banners, documentos especiais ou qualquer design que não se encaixe em formatos padrão como A4 ou Carta. Essa flexibilidade é especialmente útil para projetos de conversão de HTML para PDF que exigem dimensões específicas.

Quantos tamanhos de papel padrão predefinidos estão disponíveis?

O IronPDF oferece mais de 100 tamanhos de papel padrão predefinidos através da enumeração PdfPaperSize, incluindo formatos comumente usados como A4, Carta, Ofício e muitos padrões internacionais, fornecendo opções abrangentes para a maioria das necessidades de documentos.

Quais são os passos para implementar tamanhos de papel personalizados?

Para implementar tamanhos de papel personalizados com o IronPDF: 1) Baixe o IronPDF via NuGet, 2) Crie uma instância de ChromePdfRenderer, 3) Acesse a propriedade RenderingOptions, 4) Chame o método SetCustomPaperSize com as dimensões desejadas e 5) Renderize e salve seu documento PDF.

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?
Nuget Downloads 18,318,263 | Versão: 2026.4 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronPdf
executar um exemplo Veja seu HTML se transformar em um PDF.