Chart class

Represents an graphic chart on a slide.

Inheritance:Chart → GraphicalObject → Shape

The Chart 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 `IGraphicalObjectLock`.
`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`.
`graphical_object_lock`	Returns shape’s locks. Read-only `IGraphicalObjectLock`.
`plot_visible_cells_only`	Determines whether the only visible cells are plotted. False to plot both visible and hidden cells. Read/write bool.
`display_blanks_as`	Returns or sets the way to plot blank cells on a chart. Read/write `DisplayBlanksAsType`.
`chart_data`	Returns information about the linked or embedded data associated with a chart. Read-only `IChartData`.
`has_title`	Determines whether a chart has a visible title. Read/write bool.
`chart_title`	Returns or sets a chart title. Read-only `IChartTitle`.
`has_data_table`	Determines whether a chart has a data table. Read/write bool.
`has_legend`	Determines whether a chart has a legend. Read/write bool.
`legend`	Returns or sets a legend for a chart. Read-only `ILegend`.
`chart_data_table`	Returns a data table of a chart. Read-only `IDataTable`.
`style`	Returns or sets the chart style. Read/write `StyleType`.
`type`	Returns or sets the chart type. Read/write `ChartType`.
`plot_area`	Represents the plot area of a chart. Read-only `IChartPlotArea`.
`rotation_3d`	Returns a 3D rotation of a chart. Read-only `IRotation3D`.
`back_wall`	Returns an object which allows to change format of the back wall of a 3D chart. Read-only `IChartWall`.
`side_wall`	Returns an object which allows to change format of the side wall of a 3D chart. Read-only `IChartWall`.
`floor`	Returns an object which allows to change format of the floor of a 3D chart. Read-only `IChartWall`.
`text_format`	Returns chart text format. The property is not applicable for the following types: `ChartType.TREEMAP`, `ChartType.SUNBURST`, `ChartType.WATERFALL`, `ChartType.HISTOGRAM`, `ChartType.FUNNEL`,`ChartType.BOX_AND_WHISKER`. Read-only `IChartTextFormat`.
`theme_manager`	Returns theme manager. Read-only `IOverrideThemeManager`.
`user_shapes`	Specify the shapes drawn on top of the chart. Read-only `IGroupShape`.
`axes`	Provide access to chart axes. Read-only `IAxesManager`.
`show_data_labels_over_maximum`	Specifies data labels over the maximum of the chart shall be shown. Read/write bool.
`has_rounded_corners`	Specifies the chart area shall have rounded corners. Read/write bool.
`chart`

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.
`validate_chart_layout`	Calculates actual values of chart elements. The actual values include position of elements that implement IActualLayout interface (IActualLayout.ActualX, IActualLayout.ActualY, IActualLayout.ActualWidth, IActualLayout.ActualHeight) and actual axes values (IAxis.ActualMaxValue, IAxis.ActualMinValue, IAxis.ActualMajorUnit, IAxis.ActualMinorUnit, IAxis.ActualMajorUnitScale, IAxis.ActualMinorUnitScale)
`create_theme_effective`	Returns an effective theme for this chart.

Chart class

Chart class

Properties

Methods

See Also