+ iOa0t$Rt^RIHt^RIHt^RIHtHtH t H t H t ^RI H t ^RIHt^RIHtHtHt^RIHt^RIHt^R IHtHtHt^R IHt^R IHt^R I H!t!H"t"H#t#H$t$H%t%^R I&H't'H(t(Rt)R]*R&!RR]!4t+!RR]!4t,!RR]!4t-!RR]!4t.!RR]!4t/!RR]!4t0!RR4t1R#) z'Section-related custom element classes.) annotations)deepcopy)CallableIteratorListSequencecast)etree) TypeAlias)WD_HEADER_FOOTERWD_ORIENTATIONWD_SECTION_START)nsmap)CT_OnOff)ST_SignedTwipsMeasureST_TwipsMeasure XsdString)CT_Tbl)CT_P)BaseOxmlElementOptionalAttributeRequiredAttribute ZeroOrMore ZeroOrOne)Length lazypropertyz CT_P | CT_Tblr BlockElementc]tRt^t$RtR]R&R]R&R]R&R]R &]!R RR 7t]!R RR 7t] R Rl4t Rt R#) CT_HdrFtrzN`w:hdr` and `w:ftr`, the root element for header and footer part respectively.zCallable[[], CT_P]add_pz List[CT_P]p_lstz List[CT_Tbl]tbl_lstzCallable[[CT_Tbl], CT_Tbl] _insert_tblzw:p successorszw:tblcV^8dQhRR/#)returnzList[CT_P | CT_Tbl])formats"W/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/docx/oxml/section.py __annotate__CT_HdrFtr.__annotate__*s--(;-c $VPR4#)zGenerate all `w:p` and `w:tbl` elements in this header or footer. Elements appear in document order. Elements shaded by nesting in a `w:ins` or other "wrapper" element will not be included. z./w:p | ./w:tbl)xpathselfs&r*inner_content_elements CT_HdrFtr.inner_content_elements)szz+,,r-r(N) __name__ __module__ __qualname____firstlineno____doc____annotations__rptblpropertyr2__static_attributes__r(r-r*rrsGX   ++5R(A W ,C --r-rcT]tRt^3t$Rt]!R]4tR]R&]!R] 4t R]R&Rt R #) CT_HdrFtrRefz5`w:headerReference` and `w:footerReference` elements.w:typer type_zr:idstrrIdr(N) r4r5r6r7r8rr rAr9rrCr=r(r-r*r?r?3s0?/"E !3C3r-r?c]tRt^`` element, defining page margins.zw:top Length | Nonetopzw:rightrightzw:bottombottomzw:leftleftzw:headerheaderzw:footerfooterzw:guttergutterr(N)r4r5r6r7r8rrrGr9rrHrIrJrKrLrMr=r(r-r*rErE<s7*&C-?E=.)FM,/D-.OFM.OFM.OFMr-rEc]tRt^Vt$Rt]!R]4tR]R&]!R]4t R]R&]!R] ] PR7t R ]R &R t R #) CT_PageSzz?```` element, defining page dimensions and orientation.zw:wrFwzw:hhzw:orient)defaultr orientr(N)r4r5r6r7r8rrrPr9rQr PORTRAITrSr=r(r-r*rOrOVsSI( A}) A}/NN,C,CFNr-rOc]tRt^dt$RtR]R&R]R&R]R&R]R &R ]R &R ]R &R ]R&R ]R&Rgt]!R]R7t]!R]R7t ] !R]R,R7t R]R&] !R]R,R7t R]R&] !R]R,R7t R]R&] !R]R ,R7tR!]R"&AR#R$ltR%R&lt]R'R(l4t]P&R)R*l4tR+R,lt]R-R.l4t]P&R/R0l4tR1R2ltR3R4lt]R5R6l4t]P&R7R8l4t]R9R:l4t]P&R;R<l4tR=R>lt]R?R@l4t]P&RARBl4t]RCRDl4t]P&RERFl4t]RGRHl4t]P&RIRJl4t]RKRLl4t]P&RMRNl4t]RORPl4tRQRRlt RSRTlt!]RURVl4t"]"P&RWRXl4t"]RYRZl4t#]#P&R[R\l4t#]R]R^l4t$]$P&R_R`l4t$]RaRbl4t%]%P&RcRdl4t%Ret&Rf#)h CT_SectPrzA`w:sectPr` element, the container element for section properties.zCallable[[], CT_PageMar]get_or_add_pgMarzCallable[[], CT_PageSz]get_or_add_pgSzzCallable[[], CT_OnOff]get_or_add_titlePgzCallable[[], CT_SectType]get_or_add_typezCallable[[], CT_HdrFtrRef]_add_footerReference_add_headerReferencezCallable[[], None]_remove_titlePg _remove_typer@w:pgSzw:pgMar w:titlePgzw:headerReferencer#zw:footerReference:NNzCT_SectType | Nonetype:NNzCT_PageSz | NonepgSz:NNzCT_PageMar | NonepgMar:NNzCT_OnOff | NonetitlePgc$V^8dQhRRRRRR/#r&rAr rCrBr'r?r()r)s"r*r+CT_SectPr.__annotate__")9 r-c >VP4pWnW#nV#)zhReturn newly added CT_HdrFtrRef element of `type_` with `rId`. The element tag is `w:footerReference`. )r[rArC)r1rArCfooterReferences&&& r*add_footerReferenceCT_SectPr.add_footerReference$ 335 %!r-c$V^8dQhRRRRRR/#rkr()r)s"r*r+rlrmr-c >VP4pWnW#nV#)zhReturn newly added CT_HdrFtrRef element of `type_` with `rId`. The element tag is `w:headerReference`. )r\rArC)r1rArCheaderReferences&&& r*add_headerReferenceCT_SectPr.add_headerReferencerrr-cV^8dQhRR/#r&r'rFr()r)s"r*r+rls}r-c >VPpVfR#VP#)zValue of the `w:bottom` attr of `` child element, as |Length|. |None| when either the element or the attribute is not present. N)rgrIr1rgs& r* bottom_marginCT_SectPr.bottom_margins   =||r-cV^8dQhRR/#r&valuezint | Length | Noner()r)s"r*r+rls^^#6^r-c VP4pVe\V\4'd WnR#\V4VnR#N)rW isinstancerrIr1rrgs&& r*r|r}2%%' % E61J1Ju PVW\P] r-cV^8dQhRR/#)r&r'rVr()r)s"r*r+rlsyr-c P\V4pVPP4V#)zReturn an exact duplicate of this ```` element tree suitable for use in adding a section break. All rsid* attributes are removed from the root ```` element. )rattribclear)r1 cloned_sectPrs& r*cloneCT_SectPr.clones% ! ""$r-cV^8dQhRR/#ryr()r)s"r*r+rls   r-c >VPpVfR#VP#)zDistance from bottom edge of page to bottom edge of the footer. This is the value of the `w:footer` attribute in the `w:pgMar` child element, as a |Length| object, or |None| if either the element or the attribute is not present. N)rgrLr{s& r*rLCT_SectPr.footers  =||r-cV^8dQhRR/#rr()r)s"r*r+rl^^/^r-c VP4pVe\V\4'd WnR#\V4VnR#r)rWrrrLrs&& r*rLrrr-c V^8dQhRRRR/#r&rAr r'zCT_HdrFtrRef | Noner()r)s"r*r+rls##)9#>Q#r-c R\P!V4,pVPV4pV'gR#V^,#)zAReturn footerReference element of `type_` or None if not present.z!./w:footerReference[@w:type='%s']N)r to_xmlr/)r1rApathfooterReferencess&& r*get_footerReferenceCT_SectPr.get_footerReferences825E5L5LU5SS::d+""r-c V^8dQhRRRR/#rr()r)s"r*r+rls,,)9,>Q,r-c VPR\P!V4,4p\V4^8XdR#V^,#)zAReturn headerReference element of `type_` or None if not present.z!./w:headerReference[@w:type='%s']N)r/r rlen)r1rAmatching_headerReferencess&& r*get_headerReferenceCT_SectPr.get_headerReferencesC$(JJ /2B2I2I%2P P% ! ( )Q .(++r-cV^8dQhRR/#ryr()r)s"r*r+rls r-c >VPpVfR#VP#)zThe value of the ``w:gutter`` attribute in the ```` child element, as a |Length| object, or |None| if either the element or the attribute is not present.N)rgrMr{s& r*rMCT_SectPr.gutters   =||r-cV^8dQhRR/#rr()r)s"r*r+rlrr-c VP4pVe\V\4'd WnR#\V4VnR#r)rWrrrMrs&& r*rMrrr-cV^8dQhRR/#ryr()r)s"r*r+rls   r-c >VPpVfR#VP#)zDistance from top edge of page to top edge of header. This value comes from the `w:header` attribute on the `w:pgMar` child element. |None| if either the element or the attribute is not present. N)rgrKr{s& r*rKCT_SectPr.headers  =||r-cV^8dQhRR/#rr()r)s"r*r+rlrr-c VP4pVe\V\4'd WnR#\V4VnR#r)rWrrrKrs&& r*rKrrr-cV^8dQhRR/#)r&r'zIterator[CT_P | CT_Tbl]r()r)s"r*r+rlsHH$;Hr-c ,\PV4#)zGenerate all `w:p` and `w:tbl` elements in this section. Elements appear in document order. Elements shaded by nesting in a `w:ins` or other "wrapper" element will not be included. )_SectBlockElementIteratoriter_sect_block_elementsr0s&r*iter_inner_contentCT_SectPr.iter_inner_contents )AA$GGr-cV^8dQhRR/#ryr()r)s"r*r+rls]r-c >VPpVfR#VP#)zThe value of the ``w:left`` attribute in the ```` child element, as a |Length| object, or |None| if either the element or the attribute is not present.N)rgrJr{s& r* left_marginCT_SectPr.left_margins   =zzr-cV^8dQhRR/#rr()r)s"r*r+rls\\!4\r-c VP4pVe\V\4'd WnR#\V4VnR#r)rWrrrJrs&& r*rrs0%%'#mz%/H/HU fUZm r-cV^8dQhRR/#)r&r'r r()r)s"r*r+rls  ^ r-c ZVPpVf\P#VP#)z`WD_ORIENTATION` member indicating page-orientation for this section. This is the value of the `orient` attribute on the `w:pgSz` child, or `WD_ORIENTATION.PORTRAIT` if not present. )rer rTrSr1res& r* orientationCT_SectPr.orientations(yy <!** *{{r-cV^8dQhRR/#)r&rzWD_ORIENTATION | Noner()r)s"r*r+rl+sBB!6Br-c pVP4pV'd WnR#\PVnR#r)rXr rTrSr1rres&& r*rr*s###%$e .*A*A r-cV^8dQhRR/#ryr()r)s"r*r+rl0s]r-c >VPpVfR#VP#)zYValue in EMU of the `h` attribute of the `w:pgSz` child element. |None| if not present. N)rerQrs& r* page_heightCT_SectPr.page_height/ yy <vv r-cV^8dQhRR/#r&rrFr()r)s"r*r+rl;sr-c 2VP4pWnR#r)rXrQrs&& r*rr:##%r-cV^8dQhRR/#ryr()r)s"r*r+rl@sMr-c >VPpVfR#VP#)z_Value in EMU of the ``w`` attribute of the ```` child element. |None| if not present. N)rerPrs& r* page_widthCT_SectPr.page_width?rr-cV^8dQhRR/#rr()r)s"r*r+rlKs r-c 2VP4pWnR#r)rXrPrs&& r*rrJrr-cV^8dQhRR/#)r&r'zCT_SectPr | Noner()r)s"r*r+rlPsLL"2Lr-c ZVPR4p\V4^8d V^,#R#)zCSectPr immediately preceding this one or None if this is the first.z./preceding::w:sectPr[1]N)r/r)r1preceding_sectPrss& r*preceding_sectPrCT_SectPr.preceding_sectPrOs2!JJ'AB'*+<'='A #KtKr-c V^8dQhRRRR/#)r&rAr r'rBr()r)s"r*r+rlVs,<r-c VPV4pVf \R4hVPpVPV4V#)zCReturn rId of w:footerReference child of `type_` after removing it.z!CT_SectPr has no footer reference)r ValueErrorrCremove)r1rArorCs&& r*remove_footerReference CT_SectPr.remove_footerReferenceV@2259  "@A A!! O$ r-cV^8dQhRR/#)r&rAr r()r)s"r*r+rl`s,<r-c VPV4pVf \R4hVPpVPV4V#)zCReturn rId of w:headerReference child of `type_` after removing it.z!CT_SectPr has no header reference)rrrCr)r1rArurCs&& r*remove_headerReference CT_SectPr.remove_headerReference`rr-cV^8dQhRR/#ryr()r)s"r*r+rlksmr-c >VPpVfR#VP#)zThe value of the ``w:right`` attribute in the ```` child element, as a |Length| object, or |None| if either the element or the attribute is not present.N)rgrHr{s& r* right_marginCT_SectPr.right_marginjs   ={{r-cV^8dQhRR/#rr()r)s"r*r+rlus-r-c 2VP4pWnR#r)rWrHrs&& r*rrts%%' r-cV^8dQhRR/#)r&r'r r()r)s"r*r+rlzs,r-c vVPpVeVPf\P#VP#)zThe member of the ``WD_SECTION_START`` enumeration corresponding to the value of the ``val`` attribute of the ```` child element, or ``WD_SECTION_START.NEW_PAGE`` if not present.)rcvalr NEW_PAGE)r1rcs& r* start_typeCT_SectPr.start_typeys0 yy <488+#,, ,xxr-cV^8dQhRR/#)r&rWD_SECTION_START | Noner()r)s"r*r+rls 7r-c VeV\PJdVP4R#VP4pWnR#r)r rr^rZr)r1rrcs&& r*rrs7 =E%5%>%>>     ##%r-cV^8dQhRR/#)r&r'boolr()r)s"r*r+rlsTr-c >VPpVfR#VP#)zEValue of `w:titlePg/@val` or |False| if `./w:titlePg` is not present.F)rir)r1ris& r* titlePg_valCT_SectPr.titlePg_vals,, ?{{r-cV^8dQhRR/#)r&rz bool | Noner()r)s"r*r+rls111r-c bVR9dVP4R#RVP4nR#)NT)NF)r]rYr)r1rs&&r*rrs' M !  ",0D # # % )r-cV^8dQhRR/#ryr()r)s"r*r+rlsMr-c >VPpVfR#VP#)zThe value of the ``w:top`` attribute in the ```` child element, as a |Length| object, or |None| if either the element or the attribute is not present.N)rgrGr{s& r* top_marginCT_SectPr.top_margins   =yyr-cV^8dQhRR/#rr()r)s"r*r+rls r-c 2VP4pWnR#r)rWrGrs&& r*rrs%%' r-r(N)z w:footnotePrz w:endnotePrr@r_r`z w:paperSrcz w:pgBordersz w:lnNumTypez w:pgNumTypezw:colsz w:formProtzw:vAlignz w:noEndnoterazw:textDirectionzw:bidiz w:rtlGutterz w:docGridzw:printerSettingszw:sectPrChange)'r4r5r6r7r8r9_tag_seqrrurorrcrergrirprvr<r|setterrrLrrrMrKrrrrrrrrrrrrr=r(r-r*rVrVds;K..,,....4444''$$H,!!4JO !4JO(Xb\ D 'Xb\D  )hrl E  )  G_ ^^   ]]^^#, ]]^^   ]]^^H\\  BBLL 11 r-rVc8]tRtRt$Rt]!R]4tR]R&Rt R#) CT_SectTypeiz:```` element, defining the section start type.zw:valrrr(N) r4r5r6r7r8rr rr9r=r(r-r*rrsD#4!$C r-rc]tRtRt$RtRtR]R&RtR]R&RRlt] R R l4t R R lt R Rlt ] RRl4tRRlt] RRl4tRtR#)rizyGenerates the block-item XML elements in a section. A block-item element is a `CT_P` (paragraph) or a `CT_Tbl` (table). Nzetree.XPath | None_compiled_blocks_xpath_compiled_count_xpathcV^8dQhRR/#)r&sectPrrVr()r)s"r*r+&_SectBlockElementIterator.__annotate__syr-c WnR#r)_sectPr)r1rs&&r*__init__"_SectBlockElementIterator.__init__s r-c V^8dQhRRRR/#)r&rrVr'Iterator[BlockElement]r()r)s"r*r+rs77i7rBs-";;'PP%SS")-) i)--,4?44  CCL /d d r-