THPDFPage.Width プロパティ

ページの幅の読み取りまたは変更には、Width プロパティを使用します。標準の用紙、図面、カード、ID/パスポート、および写真フォーマットの場合は、A2、A3、B2、B4、A5、B5、Tabloid、Ledger、ANSIC、ARCHD、および P8R などの事前定義された THPDFPage.Size 列挙値を使用することを推奨します。既存の psXXX という名前は、互換性のあるエイリアスとして残ります。必要な寸法が事前定義されていない場合にのみ UserDefined で Width および Height を使用してください。

Width はポイント単位で、新しい値もポイントで受け付けます。描画座標は 1/THotPDF.Resolution インチなので、Resolution が 72 以外のときは UserWidth を読めば、自分が描く単位でのページの幅が得られます。Width を設定するとページは UserDefined になり、UserDefined のページはポイント単位で描画します。

ページをファイルから読み込んだ場合、Width を設定するとそのページ自身の MediaBox が書き込まれます。他のページと共有されている MediaBox や、数値が独立したオブジェクトになっている MediaBox は、まずこのページ専用のコピーへ置き換えられるため、他のページやオブジェクトの値はそのまま保たれます。キャンバスを閉じたページで Width を設定すると EHPDFPageClosedError が発生します。

Tabloid は 11 x 17 インチです。Ledger は横向きの 17 x 11 インチサイズです。Ledger を縦向きの Tabloid の別名として扱わないでください。

実際の仕様が数字で始まる場合、写真サイズの列挙名には P プレフィックスが使用されます。たとえば、P5R は、ユーザー向けの 5R 写真サイズを表します。

コード例

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.