[]
【重要】2024年1月公開のアップデート「未適用」のお客様へ デモ ヘルプ APIリファレンス
トライアル版
(Showing Draft Content)

Wijmo_Pdf.Pdfpagearea

PdfPageArea クラス

左上隅を(0, 0)とする独自の座標系でページの領域を表します。 テキスト、画像、パス、および変換を描画するためのメソッドを提供します。 このクラスは、ユーザーコード内でインスタンス化することを意図していません。

このクラスは、ユーザーコード内でインスタンス化することを意図していません。

階層

コンストラクタ

プロパティ

メソッド

コンストラクタ

constructor

プロパティ

document

document: PdfDocument

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

height

height: number

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

lineGap

lineGap: number

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

デフォルト値は0です。

paths

paths: PdfPaths

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

width

width: number

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

x

x: number

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

y

y: number

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

メソッド

artifact

  • 内容をアーティファクトとしてマークします。

    以下に例を示します。

    doc.artifact(() => doc.drawText('Artifact'));

    引数

    戻り値 PdfPageArea

    マークされた内容への参照を表すIPdfTagContentオブジェクト。

beginArtifact

  • 内容をPDFアーティファクトとしてマークし始めます。 beginArtifact()の各呼び出しは、endArtifactで囲む必要があります。

    以下に例を示します。

    doc.beginArtifact();
doc.drawText('Artifact');
doc.endArtifact();

    引数

    戻り値 PdfPageArea

    PdfPageArea オブジェクト。

beginTagContent

  • 指定されたタグで内容のマーキングを開始し、マークされた内容への参照を表すオブジェクトであるタグの内容の要素を返します。 タグの内容の要素は、タグ要素に追加することでドキュメントの構造ツリーに組み込むことができます。 beginTagContent()の各呼び出しは、endTagContentで囲む必要があります。

    以下に例を示します。

    let content = doc.beginTagContent(wijmo.pdf.PdfTagType.P);
doc.drawText('Hello, world!');
doc.endTagContent();

let tag = doc.tag(wijmo.pdf.PdfTagType.P);
tag.add(content);
doc.addTag(tag);

    メモ: タグの内容をマークすると、タグの内容の現在のマーキング（および子孫のマーキング）が自動的に終了します。

    引数

    戻り値 IPdfTagContent

    マークされた内容への参照を表すIPdfTagContentオブジェクト。

drawImage

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

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

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

    引数

    • src: string | IPdfImage

      画像の取得元のURLを含む文字列、Base64エンコード画像を含むデータURI、 またはopenImageメソッドによって返されるwijmo.pdf.IPdfImageオブジェクト。

    • オプション x: number

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

    • オプション y: number

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

    • オプション options: IPdfImageDrawSettings

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

    戻り値 PdfPageArea

    PdfPageArea オブジェクト。

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

    PdfPageArea オブジェクト。

drawText

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

    options.pen、options.brush、またはoptions.fontを省略すると、 それぞれ現在のドキュメントのペン、ブラシ、またはフォントが使用されます（PdfDocument.setPen、 PdfDocument.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

    測定情報を決定する IPdfTextMeasurementInfo オブジェクト。

endArtifact

  • マークされた内容をPDFのアーティファクトとして終了します。

    以下に例を示します。

    doc.beginArtifact();
doc.drawText('Artifact');
doc.endArtifact();

    戻り値 PdfPageArea

    PdfPageArea オブジェクト。

endTagContent

  • タグの内容のマーケティングを終了します。

    以下に例を示します。

    let content = doc.beginTagContent(wijmo.pdf.PdfTagType.P);
doc.drawText('Hello, world!');
doc.endTagContent();

    戻り値 PdfPageArea

    PdfPageArea オブジェクト。

lineHeight

  • lineHeight(font?: PdfFont): number

  • 指定されたフォントの行の高さを取得します。

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

    引数

    • オプション font: PdfFont

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

    戻り値 number

    行の高さ（ポイント単位）。

measureText

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

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

    引数

    • text: string

      測定するテキスト。

    • オプション font: PdfFont

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

    • オプション options: IPdfTextMeasurementSettings

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

    戻り値 IPdfTextMeasurementInfo

    測定情報を決定する IPdfTextMeasurementInfo オブジェクト。

moveDown

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

    引数

    • オプション lines: number

      下に移動する行数。

    • オプション font: PdfFont

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

    戻り値 PdfPageArea

    PdfPageArea オブジェクト。

moveUp

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

    引数

    • オプション lines: number

      上に移動する行数。

    • オプション font: PdfFont

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

    戻り値 PdfPageArea

    PdfPageArea オブジェクト。

openImage

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

    引数

    • url: string

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

    戻り値 IPdfImage

    画像データを含むIPdfImageオブジェクト。

rotate

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

    引数

    • angle: number

      回転角度（度単位）。

    • オプション origin: Point

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

    戻り値 PdfPageArea

scale

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

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

    引数

    • xFactor: number

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

    • オプション yFactor: number

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

    • オプション origin: Point

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

    戻り値 PdfPageArea

    PdfPageArea オブジェクト。

tagContent

  • 指定されたタグで内容をマークし、マークされた内容への参照を表すオブジェクトであるタグの内容の要素を返します。 タグの内容の要素は、タグ要素に追加することでドキュメントの構造ツリーに組み込むことができます。

    以下に例を示します。

    let content = doc.tagContent(wijmo.pdf.PdfTagType.P, () => doc.drawText('Hello, world!'));

let tag = doc.tag(wijmo.pdf.PdfTagType.P);
tag.add(content);
doc.addTag(tag);

    引数

    • tag: PdfTagType

      マーキングに使用されるタグ。

    • callback: Object

      @link beginTagContent}/endTagContentブロック内で自動的に実行されるコールバック関数。

    • オプション options: IPdfTagContentOptions

      タグ内の内容のオプション。

    戻り値 IPdfTagContent

    マークされた内容への参照を表すIPdfTagContentオブジェクト。

transform

  • transform(a: number, b: number, c: number, d: number, e: number, f: number): PdfPageArea

  • 3x3の変換マトリックスを表す指定された６つの数字で グラフィックコンテキストを変換します。

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

    ab0
    cd0
    ef1

    引数

    • a: number

      １行１列目の値。

    • b: number

      １行２列目の値。

    • c: number

      ２行１列目の値。

    • d: number

      ２行２列目の値。

    • e: number

      ３行１列目の値。

    • f: number

      ３行２列目の値。

    戻り値 PdfPageArea

    PdfPageArea オブジェクト。

translate

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

    引数

    • x: number

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

    • y: number

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

    戻り値 PdfPageArea

    PdfPageArea オブジェクト。