1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55
|
# encoding: utf-8
"""
Objects shared by modules in the docx.oxml subpackage.
"""
from __future__ import absolute_import
from . import OxmlElement
from .ns import qn
from .simpletypes import ST_DecimalNumber, ST_OnOff, ST_String
from .xmlchemy import BaseOxmlElement, OptionalAttribute, RequiredAttribute
class CT_DecimalNumber(BaseOxmlElement):
"""
Used for ``<w:numId>``, ``<w:ilvl>``, ``<w:abstractNumId>`` and several
others, containing a text representation of a decimal number (e.g. 42) in
its ``val`` attribute.
"""
val = RequiredAttribute('w:val', ST_DecimalNumber)
@classmethod
def new(cls, nsptagname, val):
"""
Return a new ``CT_DecimalNumber`` element having tagname *nsptagname*
and ``val`` attribute set to *val*.
"""
return OxmlElement(nsptagname, attrs={qn('w:val'): str(val)})
class CT_OnOff(BaseOxmlElement):
"""
Used for ``<w:b>``, ``<w:i>`` elements and others, containing a bool-ish
string in its ``val`` attribute, xsd:boolean plus 'on' and 'off'.
"""
val = OptionalAttribute('w:val', ST_OnOff, default=True)
class CT_String(BaseOxmlElement):
"""
Used for ``<w:pStyle>`` and ``<w:tblStyle>`` elements and others,
containing a style name in its ``val`` attribute.
"""
val = RequiredAttribute('w:val', ST_String)
@classmethod
def new(cls, nsptagname, val):
"""
Return a new ``CT_String`` element with tagname *nsptagname* and
``val`` attribute set to *val*.
"""
elm = OxmlElement(nsptagname)
elm.val = val
return elm
|