Shape

class Shape(*args, **options)

The shape object is a member of the shapes collection:

>>> import xlwings as xw
>>> sheet = xw.books['Book1'].sheets[0]
>>> sheet.shapes[0]  # or sheet.shapes['ShapeName']
<Shape 'Rectangle 1' in Sheet1>

在 0.9.0 版本发生变更.

activate()

激活形状(shape)。

在 0.5.0 版本加入.

property api: Any

Returns the native object (pywin32 or appscript obj) of the engine being used.

在 0.19.2 版本加入.

delete()

删除形状。

在 0.5.0 版本加入.

async get_text()

Fetch the shape's text on demand.

None if the shape holds no text.

Requires xlwings Lite.

返回类型:

str | None

property height: float

返回或者设置形状的高度，单位是 point 。

在 0.5.0 版本加入.

property left: float

返回或者设置代表形状的水平位置，单位是 point 。

在 0.5.0 版本加入.

property name: str

返回形状的名称

在 0.5.0 版本加入.

property parent: Sheet

返回形状所属的对象。

在 0.9.0 版本加入.

scale_height(factor, relative_to_original_size=False, scale='scale_from_top_left')

参数:

• factor (float) -- For example 1.5 to scale it up to 150%

• relative_to_original_size (bool) -- If False, it scales relative to current height (default). For True must be a picture or OLE object.

• scale (str) -- One of scale_from_top_left (default), scale_from_bottom_right, scale_from_middle

在 0.19.2 版本加入.

scale_width(factor, relative_to_original_size=False, scale='scale_from_top_left')

参数:

• factor (float) -- For example 1.5 to scale it up to 150%

• relative_to_original_size (bool) -- If False, it scales relative to current width (default). For True must be a picture or OLE object.

• scale (str) -- One of scale_from_top_left (default), scale_from_bottom_right, scale_from_middle

在 0.19.2 版本加入.

property text: str

Returns or sets the text of a shape.

Setter type:

Any

在 0.21.4 版本加入.

property top: float

返回或设置形状的垂直位置，单位为 point 。

在 0.5.0 版本加入.

property type: str

返回形状的类型。

在 0.9.0 版本加入.

property width: float

返回或者设置形状的宽度，单位是 point 。

在 0.5.0 版本加入.