THPDFPage.Width

THPDFPage

 

傳回頂部  上一頁  下一頁

指定頁面的水平大小

 

Delphi 語法:

property Width: Single;

 

C++ 語法:

__property float Width;

 

說明

使用 Width property 讀取或變更頁面寬度。對於標準 paper、drawing、card、ID/passport 與 photo formats,請優先使用預先定義的 THPDFPage.Size enum values,例如 A2、A3、B2、B4、A5、B5、Tabloid、Ledger、ANSIC、ARCHD 與 P8R。既有 psXXX names 仍是相容 aliases。只有在所需尺寸未預先定義時,才搭配 UserDefined 使用 Width 與 Height

Width 以點為單位,新值也以點解讀。繪圖座標採 1/THotPDF.Resolution 英吋,所以 Resolution 不是 72 時,請讀取 UserWidth 取得繪圖單位下的頁面寬度。設定 Width 會把頁面變成 UserDefined,而 UserDefined 頁面以點為單位繪製

頁面是從檔案載入時,設定 Width 會寫入該頁自己的 MediaBox:若某個 MediaBox 與其他頁面共用,或它的數值是獨立物件,會先替此頁換成一份複本,其他頁面與物件因此保有自己的值。對畫布已關閉的頁面設定 Width 會引發 EHPDFPageClosedError

Tabloid 為 11 x 17 英吋。Ledger 是橫向的 17 x 11 英吋尺寸;請勿把 Ledger 當成直向 Tabloid 的另一個名稱

當實際規格以數字開頭時,photo-size enum names 會使用 P 前綴。例如 P5R 代表使用者可見的 5R photo size

 

Code Example

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

var
   HPDF: THotPDF;

begin
    HPDF:= THotPDF.Create(  nil  );
    try
        HPDF.AutoLaunch := true;                // PDF file will be shown automatically
        HPDF.FileName := 'CustomPageSize.pdf';  // Set PDF filename
        HPDF.PageLayout := plOneColumn;  // Set one column viewer mode

        HPDF.BeginDoc;                              // Create PDF file

        HPDF.CurrentPage.Size := UserDefined;
        HPDF.CurrentPage.Width := 1024 / 25.4 * 72;   // 1024 mm in PDF points
        HPDF.CurrentPage.Height := 768 / 25.4 * 72;   // 768 mm in PDF points
        HPDF.CurrentPage.TextOut(10, 10, 0, '1024 x 768 mm custom page');

        HPDF.EndDoc;                                                       // Close PDF file
    finally
        HPDF.Free;
    end;
end.

 

請參閱: UserWidth, Height, Size