Paper Office
paper-pptxAPI referencechart.plot

BarPlot

paper-pptx 0.2.0 API reference

A bar chart-style plot.

Attributes

categories

attributecategories

Returns a category.Categories sequence object containing a category.Category object for each of the category labels associated with this plot. The category.Category class derives from str, so the returned value can be treated as a simple sequence of strings for the common case where all you need is the labels in the order they appear on the chart. category.Categories provides additional properties for dealing with hierarchical categories when required.

chart

attributechart

The Chart object containing this plot.

data_labels

attributedata_labels

DataLabels instance providing properties and methods on the collection of data labels associated with this plot.

gap_width

attributegap_width

Width of gap between bar(s) of each category, as an integer percentage of the bar width. The default value for a new bar chart is 150, representing 150% or 1.5 times the width of a single bar.

has_data_labels

attributehas_data_labels

Read/write boolean, True if the series has data labels. Assigning True causes data labels to be added to the plot. Assigning False removes any existing data labels.

overlap

attributeoverlap

Read/write int value in range -100..100 specifying a percentage of the bar width by which to overlap adjacent bars in a multi-series bar chart. Default is 0. A setting of -100 creates a gap of a full bar width and a setting of 100 causes all the bars in a category to be superimposed. A stacked bar plot has overlap of 100 by default.

series

attributeseries

A sequence of Series objects representing the series in this plot, in the order they appear in the plot.

vary_by_categories

attributevary_by_categories

Read/write boolean value specifying whether to use a different color for each of the points in this plot. Only effective when there is a single series; PowerPoint automatically varies color by series when more than one series is present.

On this page