THPDFPage.UserWidth

THPDFPage

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

Delphi syntax:

property UserWidth: Single; // read-only

C++ syntax:

__property float UserWidth = {read=GetUserWidth};

الوصف

إحداثيات X والهوامش وأحجام الخطوط والقيم التي تعيدها TextWidth وTextHeight كلها بوحدة 1/Resolution من البوصة. أما Width فيحفظ عرض الصفحة بالنقاط ويقبل النقاط عند ضبطه، لذا عندما تكون Resolution غير 72 لن يوافق الإحداثيات التي ترسم بها. اقرأ UserWidth كلما قارنت عرض الصفحة بإحداثيات الرسم أو ضممته إليها، مثلًا لإيجاد حافة الهامش اليمنى أو توسيط كتلة نص أو لتقرير متى يجب أن ينتقل المحتوى إلى الصفحة التالية

عند Resolution الافتراضية 72 يساوي UserWidth قيمة Width. والصفحة التي تُحدَّد أبعادها بضبط Width وHeight ترسم بالنقاط مهما كانت Resolution، فيساوي UserWidth قيمة Width عندها أيضًا

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

var
  HPDF: THotPDF;
  Text: AnsiString;
  X: Single;

begin
  HPDF:= THotPDF.Create(nil);
  try
    HPDF.FileName:= 'RightAlignedText.pdf';
    HPDF.Resolution:= 144;                    // Coordinates in 1/144 inch
    HPDF.BeginDoc;
    HPDF.CurrentPage.SetFont('Arial', [], 24); // 12 pt
    Text:= 'Right aligned with a one inch margin';
    // UserWidth is 1190 on an A4 page here; Width stays 595 points
    X:= HPDF.CurrentPage.UserWidth- 144- HPDF.CurrentPage.TextWidth(Text);
    HPDF.CurrentPage.TextOut(X, 144, 0, Text);
    HPDF.EndDoc;
  finally
    HPDF.Free;
  end;
end.

انظر أيضا: Width, UserHeight, THotPDF.Resolution