Redimensionar, Estender e Transformar Página PDF
Quando você ajusta o layout de um PDF programaticamente, o resultado depende de se você muda a própria página ou o conteúdo dentro dela. O IronPDF oferece três métodos distintos para isso: Resize, Extend e Transform. Escolher o certo depende se você quer mudar o tamanho da página, adicionar margens ou mover o conteúdo.
Redimensionar
Use Resize quando quiser alterar as dimensões da página, ampliando ou reduzindo a página.
public void Resize(double PageWidth, double PageHeight, MeasurementUnit Units)
public void Resize(double PageWidth, double PageHeight, MeasurementUnit Units)
Public Sub Resize(PageWidth As Double, PageHeight As Double, Units As MeasurementUnit)
End Sub
Resize muda o tamanho físico da página e dimensiona o conteúdo para caber nas novas dimensões, então tudo permanece visível. Uma página originalmente de 210mm x 297mm redimensionada para 148mm x 210mm se torna A5, com seu conteúdo ajustado para a página menor.
Estender
Use Extend quando quiser espaços em branco ou margens ao redor do conteúdo existente sem tocar no layout, escala ou posição do conteúdo.
public void Extend(double ExtendLeft, double ExtendRight, double ExtendTop, double ExtendBottom, MeasurementUnit Units)
public void Extend(double ExtendLeft, double ExtendRight, double ExtendTop, double ExtendBottom, MeasurementUnit Units)
Public Sub Extend(ExtendLeft As Double, ExtendRight As Double, ExtendTop As Double, ExtendBottom As Double, Units As MeasurementUnit)
End Sub
Este método adiciona espaço à página, aumentando seu tamanho geral, mas deixa o conteúdo existente exatamente onde estava. Começando de uma página A4 de 210mm x 297mm, adicionar 10mm à esquerda e à direita mais 20mm em cima e embaixo resulta em uma página de 230mm x 337mm com o conteúdo original centrado em seu espaço antigo. É útil para preparar um PDF para impressão ou encadernação onde são necessárias margens extras.
Entrada de Exemplo

Exemplo de saída

Transformar
Use Transform para mover ou dimensionar o conteúdo real na página enquanto mantém o tamanho físico da página fixo.
public void Transform(double MoveX, double MoveY, double ScaleX, double ScaleY)
public void Transform(double MoveX, double MoveY, double ScaleX, double ScaleY)
Public Sub Transform(MoveX As Double, MoveY As Double, ScaleX As Double, ScaleY As Double)
End Sub
As dimensões da página permanecem as mesmas; apenas a aparência do conteúdo muda. Passar valores que movem o conteúdo 10mm para a direita e 5mm para baixo, depois dimensioná-lo para 80% em ambas as direções, desloca e encolhe o conteúdo no lugar. Use isso ao corrigir layouts, alinhar conteúdo ou aplicar um efeito de zoom-out.
Exemplo de saída

Escolhendo Entre Eles
- Redimensionar: muda o tamanho da página e dimensiona o conteúdo com ela; cuidado com cortes potenciais.
- Estender: cresce a tela com espaços em branco e deixa o conteúdo intocado.
- Transformar: move ou dimensiona o conteúdo enquanto as dimensões da página permanecem fixas.
Esses métodos também se combinam. Um padrão comum é redimensionar a página e depois transformar o conteúdo para ajustar às novas dimensões.

