Pictures¶

类 Pictures(实现)¶

所有对象的集合picture指定工作表上的对象：

>>> import xlwings as xw
>>> xw.books['Book1'].sheets[0].pictures
Pictures([<Picture 'Picture 1' in <Sheet [Book1]Sheet1>>,
          <Picture 'Picture 2' in <Sheet [Book1]Sheet1>>])

在版本 0.9.0 中添加。

添加(图像, 链接到文件=False, 与文档一起保存=True, 左侧=None, 顶部=None, 宽度=None, 高度=None, 名称=None, 更新=False, 缩放=None, 格式=None, 锚点=None, 导出选项=None)¶

向指定的工作表添加一张图片。

参数¶

图像字符串或路径类对象或 matplotlib.figure.Figure: 文件路径或 Matplotlib 图形对象。
左侧浮点数，默认为 None: 左侧位置（以点为单位），默认为 0。如果使用top/left，则不得为anchor.
顶部浮点数，默认为 None: 顶部位置（以点为单位），默认为 0。如果使用top/left，则不得为anchor.
宽度浮点数，默认为 None: 宽度（以点为单位）。默认为原始宽度。
高度浮点数，默认为 None: 高度（以点为单位）。默认为原始高度。
名称字符串，默认值为 None: Excel 图片名称。如果不提供，则默认为 Excel 标准名称，例如“图片 1”。
更新布尔值，默认为False: 替换具有相同名称的现有图片。需要name进行设置。
缩放浮点数，默认为 None: 按提供的因子缩放图片。
格式字符串，默认值为 None: 仅在图片是 Matplotlib 或 Plotly 图表时使用。默认情况下，图表以“png”格式插入，但您可以将其更改为基于矢量的格式，如 Windows 上的“svg”（可能需要 Microsoft 365）或 macOS 上的“eps”，以获得更好的打印质量。如果使用'vector'，它将在 macOS 上使用'svg'在Windows上和'eps'。要了解您的 Excel 版本支持哪些格式，请参见：https://support.microsoft.com/en-us/topic/support-for-eps-images-has-been-turned-off-in-office-a069d664-4bcf-415e-a1b5-cbb0c334a840
anchor: xw.Range，默认为 None: 您希望插入图片的 xlwings 范围对象。如果使用anchor，则不得为top/left.

在版本0.24.3中添加。
导出选项字典，默认值为 None: 对于 Matplotlib 图表，此字典将传递给image.savefig()并使用以下默认值：{"bbox_inches": "tight", "dpi": 200}，因此，如果希望图片保持未裁剪并增加 dpi 至 300，请使用：export_options={"dpi": 300}。对于 Plotly，选项将传递给write_image().

在版本 0.27.7 中新增。

返回值¶

Picture

示例¶

Picture

>>> import xlwings as xw
>>> sht = xw.Book().sheets[0]
>>> sht.pictures.add(r'C:\path\to\file.png')
<Picture 'Picture 1' in <Sheet [Book1]Sheet1>>

Matplotlib

>>> import matplotlib.pyplot as plt
>>> fig = plt.figure()
>>> plt.plot([1, 2, 3, 4, 5])
>>> sht.pictures.add(fig, name='MyPlot', update=True)
<Picture 'MyPlot' in <Sheet [Book1]Sheet1>>

属性 api¶: 返回所使用引擎的原生对象 (pywin32或appscriptobj) 使用的引擎的成员。

属性计数¶: 返回集合中对象的数量。