画像を挿入 (ワークブック)

[画像を挿入 (ワークブック)] アクティビティのプロパティと設定。このアクティビティは、Excel ブックの指定したセル アンカーに画像を挿入し、ピクセルのオフセットとスケールを任意で設定します。

UiPath.Excel.Activities.InsertImage

説明

セルに固定してブックのシートに画像を挿入します。画像の左上隅がアンカーセルに配置され、[ 画像の左 ] と [ 画像の上] で設定した値だけオフセットされます。

注:

サポートされているブック形式は .xlsxのみです。

次の画像形式がサポートされています。

• PNG
• JPEG
• GIF
• BMP
• TIFF
• WebP
• PCX

プロジェクトの対応 OS

Windows | クロスプラットフォーム

構成

• ファイル - リソースのブックのフル パスです。ローカル パスに切り替えるには、プラス記号のアイコンを選択し、[ローカル ファイルを使用] を選択します。現在のフィールドが [ファイル (ローカル パス)] に変更され、ブックのフル パスを指定できます。
• Image file - 挿入する画像のリソース ファイルです。ローカル パスに切り替えるには、プラス記号のアイコンを選択し、[ ローカル ファイルを使用] を選択します。現在のフィールドが [画像 (ローカル パス)] に変更され、画像のフル パスを指定できます。
• シート名 - 画像の挿入先のシートです。シートが存在しない場合は、自動的に作成されます。既定値は Sheet1です。
• セル - 画像の左上隅のアンカー セルです。既定値は A1です。

ブックを使用する

• ブック - 使用する既存のブックです。

入力

• 画像の左 - アンカー セルからの水平方向のオフセットです (ピクセル単位)。この値は 0 以上である必要があります。既定値は 0です。
• 画像の上 - アンカー セルからの垂直方向のオフセットです (ピクセル単位)。この値は 0 以上である必要があります。既定値は 0です。
• 画像の幅 - 画像の幅です (ピクセル単位)。この値は 0 以上である必要があります。
• 画像の高さ - 画像の高さです (ピクセル単位)。この値は 0 以上である必要があります。

[画像の幅] と [画像の高さ] の値によって、画像の拡大縮小方法が決まります。

画像幅	画像高さ	結果
未設定	未設定	画像は元のサイズを保ちます。
Set	未設定	高さは比例して拡大縮小され、アスペクト比は維持されます。
未設定	Set	幅は比例して拡大縮小され、アスペクト比は維持されます。
Set	Set	画像には、設定した正確なサイズが使用されます。縦横比は保持されません。

注:

画像は [セル] で指定したセルに固定されるため、画像の配置方法が制限されます。

• [画像の左 ] と [画像の上] はアンカー セルの幅と高さで上限が設定されるため、セルよりも大きいオフセットを指定すると、代わりに画像がセルの端に配置されます。
• アンカーセルのサイズを変更すると、画像は一緒に移動しますが、独自のサイズは維持されます。

このアクティビティでは、2 つのセルの間に画像を固定したり、どのセルからも独立した固定位置に画像を配置したりすることはできません。

オプション

• パスワード - ブックのパスワードです (必要な場合)。