一.概要
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である場合、画像のパスは次の図のようにデータベーステーブルに格納させます。次の図に示すように:

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

3)データベースに保存されている画像のパスが不完全な場合、画像を表示するためにパスを補完する必要があります。
例えば、データベースに保存されている画像のパスがlogofanruan.pngの場合、[表示値]の数式をTOIMAGE("E:/画像/"+$$$) に修正する必要があります。
注意: ユーザデータベースサーバと帳票アプリケーションサーバが別々の場合、画像はデータベースサーバではなく帳票プリケーションサーバに格納されます。
3.画像レイアウトの調整
TOIMAGE式は、画像のレイアウトを調整するために画像サポートを参照します。セルを選択し、右側のプロパティパネルで [セル属性]-[スタイル]-[カスタム]-[揃え]を選択し、[詳細]-[画像レイアウト]で画像レイアウトを調整することができます。次の図に示すように:

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