AutoShape class

Represents an AutoShape.

Inheritance:AutoShape → GeometryShape → Shape

The AutoShape type exposes the following members:

Properties

Property	Description
`is_text_holder`	Determines whether the shape is TextHolder_PPT. Read-only bool.
`placeholder`	Returns the placeholder for a shape. Returns None if the shape has no placeholder. Read-only `IPlaceholder`.
`custom_data`	Returns the shape’s custom data. Read-only `ICustomData`.
`raw_frame`	Returns or sets the raw shape frame’s properties. Read/write `IShapeFrame`.
`frame`	Returns or sets the shape frame’s properties. Read/write `IShapeFrame`.
`line_format`	Returns the LineFormat object that contains line formatting properties for a shape. Note: can return None for certain types of shapes which don’t have line properties. Read-only `ILineFormat`.
`three_d_format`	Returns the ThreeDFormat object that 3d effect properties for a shape. Note: can return None for certain types of shapes which don’t have 3d properties. Read-only `IThreeDFormat`.
`effect_format`	Returns the EffectFormat object which contains pixel effects applied to a shape. Note: can return None for certain types of shapes which don’t have effect properties. Read-only `IEffectFormat`.
`fill_format`	Returns the FillFormat object that contains fill formatting properties for a shape. Note: can return None for certain types of shapes which don’t have fill properties. Read-only `IFillFormat`.
`hyperlink_click`	Returns or sets the hyperlink defined for mouse click. Read/write `IHyperlink`.
`hyperlink_mouse_over`	Returns or sets the hyperlink defined for mouse over. Read/write `IHyperlink`.
`hyperlink_manager`	Returns the hyperlink manager. Read-only `IHyperlinkManager`.
`hidden`	Determines whether the shape is hidden. Read/write bool.
`z_order_position`	Returns the position of a shape in the z-order. Shapes[0] returns the shape at the back of the z-order, and Shapes[Shapes.Count - 1] returns the shape at the front of the z-order. Read-only int.
`connection_site_count`	Returns the number of connection sites on the shape. Read-only int.
`rotation`	Returns or sets the number of degrees the specified shape is rotated around the z-axis. A positive value indicates clockwise rotation; a negative value indicates counterclockwise rotation. Read/write float.
`x`	Returns or sets the x-coordinate of the upper-left corner of the shape. Read/write float.
`y`	Returns or sets the y-coordinate of the upper-left corner of the shape. Read/write float.
`width`	Returns or sets the width of the shape. Read/write float.
`height`	Returns or sets the height of the shape. Read/write float.
`black_white_mode`	Property specifies how a shape will render in black-and-white display mode.. Read/write `BlackWhiteMode`.
`unique_id`	Gets unique shape identifier in presentation scope. Read-only int. See also `Shape.office_interop_shape_id` for getting unique shape identifier in slide scope.
`office_interop_shape_id`	Gets unique shape identifier in slide scope. Read-only int. See also `Shape.unique_id` for getting unique shape identifier in presentation scope.
`alternative_text`	Returns or sets the alternative text associated with a shape. Read/write str.
`alternative_text_title`	Returns or sets the title of alternative text associated with a shape. Read/write str.
`name`	Returns or sets the name of a shape. Must be not None. Use empty string value if needed. Read/write str.
`is_decorative`	Gets or sets ‘Mark as decorative’ option Reed/write bool.
`shape_lock`	Returns shape’s locks. Read-only `IAutoShapeLock`.
`is_grouped`	Determines whether the shape is grouped. Read-only bool.
`parent_group`	Returns parent GroupShape object if shape is grouped. Otherwise returns None. Read-only `IGroupShape`.
`slide`	Returns the parent slide of a shape. Read-only `IBaseSlide`.
`presentation`	Returns the parent presentation of a slide. Read-only `IPresentation`.
`shape_style`	Returns shape’s style object. Read-only `IShapeStyle`.
`shape_type`	Returns or sets the geometry preset type. Note: on value changing all adjustment values will reset to their default values. Read/write `ShapeType`.
`adjustments`	Returns a collection of shape’s adjustment values. Read-only `IAdjustValueCollection`.
`auto_shape_lock`	Returns autoshape’s locks. Read-only `IAutoShapeLock`.
`text_frame`	Returns TextFrame object for the AutoShape. Read-only `ITextFrame`.
`use_background_fill`	Determines whether this autoshape should be filled with slide’s background fill instead of specified by style or fill format. Read/write bool.
`is_text_box`	Specifies if the shape is a text box.

Methods

Method	Description
`get_thumbnail`	Returns shape thumbnail. ShapeThumbnailBounds.Shape shape thumbnail bounds type is used by default.
`get_thumbnail`	Returns shape thumbnail.
`get_image`	Returns shape thumbnail. ShapeThumbnailBounds.Shape shape thumbnail bounds type is used by default.
`get_image`	Returns shape thumbnail.
`write_as_svg`	Saves content of Shape as SVG file.
`write_as_svg`	Saves content of Shape as SVG file.
`remove_placeholder`	Defines that this shape isn’t a placeholder.
`add_placeholder`	Adds a new placeholder if there is no and sets placeholder properties to a specified one.
`get_base_placeholder`	Returns a basic placeholder shape (shape from the layout and/or master slide that the current shape is inherited from). A None is returned if the current shape is not inherited.
`get_geometry_paths`	Returns the copy of path of the geometry shape. Coordinates are relative to the left top corner of the shape.
`set_geometry_path`	Updates shape geometry from `IGeometryPath` object. Coordinates must be relative to the left top corner of the shape. Changes the type of the shape (`GeometryShape.shape_type`) to `ShapeType.CUSTOM`.
`set_geometry_paths`	Updates shape geometry from array of `IGeometryPath`. Coordinates must be relative to the left top corner of the shape. Changes the type of the shape (`GeometryShape.shape_type`) to `ShapeType.CUSTOM`.
`create_shape_elements`	Creates and returns array of shape’s elements.
`add_text_frame`	Adds a new TextFrame to a shape. If shape already has TextFrame then simply changes its text.

AutoShape class

AutoShape class

Properties

Methods

See Also