PCQRSCANER/venv/Lib/site-packages/pptx/oxml/chart/legend.py

77 lines
2.1 KiB
Python
Raw Normal View History

2019-12-22 21:51:47 +01:00
# encoding: utf-8
"""
lxml custom element classes for legend-related XML elements.
"""
from __future__ import absolute_import, print_function, unicode_literals
from ...enum.chart import XL_LEGEND_POSITION
from ..text import CT_TextBody
from ..xmlchemy import BaseOxmlElement, OptionalAttribute, ZeroOrOne
class CT_Legend(BaseOxmlElement):
"""
``<c:legend>`` custom element class
"""
_tag_seq = (
"c:legendPos",
"c:legendEntry",
"c:layout",
"c:overlay",
"c:spPr",
"c:txPr",
"c:extLst",
)
legendPos = ZeroOrOne("c:legendPos", successors=_tag_seq[1:])
layout = ZeroOrOne("c:layout", successors=_tag_seq[3:])
overlay = ZeroOrOne("c:overlay", successors=_tag_seq[4:])
txPr = ZeroOrOne("c:txPr", successors=_tag_seq[6:])
del _tag_seq
@property
def defRPr(self):
"""
`./c:txPr/a:p/a:pPr/a:defRPr` great-great-grandchild element, added
with its ancestors if not present.
"""
txPr = self.get_or_add_txPr()
defRPr = txPr.defRPr
return defRPr
@property
def horz_offset(self):
"""
The float value in ./c:layout/c:manualLayout/c:x when
./c:layout/c:manualLayout/c:xMode@val == "factor". 0.0 if that
XPath expression has no match.
"""
layout = self.layout
if layout is None:
return 0.0
return layout.horz_offset
@horz_offset.setter
def horz_offset(self, offset):
"""
Set the value of ./c:layout/c:manualLayout/c:x@val to *offset* and
./c:layout/c:manualLayout/c:xMode@val to "factor". Remove
./c:layout/c:manualLayout if *offset* == 0.
"""
layout = self.get_or_add_layout()
layout.horz_offset = offset
def _new_txPr(self):
return CT_TextBody.new_txPr()
class CT_LegendPos(BaseOxmlElement):
"""
``<c:legendPos>`` element specifying position of legend with respect to
chart as a member of ST_LegendPos.
"""
val = OptionalAttribute("val", XL_LEGEND_POSITION, default=XL_LEGEND_POSITION.RIGHT)