THPDFPage.UserHeight

THPDFPage

Retorna a altura da página em unidades de desenho, 1/THotPDF.Resolution de polegada

Sintaxe Delphi:

property UserHeight: Single; // read-only

Sintaxe C++:

__property float UserHeight = {read=GetUserHeight};

Descrição

Coordenadas Y, margens, tamanhos de fonte e os valores retornados por TextWidth e TextHeight ficam em 1/Resolution de polegada. Height guarda a altura da página em pontos e aceita pontos quando você a define, então com uma Resolution diferente de 72 ela não corresponde às coordenadas com que você desenha. Leia UserHeight sempre que for comparar ou combinar a altura da página com coordenadas de desenho, por exemplo para achar a borda da margem inferior, centralizar um bloco ou decidir quando o conteúdo precisa passar para a próxima página

Na Resolution padrão de 72, UserHeight é igual a Height. Uma página dimensionada definindo Width e Height desenha em pontos qualquer que seja a Resolution, e nesse caso UserHeight também fica igual a Height

program FooterLine;
{$APPTYPE CONSOLE}
uses
  SysUtils,
  HPDFDoc;

var
  HPDF: THotPDF;

begin
  HPDF:= THotPDF.Create(nil);
  try
    HPDF.FileName:= 'FooterLine.pdf';
    HPDF.Resolution:= 144;                    // Coordinates in 1/144 inch
    HPDF.BeginDoc;
    HPDF.CurrentPage.SetFont('Arial', [], 20); // 10 pt
    // UserHeight is 1684 on an A4 page here; Height stays 842 points
    HPDF.CurrentPage.TextOut(144, HPDF.CurrentPage.UserHeight- 144, 0,
      'Footer one inch above the bottom edge');
    HPDF.EndDoc;
  finally
    HPDF.Free;
  end;
end.

See also: Height, UserWidth, THotPDF.Resolution