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

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

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.

ObserveMisturar unidades entre bibliotecas é uma fonte comum de formas mal colocadas; confirme se a API que você está chamando espera pontos ou pixels.

Curtis Chau
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 20,296,129 | Versão: 2026.7 recém-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.