TOIMAGE 関数でセル画像を表示する

  • 作成者:ayuan0625
  • 編集回数:38次
  • 最終更新:ayuan0625 于 2025-10-31
  • 一.概要

    1.バージョン

    帳票サーババージョン

    機能変動

    11.0

    -

    11.0.4

    .jpg/.png/.bmp形式の画像をサポートし、それぞれのフォーマットのファイルとしてキャッシュされ、ファイルをエクスポートする際にファイルサイズが膨張することはない

    11.0.18

    ImageWithSuffixオブジェクトが2倍のメモリを占有する問題を最適化し、最適化した後占有メモリを元の半分になる

    2.関数の役割

    TOIMAGE関数は、特定のパスにある画像を帳票に表示するために使用されます。.jpg/.png/.bmp形式の画像をサポートしています。画像はローカルディスク、リモートサーバ、webページに保存することができます。

    3.関数の説明

    TOIMAGE(path)は、指定したパスにある画像を表示します。ここではデフォルトで帳票の生成のスピードを上げるため、画像のキャッシュが有効になっています。キャッシュが不要な場合は、パラメータにFALSEを追加してください。

     パラメータ

    意味

    パラメータ形式

     path

    画像パス、省略不可

    "F:/FineReport_11.0/webroot/logo.png

    注意: スラッシュは/でなければなりません

    boolean

    画像キャッシュ機能を有効にするかどうか、省略可、デフォルトはオンである

    trueオン、falseオフ

     width

    画像幅、省略可、省略時デフォルトは画像の元の幅である

    整数:画像幅ピクセル

    パーセント:画像幅の拡大/縮小率

     height

    画像の高さ、省略可、省略時デフォルトは画像の元の高さである

    整数:画像高さピクセル

    パーセント:画像高さの拡大/縮小率

    例:

    TOIMAGE("D:/1.jpg")

    TOIMAGE("D:/1.jpg",false)

    TOIMAGE("D:/1.jpg",true,200,300)

    TOIMAGE("D:/1.jpg",true,"50%","200%")

    5.注意事項

    1)TOIMAGE 関数を使用してセル画像のテンプレートを表示する場合、メニューバーで[ファイル]-[エクスポート]-[テンプレート(ビルトインデータ)]を選択すると、テンプレートと一緒に画像が出力されません。

    2)TOIMAGE関数のセル属性を使用して[スタイル]-[段落の間隔]を設定した場合、帳票を出力・印刷しても設定した[段落の間隔]は有効になりません。

    3)TOIMAGE関数で返される画像の[画像レイアウト]は[既定]です。別のレイアウト方法は、[セル属性]-[スタイル]-[揃え]-[画像レイアウト]で選択できます。

    4)数式エディタでのシミュレーション計算はサポートされていません。

    5)  gif 形式はサポートされていません。

    二.応用シーン

    TOIMAGE関数は画像パスに直接入力することができ、データベースに保存されている画像パスフィールドを参照することもできます。

    1.直接入力

    画像はローカルディスクまたはリモートサーバに保存できます。 画像の保存先によって、パスの書き方が異なります。

    画像の保存場所

    path パス

    数式

    ローカルディスク

    画像の絶対パス、例:

    E:/画像/logo-fanruan.png

    TOIMAGE("E:/画像/logo-fanruan.png")

    帳票サーバのwebroot ディレクトリ

    プロジェクトがあるディレクトリへの簡略化されたパスを省略する、例:help/logo-fanruan.png

    TOIMAGE("help/logo-fanruan.png")

    ウェブページ内の画像

    画像のウェブアドレス、例:https://www.fanruan.com/images/logo-fanruan.png

    TOIMAGE("https://www.fanruan.com/images/logo-fanruan.png") 

    注意:ウェブページに画像を表示する場合は、WEBIMAGE(path)を使用することをお勧めします。Web画像の読み込みスピードを上げることができます。

    注意: 帳票サーバのWebrootがリモートサーバの場合、デザイナは対応するリモートサーバの作業ディレクトリに切り替える必要があります。

    2.データベース内のフィールドの参照

    1)画像がローカルディスクEに保存され、パスはE:/画像/logo-fanruan.pngである場合、画像のパスは次の図のようにデータベーステーブルに格納させます。次の図に示すように:

    TOIMAGE函数显示单元格图片2.2.1.png

    2)フィールド「パス 」は、帳票のセルにドラッグし、右のセル属性は、[詳細]を選択し、[表示値]の位置で、数式 TOIMAGE($$$)を入力し、$ $ $は現在のセル値を表します。手順は次の図に示すように:

    TOIMAGE函数显示单元格图片2.2.2.png

    3)データベースに保存されている画像のパスが不完全な場合、画像を表示するためにパスを補完する必要があります。

    例えば、データベースに保存されている画像のパスがlogofanruan.pngの場合、[表示値]の数式をTOIMAGE("E:/画像/"+$$$) に修正する必要があります。

    注意: ユーザデータベースサーバと帳票アプリケーションサーバが別々の場合、画像はデータベースサーバではなく帳票プリケーションサーバに格納されます。

    3.画像レイアウトの調整

    TOIMAGE式は、画像のレイアウトを調整するために画像サポートを参照します。セルを選択し、右側のプロパティパネルで [セル属性]-[スタイル]-[カスタム]-[揃え]を選択し、[詳細]-[画像レイアウト]で画像レイアウトを調整することができます。次の図に示すように:

    TOIMAGE函数显示单元格图片2.3.png

    レイアウト方法の違いによる表示効果を次の図に示します。 既定のレイアウトは並べて表示と同じです。

    TOIMAGE函数显示单元格图片2.3(2).png

    Attachment List


    Theme: FineReort 帳票特集
    • いいね
    • 良くない
    • 閲覧しただけ