THPDFPage.UserHeight

THPDFPage

Zwraca wysokość strony w jednostkach rysowania, 1/THotPDF.Resolution cala

Delphi syntax:

property UserHeight: Single; // read-only

C++ syntax:

__property float UserHeight = {read=GetUserHeight};

Description

Współrzędne Y, marginesy, rozmiary czcionek i wartości zwracane przez TextWidth i TextHeight są w 1/Resolution cala. Height trzyma wysokość strony w punktach i przy ustawianiu przyjmuje punkty, więc przy Resolution innej niż 72 nie zgadza się ze współrzędnymi, którymi rysujesz. Czytaj UserHeight zawsze, gdy porównujesz albo łączysz wysokość strony ze współrzędnymi rysowania — na przykład żeby znaleźć dolną krawędź marginesu, wyśrodkować blok albo zdecydować, kiedy treść musi przejść na następną stronę

Przy domyślnym Resolution 72 UserHeight równa się Height. Strona wymiarowana przez ustawienie Width i Height rysuje w punktach niezależnie od Resolution, więc UserHeight również równa się 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