def new(cls, text):
"""
Return a new ``<w:t>`` element.
"""
t = OxmlElement('w:t')
t.text = text
return t
def new(cls, pic_id, image_filename):
nvPicPr = OxmlElement('pic:nvPicPr')
nvPicPr.append(CT_NonVisualDrawingProps.new(
'pic:cNvPr', pic_id, image_filename
))
nvPicPr.append(CT_NonVisualPictureProperties.new())
return nvPicPr
def new(cls, text):
"""
Return a new ``<w:t>`` element.
"""
t = OxmlElement('w:t')
t.text = text
return t
def new(cls):
"""
Return a new ``<w:tc>`` element, containing an empty paragraph as the
required EG_BlockLevelElt.
"""
tc = OxmlElement('w:tc')
p = CT_P.new()
tc.append(p)
return tc
def add_drawing(self, inline_or_anchor):
"""
Return a newly appended ``CT_Drawing`` (``<w:drawing>``) child
element having *inline_or_anchor* as its child.
"""
drawing = OxmlElement('w:drawing')
self.append(drawing)
drawing.append(inline_or_anchor)
return drawing
def new(cls):
"""
Return a new ``<w:tc>`` element, containing an empty paragraph as the
required EG_BlockLevelElt.
"""
tc = OxmlElement('w:tc')
p = CT_P.new()
tc.append(p)
return tc
def add_drawing(self, inline_or_anchor):
"""
Return a newly appended ``CT_Drawing`` (``<w:drawing>``) child
element having *inline_or_anchor* as its child.
"""
drawing = OxmlElement('w:drawing')
self.append(drawing)
drawing.append(inline_or_anchor)
return drawing
def new(cls, num_id, abstractNum_id):
"""
Return a new ``<w:num>`` element having numId of *num_id* and having
a ``<w:abstractNumId>`` child with val attribute set to
*abstractNum_id*.
"""
abstractNumId = CT_DecimalNumber.new('w:abstractNumId', abstractNum_id)
num = OxmlElement('w:num', {qn('w:numId'): str(num_id)})
num.append(abstractNumId)
return num
def new(cls):
"""
Return a new ``<w:tbl>`` element, containing the required
``<w:tblPr>`` and ``<w:tblGrid>`` child elements.
"""
tbl = OxmlElement('w:tbl')
tblPr = CT_TblPr.new()
tbl.append(tblPr)
tblGrid = CT_TblGrid.new()
tbl.append(tblGrid)
return tbl
def new(cls, pic_id, filename, rId, cx, cy):
"""
Return a new ``<pic:pic>`` element populated with the minimal
contents required to define a viable picture element, based on the
values passed as parameters.
"""
pic = OxmlElement('pic:pic', nsmap=nspfxmap('pic', 'r'))
pic.append(CT_PictureNonVisual.new(pic_id, filename))
pic.append(CT_BlipFillProperties.new(rId))
pic.append(CT_ShapeProperties.new(cx, cy))
return pic
def new(cls, num_id, abstractNum_id):
"""
Return a new ``<w:num>`` element having numId of *num_id* and having
a ``<w:abstractNumId>`` child with val attribute set to
*abstractNum_id*.
"""
abstractNumId = CT_DecimalNumber.new(
'w:abstractNumId', abstractNum_id
)
num = OxmlElement('w:num', {qn('w:numId'): str(num_id)})
num.append(abstractNumId)
return num
def add_rtl(self):
"""
Return a newly added <w:rtl/> child element.
"""
rtl = OxmlElement('w:rtl')
self.insert(0, rtl)
return rtl
def add_iCs(self):
"""
Return a newly added <w:iCs/> child element.
"""
iCs = OxmlElement('w:iCs')
self.insert(0, iCs)
return iCs
def add_oMath(self):
"""
Return a newly added <w:oMath/> child element.
"""
oMath = OxmlElement('w:oMath')
self.insert(0, oMath)
return oMath
def add_imprint(self):
"""
Return a newly added <w:imprint/> child element.
"""
imprint = OxmlElement('w:imprint')
self.insert(0, imprint)
return imprint
def _add_u(self):
"""
Return a newly added <w:u/> child element.
"""
u = OxmlElement('w:u')
self.insert(0, u)
return u
def add_smallCaps(self):
"""
Return a newly added <w:smallCaps/> child element.
"""
smallCaps = OxmlElement('w:smallCaps')
self.insert(0, smallCaps)
return smallCaps
def add_shadow(self):
"""
Return a newly added <w:shadow/> child element.
"""
shadow = OxmlElement('w:shadow')
self.insert(0, shadow)
return shadow
def add_specVanish(self):
"""
Return a newly added <w:specVanish/> child element.
"""
specVanish = OxmlElement('w:specVanish')
self.insert(0, specVanish)
return specVanish
def add_snapToGrid(self):
"""
Return a newly added <w:snapToGrid/> child element.
"""
snapToGrid = OxmlElement('w:snapToGrid')
self.insert(0, snapToGrid)
return snapToGrid
def add_strike(self):
"""
Return a newly added <w:strike/> child element.
"""
strike = OxmlElement('w:strike')
self.insert(0, strike)
return strike
def add_vanish(self):
"""
Return a newly added <w:vanish/> child element.
"""
vanish = OxmlElement('w:vanish')
self.insert(0, vanish)
return vanish
def add_webHidden(self):
"""
Return a newly added <w:webHidden/> child element.
"""
webHidden = OxmlElement('w:webHidden')
self.insert(0, webHidden)
return webHidden
def add_noProof(self):
"""
Return a newly added <w:noProof/> child element.
"""
noProof = OxmlElement('w:noProof')
self.insert(0, noProof)
return noProof
def add_outline(self):
"""
Return a newly added <w:outline/> child element.
"""
outline = OxmlElement('w:outline')
self.insert(0, outline)
return outline
def add_cs(self):
"""
Return a newly added <w:cs/> child element.
"""
cs = OxmlElement('w:cs')
self.insert(0, cs)
return cs
def add_emboss(self):
"""
Return a newly added <w:emboss/> child element.
"""
emboss = OxmlElement('w:emboss')
self.insert(0, emboss)
return emboss
def add_i(self):
"""
Return a newly added <w:i/> child element.
"""
i = OxmlElement('w:i')
self.insert(0, i)
return i
def add_caps(self):
"""
Return a newly added <w:caps/> child element.
"""
caps = OxmlElement('w:caps')
self.insert(0, caps)
return caps
def add_bCs(self):
"""
Return a newly added <w:bCs/> child element.
"""
bCs = OxmlElement('w:bCs')
self.insert(0, bCs)
return bCs
def add_b(self):
"""
Return a newly added <w:b/> child element.
"""
b = OxmlElement('w:b')
self.insert(0, b)
return b
def new(cls, cx, cy, shape_id, pic):
"""
Return a new ``<wp:inline>`` element populated with the values passed
as parameters.
"""
name = 'Picture %d' % shape_id
uri = nsmap['pic']
inline = OxmlElement('wp:inline', nsmap=nspfxmap('wp', 'r'))
inline.append(CT_PositiveSize2D.new('wp:extent', cx, cy))
inline.append(CT_NonVisualDrawingProps.new('wp:docPr', shape_id, name))
inline.append(CT_GraphicalObject.new(uri, pic))
return inline
def new(cls, pic_id, filename, rId, cx, cy):
"""
Return a new ``<pic:pic>`` element populated with the minimal
contents required to define a viable picture element, based on the
values passed as parameters.
"""
pic = OxmlElement('pic:pic', nsmap=nspfxmap('pic', 'r'))
pic.append(CT_PictureNonVisual.new(pic_id, filename))
pic.append(CT_BlipFillProperties.new(rId))
pic.append(CT_ShapeProperties.new(cx, cy))
return pic
def new(cls):
"""
Return a new ``<w:tbl>`` element, containing the required
``<w:tblPr>`` and ``<w:tblGrid>`` child elements.
"""
tbl = OxmlElement('w:tbl')
tblPr = CT_TblPr.new()
tbl.append(tblPr)
tblGrid = CT_TblGrid.new()
tbl.append(tblGrid)
return tbl
def new(cls, cx, cy, shape_id, pic):
"""
Return a new ``<wp:inline>`` element populated with the values passed
as parameters.
"""
name = 'Picture %d' % shape_id
uri = nsmap['pic']
inline = OxmlElement('wp:inline', nsmap=nspfxmap('wp', 'r'))
inline.append(CT_PositiveSize2D.new('wp:extent', cx, cy))
inline.append(CT_NonVisualDrawingProps.new(
'wp:docPr', shape_id, name
))
inline.append(CT_GraphicalObject.new(uri, pic))
return inline
def new(cls, nsptagname_str, shape_id, name):
elt = OxmlElement(nsptagname_str)
elt.set('id', str(shape_id))
elt.set('name', name)
return elt
def new(cls):
"""
Return a new ``<w:rPr>`` element.
"""
return OxmlElement('w:rPr')
def new(cls, nsptagname_str, x, y):
elm = OxmlElement(nsptagname_str)
elm.set('x', str(x))
elm.set('y', str(y))
return elm
def new(cls, prst):
prstGeom = OxmlElement('a:prstGeom')
prstGeom.set('prst', prst)
return prstGeom
def new(cls, nsptagname_str, cx, cy):
elm = OxmlElement(nsptagname_str)
elm.set('cx', str(cx))
elm.set('cy', str(cy))
return elm
def new(cls, rId):
blip = OxmlElement('a:blip')
blip.set(qn('r:embed'), rId)
return blip
def new(cls, cx, cy):
spPr = OxmlElement('pic:spPr')
spPr.append(CT_Transform2D.new(cx, cy))
spPr.append(CT_PresetGeometry2D.new('rect'))
return spPr
def new(cls, cx, cy):
spPr = OxmlElement('a:xfrm')
spPr.append(CT_Point2D.new('a:off', 0, 0))
spPr.append(CT_PositiveSize2D.new('a:ext', cx, cy))
return spPr
def new(cls):
stretch = OxmlElement('a:stretch')
stretch.append(CT_RelativeRect.new())
return stretch
def new(cls, rId):
blipFill = OxmlElement('pic:blipFill')
blipFill.append(CT_Blip.new(rId))
blipFill.append(CT_StretchInfoProperties.new())
return blipFill
def new(cls, uri, pic):
graphic = OxmlElement('a:graphic')
graphic.append(CT_GraphicalObjectData.new(uri, pic))
return graphic
def new(cls, uri, pic):
graphicData = OxmlElement('a:graphicData')
graphicData.set('uri', uri)
graphicData.append(pic)
return graphicData
def new(cls, ilvl):
"""
Return a new ``<w:lvlOverride>`` element having its ``ilvl``
attribute set to *ilvl*.
"""
return OxmlElement('w:lvlOverride', {qn('w:ilvl'): str(ilvl)})
def new(cls):
return OxmlElement('w:tab')
