Construção e Posicionamento de Retângulos no IronPDF

Curtis Chau
Curtis Chau
Updated: 29 de junho de 2026

Quando você desenha retângulos em um PDF com IronPDF, o sistema de coordenadas difere de bibliotecas como IronOCR e IronBarcode. IronOCR e IronBarcode definem retângulos em relação a uma entrada de imagem, enquanto IronPDF trabalha dentro do espaço de coordenadas do próprio documento PDF.

Origem da Coordenada

O ponto de origem (0, 0) fica no canto inferior esquerdo da página. Quando você especifica um retângulo, aquela origem é tratada como o canto superior esquerdo do retângulo, o que determina a direção em que a forma é desenhada.

Comportamento dos Eixos

Como os valores x e y deslocam o retângulo:

  • Coordenada Y: aumentar y move o retângulo para cima; diminuí-la move o retângulo para baixo. Um y negativo coloca o retângulo abaixo do ponto (0, 0).
  • Coordenada X: aumentar x move o retângulo para a direita. Diminuir x, ou fornecer um valor negativo, move-o para a esquerda.

Largura e Altura

As dimensões podem ser desenhadas em qualquer direção do ponto inicial:

  • Largura: um width positivo desenha para a direita; um width negativo ou diminuindo desenha para a esquerda.
  • Altura: um height positivo se estende para cima; um height negativo desenha para baixo.

Diagrama de retângulos coloridos em um PDF mostrando como os valores de x, y, largura e altura afetam o posicionamento

Unidade de Medida

IronPDF mede sua API de desenho em pontos, fornecendo a precisão necessária para renderização de documentos e layout. As outras bibliotecas do Iron Software diferem:

  • IronOCR: usa pixels exclusivamente, correspondendo ao seu foco em reconhecimento de texto baseado em imagem.
  • IronBarcode: usa pixels para localizar objetos de código de barras, mas alterna para pontos ao carimbar códigos de barras em um PDF para que o posicionamento permaneça preciso em formatos de documentos.
Observe: Misturar unidades entre bibliotecas é uma fonte comum de formas mal colocadas; confirme se a API que você está chamando espera pontos ou pixels.

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 bem estruturados e visualmente atraentes.

Leia mais

Pronto para começar?

Nuget Downloads 22,024,882Versão:2026.11recém-lançado