SpreadJS製品ヘルプ
IMAGE
関数リファレンス > 関数の一覧 > スパークライン関数 > IMAGE

この関数は、セルに画像を表示するためにURLまたはbase64文字列を入力します。

書式

IMAGE(url, [mode, height, width, clipX, clipY, clipHeight, clipWidth, vAlign, hAlign])

引数

引数 説明
URL ウェブ上にあるイメージへのURL、またはイメージのbase64 文字列。
mode

(オプション)イメージのサイズを設定する方法を指定します。

1 - セル内にイメージを収めるように縦横比を維持します。
2 - セル全体にイメージを広げます。
3 - 元のサイズを維持し、はみ出した部分はトリミングします。
4 - カスタムサイズ。

デフォルト値は1です。

height (オプション)イメージの高さを指定します。modeオプションは4に設定する必要があります。
width (オプション)イメージの幅を指定します。modeオプションは4に設定する必要があります。
clipX (オプション)ターゲットコンテキストに描画するソースイメージのサブ矩形の左上隅のx軸座標。デフォルト値は0です。
clipY (オプション)ターゲットコンテキストに描画するソースイメージのサブ矩形の左上隅のy軸座標。デフォルト値は0です。
clipHeight (オプション)ターゲットコンテキストに描画するソースイメージのサブ矩形の高さ。デフォルト値はイメージの高さです。
clipWidth (オプション)ターゲットコンテキストに描画するソースイメージのサブ矩形の幅。デフォルト値はイメージの幅です。
vAlign

(オプション)イメージの垂直方向の配置を指定します。

0 - 上
1 - 上下中央
2 - 下

デフォルト値は1(上下中央)です。

hAlign

(オプション)イメージの水平方向の配置を指定します。

0 - 左
1 - 左右中央
2 - 右

デフォルト値は1(左右中央)です。

データ型

スパークラインを返します。

サンプル

sheet1.setFormula(2, 0, '=IMAGE("https://upload.wikimedia.org/wikipedia/commons/thumb/f/fa/Flag_of_the_People%27s_Republic_of_China.svg/23px-Flag_of_the_People%27s_Republic_of_China.svg.png")');
sheet1.setFormula(3, 0, '= IMAGE("https://upload.wikimedia.org/wikipedia/en/4/41/Flag_of_India.svg")');