5.20201.680
wijmo.pdf Class PdfDocument Wijmo API クラス

PdfDocument クラス

PDFKit JavaScriptライブラリに基づくPDFドキュメントオブジェクトを表します。

階層

コンストラクタ

constructor

  • PdfDocument クラスの新しいインスタンスを初期化します。

    引数

    • オプション options: any

      初期化設定を含むオプションのオブジェクト。

    戻り値 PdfDocument

プロパティ

bufferPages

bufferPages: boolean

ページのバッファリングモードが有効かどうかを示す値を取得します。 このモードでは、pageIndex およびbufferedPageRange を使用してドキュメントのページを反復処理できます。

このプロパティは、PdfDocument コンストラクタを使用してのみ割り当てることができます。 このプロパティは、headerfooter が両方とも非表示である場合にのみfalseに設定できます。

デフォルト値はtrueです。

compress

compress: boolean

ドキュメント圧縮が有効かどうかを示す値を取得します。 このプロパティは、PdfDocument コンストラクタを使用してのみ割り当てることができます。

デフォルト値はtrueです。

currentPageSettings

currentPageSettings: IPdfPageSettings

現在のページ設定を表すオブジェクトを取得します(読み取り専用)。

returns

A IPdfPageSettings object that represents the current page settings.

document

document: PdfDocument

ドキュメントオブジェクトを取得します。

footer

下マージンの直上に配置されているページ領域のフッターを表すオブジェクトを取得します。

header

上マージンの直下に配置されているページ領域のヘッダーを表すオブジェクトを取得します。

height

height: number

領域の高さ(ポイント単位)を取得します。

info

作成者名やドキュメントの作成日などのドキュメント情報を取得または設定します。

lineGap

lineGap: number

テキスト行の間隔(ポイント単位)を取得または設定します。

デフォルト値は0です。

pageIndex

pageIndex: number

バッファページ範囲内の現在のページのインデックスを取得または設定します。

bufferedPageRange メソッドを使用して、バッファページの範囲を取得します。

pageSettings

pageSettings: IPdfPageSettings

自動的に追加されるページおよびaddPage メソッドの デフォルトのページ設定を表すオブジェクトを取得します。

paths

paths: PdfPaths

パスを描画する機能を提供するオブジェクトを取得します。

width

width: number

領域の幅(ポイント単位)を取得します。

x

x: number

テキストまたは画像の描画に使用されるテキストフロー内の現在の点のX座標 (ポイント単位)を取得または設定します。

y

y: number

テキストまたは画像の描画に使用されるテキストフロー内の現在の点のY座標 (ポイント単位)を取得または設定します。

メソッド

addPage

  • 指定された設定で新しいページを追加します。

    設定パラメータを省略すると、代わりにpageSettings が使用されます。

    引数

    戻り値 PdfDocument

    The PdfDocument object.

bufferedPageRange

dispose

  • dispose(): void
  • ドキュメントを破棄します。

    戻り値 void

drawImage

  • 指定されたオプションを使用して、JPGまたはPNG形式で画像を描画します。

    xおよびyが定義されていない場合は、代わりにx およびy が使用されます。

    最後に、画像がテキストフロー内で描画された場合、このメソッドはyを更新します。 したがって、後続のテキストまたは画像は、この点の下から開始されます。

    引数

    • src: any

      画像の取得元のURLを含む文字列、Base64エンコード画像を含むデータURI、またはwijmo.pdf.IPdfImage オブジェクト。

    • オプション x: number

      画像を描画するポイントのx座標(ポイント単位)。

    • オプション y: number

      画像を描画するポイントのy座標(ポイント単位)。

    • オプション options: IPdfImageDrawSettings

      画像描画オプションを決定します。

    戻り値 PdfPageArea

    The PdfPageArea object.

