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をアクティブにします。

バージョン 0.5.0 で追加.

property api#

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

バージョン 0.19.2 で追加.

delete()#

Shapeを削除します。

バージョン 0.5.0 で追加.

property height#

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

バージョン 0.5.0 で追加.

property left#

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

バージョン 0.5.0 で追加.

property name#

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

バージョン 0.5.0 で追加.

property parent#

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

バージョン 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_rightscale_from_middle のいずれか。

バージョン 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_rightscale_from_middle のいずれか。

バージョン 0.19.2 で追加.

property text#

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

バージョン 0.21.4 で追加.

property top#

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

バージョン 0.5.0 で追加.

property type#

Shapeの種類を返します。

バージョン 0.9.0 で追加.

property width#

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

バージョン 0.5.0 で追加.