THPDFPage.UserHeight

THPDFPage

מחזיר את גובה העמוד ביחידות ציור, כאשר היחידה היא אינץ' חלקי THotPDF.Resolution

Delphi syntax:

property UserHeight: Single; // read-only

C++ syntax:

__property float UserHeight = {read=GetUserHeight};

תיאור

תחיליות Y, שוליים, גדלי גופנים והערכים שמחזירים TextWidth ו-TextHeight נמדדים באינץ' חלקי Resolution Height מחזיק את גובה העמוד בנקודות ומקבל נקודות בהצבה, כך שכאשר ה-Resolution שונה מ-72 הוא אינו תואם לקואורדינטות שבהן אתם מציירים השתמשו ב-UserHeight בכל פעם שאתם משווים או משלבים את גובה העמוד עם קואורדינטות הציור — למשל כדי למצוא את קצה השוליים התחתון, למרכז בלוק או להחליט מתי התוכן צריך לעבור לעמוד הבא

ב-Resolution ברירת המחדל, 72, UserHeight שווה ל-Height עמוד שגודלו הוגדר על ידי הצבת Width ו-Height מצויר בנקודות בכל Resolution שיהיה, וגם אז UserHeight שווה ל-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