Shape

class Shape(*args, **options)

Shapeオブジェクトは shapes コレクションのメンバーです:

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

バージョン 0.9.0 で変更.

activate()

Shapeをアクティブにします。

Added in version 0.5.0.

property api

使用しているエンジンのネイティブ オブジェクト(pywin32 オブジェクトまたは appscript オブジェクト)を返します。

Added in version 0.19.2.

delete()

Shapeを削除します。

Added in version 0.5.0.

property height

Shapeの高さを表すポイント単位の数値を取得または設定します。

Added in version 0.5.0.

property left

Shapeの水平位置を表すポイント単位の数値を取得または設定します。

Added in version 0.5.0.

property name

Shapeの名前を取得または設定します。

Added in version 0.5.0.

property parent

Shapeの親オブジェクトを返します。

Added in version 0.9.0.

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

factorfloat

例えば、1.5なら150%に拡大します。

relative_to_original_sizebool, optional

False の場合、現在の高さからの相対的な大きさで拡大縮小します (デフォルト)。True は図またはOLE objectでなければなりません。

scalestr, optional

scale_from_top_left (デフォルト)、 scale_from_bottom_right 、 scale_from_middle のいずれか。

Added in version 0.19.2.

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

factorfloat

例えば、1.5なら150%に拡大します。

relative_to_original_sizebool, optional

False の場合、現在の幅からの相対的な大きさで拡大縮小します (デフォルト)。True は図またはOLE objectでなければなりません。

scalestr, optional

scale_from_top_left (デフォルト)、 scale_from_bottom_right 、 scale_from_middle のいずれか。

Added in version 0.19.2.

property text

Shapeのテキストを取得または設定します。

Added in version 0.21.4.

property top

Shapeの垂直位置を表すポイント単位の数値を取得または設定します。

Added in version 0.5.0.

property type

Shapeの種類を返します。

Added in version 0.9.0.

property width

Shapeの幅を表すポイント単位の数値を取得または設定します。

Added in version 0.5.0.