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

Curtis Chau

Updated: 29 de junho de 2026

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # Construção e Posicionamento de Retângulos no IronPDF 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.  ## 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. [[i:(Misturar unidades entre bibliotecas é uma fonte comum de formas mal colocadas; confirme se a API que você está chamando espera pontos ou pixels.)]]

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

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.

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.

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

...

Leia mais