drawSvg

  • 指定されたオプションを使用してSVG画像を描画します。

    xおよびyが定義されていない場合は、代わりにx およびy が使用されます。 このメソッドは、最も外側のSVG要素のwidth属性とheight属性の値を使用し、 options.widthプロパティとoptions.heightプロパティに基づいて拡大縮小率を決定します。 これらの属性のいずれかを省略した場合、拡大縮小は行われず、画像は元のサイズでレンダリングされます。 最後に、画像がテキストフロー内で描画された場合、このメソッドはy を更新します。 したがって、後続のテキストまたは画像は、この点の下から開始されます。 インクリメント値は、options.heightプロパティまたは最も外側のSVG要素のheight属性によって定義されます。 どちらも指定されていない場合、y は変更されません。 このメソッドは、SVG機能の一部のみをサポートしており、 主にWijmo 5のチャートコントロールをレンダリングするために提供されています。

    引数

    • url: string

      SVG画像の取得元のURLを含む文字列、またはBase64エンコードSVG画像を含むデータURI。

    • オプション x: number

      画像を描画するポイントのx座標(ポイント単位)。

    • オプション y: number

      画像を描画するポイントのy座標(ポイント単位)。

    • オプション options: IPdfSvgDrawSettings

      SVG画像描画オプションを決定します。

    戻り値 PdfPageArea

    The PdfPageArea object.

drawText

  • 指定されたオプションを使用して文字列を描画し、測定情報を返します。

    options.penoptions.brush、またはoptions.fontを省略すると、 それぞれ現在のドキュメントのペン、ブラシ、またはフォントが使用されます(PdfDocument.setPenPdfDocument.setBrush、および PdfDocument.setFont を参照)。

    文字列は、左上隅がxおよびy、幅および高さが options.width値およびoptions.height値で定義される四角形領域内に描画されます。xとyを指定しない場合は、代わりにPdfDocument.x プロパティとPdfDocument.y プロパティが使用されます。

    領域内のテキストは、自動的に折り返されてクリッピングされます。 options.heightが定義されておらず、テキストが本文の下端を超えた場合、 テキストに合わせて新しいページが追加されます。

    最後に、PdfDocument.x} プロパティとPdfDocument.y プロパティ プロパティの値を更新します。したがって、後続のテキストまたは画像は、この点の下から開始されます (options.continuedの値によって異なる)。

    測定結果には、テキストが複数のページまたは列に分割される可能性があることが反映されません。 テキストは単一ブロックとして処理されます。

    引数

    • text: string

      描画するテキスト。

    • オプション x: number

      テキストを描画するポイントのX座標(ポイント単位)。

    • オプション y: number

      テキストを描画するポイントのY座標(ポイント単位)。

    • オプション options: IPdfTextDrawSettings

      テキスト描画オプションを決定します。

    戻り値 IPdfTextMeasurementInfo

    A IPdfTextMeasurementInfo object determines the measurement information.

end

  • end(): void
  • ドキュメントのレンダリングを終了します。

    戻り値 void

lineHeight

  • lineHeight(font?: PdfFont): number
  • 指定されたフォントの行の高さを取得します。

    フォントが指定されていない場合は、現在のドキュメントで使用されているフォントが使用されます。

    引数

    • オプション font: PdfFont

      行の高さを取得するフォント。

    戻り値 number

    The line height, in points.

measureText

  • 指定されたフォントおよびテキスト描画オプションを使用して、テキストをレンダリングせずに測定します。

    フォントが指定されていない場合は、現在のドキュメントで使用されているフォントが使用されます。 このメソッドは、drawText と同じテキストレンダリングエンジンを使用するため、options.widthが指定されていない場合は、 同様にx およびページの右マージンに制約されます。 測定結果には、テキストが複数のページまたは列に分割される可能性があることが反映されません。 テキストは単一ブロックとして処理されます。

    引数

    • text: string

      測定するテキスト。

    • オプション font: PdfFont

      テキストに適用されるフォント。

    • オプション options: IPdfTextMeasurementSettings

      テキスト描画オプションを決定します。

    戻り値 IPdfTextMeasurementInfo

    A IPdfTextMeasurementInfo object determines the measurement information.

moveDown

  • 指定されたフォントまたはフォントが指定されていない場合は現在のドキュメントのフォントを使用して、指定された行数だけy を下に移動します。

    引数

    • オプション lines: number

      下に移動する行数。

    • オプション font: PdfFont

      行の高さを計算するフォント。

    戻り値 PdfPageArea

    The PdfPageArea object.

moveUp

  • 指定されたフォントまたはフォントが指定されていない場合は現在のドキュメントのフォントを使用して、指定された行数だけy を上に移動します。

    引数

    • オプション lines: number

      上に移動する行数。

    • オプション font: PdfFont

      行の高さを計算するフォント。

    戻り値 PdfPageArea

    The PdfPageArea object.

onEnded

onPageAdded

  • pageAdded イベントを発生させます。

    引数

    戻り値 void

