Paper Office
paper-pptxAPI referenceenum.chart

XL_DATA_LABEL_POSITION

paper-pptx 0.2.0 API reference

Specifies where the data label is positioned.

Example::

from pptx.enum.chart import XL_LABEL_POSITION

data_labels = chart.plots[0].data_labels data_labels.position = XL_LABEL_POSITION.OUTSIDE_END

MS API Name: XlDataLabelPosition

http://msdn.microsoft.com/en-us/library/office/ff745082.aspx

Attributes

ABOVE

attributeABOVE
= (0, 't', 'The data label is positioned above the data point.')

The data label is positioned above the data point.

BELOW

attributeBELOW
= (1, 'b', 'The data label is positioned below the data point.')

The data label is positioned below the data point.

BEST_FIT

attributeBEST_FIT
= (5, 'bestFit', 'Word sets the position of the data label.')

Word sets the position of the data label.

CENTER

attributeCENTER
= (-4108, 'ctr', 'The data label is centered on the data point or inside a bar or a pie slice.')

The data label is centered on the data point or inside a bar or a pie slice.

INSIDE_BASE

attributeINSIDE_BASE
= (4, 'inBase', 'The data label is positioned inside the data point at the bottom edge.')

The data label is positioned inside the data point at the bottom edge.

INSIDE_END

attributeINSIDE_END
= (3, 'inEnd', 'The data label is positioned inside the data point at the top edge.')

The data label is positioned inside the data point at the top edge.

LEFT

attributeLEFT
= (-4131, 'l', 'The data label is positioned to the left of the data point.')

The data label is positioned to the left of the data point.

MIXED

attributeMIXED
= (6, '', 'Data labels are in multiple positions (read-only).')

Data labels are in multiple positions (read-only).

OUTSIDE_END

attributeOUTSIDE_END
= (2, 'outEnd', 'The data label is positioned outside the data point at the top edge.')

The data label is positioned outside the data point at the top edge.

attributeRIGHT
= (-4152, 'r', 'The data label is positioned to the right of the data point.')

The data label is positioned to the right of the data point.

xml_value

attributexml_valuestr | None

Functions

from_xml

funcfrom_xml(xml_value: str) -> Self

Enumeration member corresponding to XML attribute value xml_value.

Raises ValueError if xml_value is the empty string ("") or is not an XML attribute value registered on the enumeration. Note that enum members that do not correspond to one of the defined values for an XML attribute have xml_value == "". These "return-value only" members cannot be automatically mapped from an XML attribute value and must be selected explicitly by code, based on the appropriate conditions.

Example::

WD_PARAGRAPH_ALIGNMENT.from_xml("center") WD_PARAGRAPH_ALIGNMENT.CENTER

paramxml_valuestr

Returns

typing_extensions.Self

to_xml

functo_xml(value: int | _T) -> str

XML value of this enum member, generally an XML attribute value.

paramvalueint | _T

Returns

str

validate

funcvalidate(value: _T)

Raise ValueError if value is not an assignable value.

paramvalue_T

On this page