插入图片
<p>[TOC]</p>
<h2>1.命令说明</h2>
<p>在工作表中插入图片，如指定图片名称存在，则替换已存在图片</p>
<h2>2.命令原型</h2>
<pre><code>Excel.InsertImage(excelWorkBook, sheet=&quot;Sheet1&quot;, filePath=r&quot;D:\1.png&quot;, name=&quot;&quot;, left=0, top=0, width=100, height=100, isSave=False)</code></pre>
<h2>3.命令参数</h2>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">默认值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">excelWorkBook</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Book</td>
<td style="text-align: left;">无</td>
<td>使用 "打开Excel工作簿"命令（Excel.OpenExcel） 或 "绑定Excel工作簿" 命令（Excel.BindBook）返回的工作簿对象</td>
</tr>
<tr>
<td style="text-align: left;">sheet</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string/int</td>
<td style="text-align: left;">"Sheet1"</td>
<td>如果使用字符串，则表示指定工作表的名字；使用数字，则表示指定工作表的顺序（例如：0、1、2代表从左边开始正数第1、2、3个工作表；-1、-2、-3代表从右边开始倒数第1、2、3个工作表）。默认 "Sheet1"</td>
</tr>
<tr>
<td style="text-align: left;">filePath</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">“D:\\1.png”</td>
<td>要插入的图片文件路径。默认“D:\\1.png”</td>
</tr>
<tr>
<td style="text-align: left;">name</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">""</td>
<td>默认值为空字符串，由Excel自动编排。如需删除或者更新相应图片，建议修改名字。默认 ""</td>
</tr>
<tr>
<td style="text-align: left;">left</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int/float</td>
<td style="text-align: left;">0</td>
<td>图片距离左边的边距。默认0</td>
</tr>
<tr>
<td style="text-align: left;">top</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int/float</td>
<td style="text-align: left;">0</td>
<td>图片距离顶部的边距。默认0</td>
</tr>
<tr>
<td style="text-align: left;">width</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int/float</td>
<td style="text-align: left;">100</td>
<td>图片的宽度，按原图的百分比计算。默认100</td>
</tr>
<tr>
<td style="text-align: left;">height</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int/float</td>
<td style="text-align: left;">100</td>
<td>图片的高度，按原图的百分比计算。默认100</td>
</tr>
<tr>
<td style="text-align: left;">isSave</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">bool</td>
<td style="text-align: left;">False</td>
<td>操作完成立即保存。默认False</td>
</tr>
</tbody>
</table>
<h2>4.返回结果</h2>
<p>无（None值）</p>
<h2>5.运行实例</h2>
<pre><code>&quot;&quot;&quot;
/******************插入图片****************
入参：
excelWorkBook:[必选参数]使用 &quot;打开Excel工作簿&quot;命令（Excel.OpenExcel） 或 &quot;绑定Excel工作簿&quot; 命令（Excel.BindBook）返回的工作簿对象
sheet:[可选参数]如果使用字符串，则表示指定工作表的名字；使用数字，则表示指定工作表的顺序（例如：0、1、2代表从左边开始正数第1、2、3个工作表；-1、-2、-3代表从右边开始倒数第1、2、3个工作表）。默认&quot;Sheet1&quot;
filePath:[可选参数]要插入的图片文件路径。默认r&quot;D:\1.png&quot;
name:[可选参数]默认值为空字符串，由Excel自动编排。如需删除或者更新相应图片，建议修改名字。默认&quot;&quot;
left:[可选参数]图片距离左边的边距。默认0
top:[可选参数]图片距离顶部的边距。默认0
width:[可选参数]图片的宽度，按原图的百分比计算。默认100
height:[可选参数]图片的高度，按原图的百分比计算。默认100
isSave:[可选参数]操作完成立即保存。默认False
出参：
无（None值）
注意事项：
该命令不能单独使用，需配合 &quot;打开Excel&quot;命令（Excel.OpenExcel） 或&quot;绑定Excel&quot;命令（Excel.BindBook）一起使用才能正常使用，单独使用则会报错。
********************************************/
&quot;&quot;&quot;
# 打开D:\1.xlsx
excelWorkBook = Excel.OpenExcel(r'D:\1.xlsx', visible=True, appType=&quot;Excel&quot;, pwd=&quot;&quot;, writePwd=&quot;&quot;)
# Excel对象Sheet1工作表插入一张图片命名为&quot;图示&quot;，且保存文件
Excel.InsertImage(excelWorkBook, sheet=&quot;Sheet1&quot;, filePath=r&quot;D:\图示.png&quot;, name=&quot;图示&quot;, left=0, top=0, width=100, height=100, isSave=True)</code></pre>