openImage

  • JPGまたはPNG形式で画像を開きます。

    引数

    • url: string

      画像の取得元のURLを含む文字列、またはBase64エンコード画像を含むデータURI。

    戻り値 IPdfImage

    The IPdfImage object containing image data.

registerFont

  • ソースからフォントを登録し、それを指定されたフォントファミリ名およびフォント属性に関連付けます。

    引数

    戻り値 PdfDocument

    The PdfDocument object.

registerFontAsync

  • registerFontAsync(font: IPdfFontFile, callback: Object): void
  • URLからフォントを非同期に登録し、それを指定されたフォントファミリ名 およびフォント属性に関連付けます。

    このコールバック関数は、パラメータとして IPdfFontFile オブジェクトを受け取ります。

    引数

    • font: IPdfFontFile

      登録するフォント。

    • callback: Object

      フォントが登録されると呼び出されるコールバック関数。

    戻り値 void

restoreState

  • スタックから状態を復元し、それをグラフィックコンテキストに適用します。

    戻り値 PdfDocument

    The PdfDocument object.

rotate

  • 指定された角度でグラフィックコンテキストを時計回りに回転します。

    引数

    • angle: number

      回転角度(度単位)。

    • オプション origin: Point

      回転の中心の Point (ポイント単位)。 指定しない場合は、左上隅が使用されます。

    戻り値 PdfPageArea

saveState

  • グラフィックコンテキストの状態(現在のペン、ブラシ、変換状態を含む)を 保存し、それをスタックにプッシュします。

    戻り値 PdfDocument

    The PdfDocument object.

scale

  • 指定された拡大率でグラフィックコンテキストを拡大縮小します。

    範囲[0, 1]内の拡大率の値は、サイズが小さくなることを示します。 1より大きい拡大率の値は、サイズが大きくなることを示します。

    引数

    • xFactor: number

      Xサイズを拡大縮小する係数。

    • オプション yFactor: number

      Yサイズを拡大縮小する係数。 指定しない場合は、xFactorと等しい値と見なされます。

    • オプション origin: Point

      拡大縮小の中心となるPoint (ポイント単位)。 指定しない場合は、左上隅が使用されます。

    戻り値 PdfPageArea

    The PdfPageArea object.

setBrush

setFont

  • ドキュメントフォントを設定します。

    指定されたスタイルおよび重みプロパティを持つフォントが見つからない場合は

    • フォールバック を使用して、 最も近いフォントが検索されます。
    • 何も見つからなかった場合は、以下の順序で他のスタイルの最も近いフォントが検索されます。
      • 'italic': 'oblique', 'normal'.
      • 'oblique': 'italic', 'normal'.
      • 'normal': 'oblique', 'italic'.

    引数

    • font: PdfFont

      設定するフォントオブジェクト。

    戻り値 PdfDocument

    The PdfDocument object.

setPen

  • デフォルトのドキュメントペンを設定します。 特定のペンが提供されていない場合は、このペンが PdfPaths.strokePdfPaths.fillAndStroke 、および drawText メソッドで使用されます。

    penOrColor 引数は、次の値を取ることができます。

    • PdfPen オブジェクト。
    • wijmo.Color オブジェクト、またはwijmo.Color.fromString メソッドが受け取ることができる任意の文字列。 この場合、指定された色のPdfPen オブジェクトが内部的に作成されます。

    引数

    • value: PdfPen | Color | string

      使用するペンまたは色。

    戻り値 PdfDocument

    The PdfDocument object.

transform

  • transform(a: number, b: number, c: number, d: number, e: number, f: number): PdfPageArea
  • 3x3の変換マトリックスを表す指定された6つの数字で グラフィックコンテキストを変換します。

    変換マトリックスは次のように記述されます。

    ab0
    cd0
    ef1

    引数

    • a: number

      1行1列目の値。

    • b: number

      1行2列目の値。

    • c: number

      2行1列目の値。

    • d: number

      2行2列目の値。

    • e: number

      3行1列目の値。

    • f: number

      3行2列目の値。

    戻り値 PdfPageArea

    The PdfPageArea object.

translate

  • 指定された距離でグラフィックコンテキストを平行移動します。

    引数

    • x: number

      X軸方向に移動する距離(ポイント単位)。

    • y: number

      Y軸方向に移動する距離(ポイント単位)。

    戻り値 PdfPageArea

    The PdfPageArea object.

イベント

ended

ドキュメントがレンダリングされると発生します。

pageAdded

ドキュメントに新しいページが追加されたときに発生します。