[]
        
(Showing Draft Content)

IMAGE

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

書式

IMAGE(source, [alt_text], [sizing], [height], [width], [clipX], [clipY], [clipHeight], [clipWidth], [vAlign], [hAlign])

引数

引数

説明

source

「https」プロトコルを使用したイメージファイルへのURL、またはイメージデータのBase64文字列。

alt_text

(オプション)アクセシビリティのためにイメージを説明する代替テキスト。

sizing

(オプション)イメージの寸法を指定します。可能な値は次のたおりです。

0 - セル内にイメージを収めるように縦横比を固定します。

1 - セルをイメージで埋めて、縦横比を無視します。

2 - 元のイメージサイズを維持します。セルの境界を超える可能性があります。

3 - 高さと幅の引数を使用して、イメージのサイズをカスタマイズします。

デフォルト値は 0 です。

height

(オプション)イメージの高さ(ピクセル単位)を指定します。

width

(オプション)イメージの幅(ピクセル単位)を指定します。

clipX

(オプション)ターゲットコンテキストに描画するソースイメージのサブ矩形の左上隅のx軸座標。デフォルト値は0です。

clipY

(オプション)ターゲットコンテキストに描画するソースイメージのサブ矩形の左上隅のy軸座標。デフォルト値は0です。

clipHeight

(オプション)ターゲットコンテキストに描画するソースイメージのサブ矩形の高さ。デフォルト値はイメージの高さです。

clipWidth

(オプション)ターゲットコンテキストに描画するソースイメージのサブ矩形の幅。デフォルト値はイメージの幅です。

vAlign

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

0 - 上

1 - 上下中央

2 - 下

デフォルト値は2(下)です。

hAlign

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

0 - 左

1 - 左右中央

2 - 右

デフォルト値は0(左)です。

type=warning

メモ:ソースが Base64文字列の場合、Excelファイルへのエクスポートをサポートしていません。

制限事項

イメージのURL がクロスドメイン URL の場合、イメージ情報を収集できず、Excel にエクスポートするときにイメージが表示されません。

データ型

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

サンプル

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")');