THPDFPage.UserHeight

THPDFPage

تُعيد ارتفاع الصفحة بوحدات الرسم، أي 1/THotPDF.Resolution من البوصة

Delphi syntax:

property UserHeight: Single; // read-only

C++ syntax:

__property float UserHeight = {read=GetUserHeight};

الوصف

إحداثيات Y والهوامش وأحجام الخطوط والقيم التي تعيدها TextWidth وTextHeight كلها بوحدة 1/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.

انظر أيضا: Height, UserWidth, THotPDF.Resolution