*hO%SrSSKJr SSKJr SSKJrJrJrJ r J r SSK J r SSK Jr SSKJrJrJr SSKJr SS KJr SS KJrJrJr SS KJr SS KJr SS KJ r J!r!J"r"J#r#J$r$ SSK%J&r&J'r' Sr(S\)S'"SS\ 5r*"SS\ 5r+"SS\ 5r,"SS\ 5r-"SS\ 5r."SS\ 5r/"SS5r0g )!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 BlockElementcr\rSrSr%SrS\S'S\S'S\S'S \S '\"S S S 9r\"SS S 9r\ SSj5r S r g) 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:tblc$URS5$)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 N/home/mande/repo/quber/.venv/lib/python3.13/site-packages/docx/oxml/section.pyinner_content_elements CT_HdrFtr.inner_content_elements)szz+,,N)returnzList[CT_P | CT_Tbl]) __name__ __module__ __qualname____firstlineno____doc____annotations__rptblpropertyr-__static_attributes__r%r/r,rrsGX   ++5R(A W ,C --r/rcR\rSrSr%Sr\"S\5rS\S'\"S\ 5r S\S'S r g ) CT_HdrFtrRef3z5`w:headerReference` and `w:footerReference` elements.w:typer type_zr:idstrrIdr%N) r1r2r3r4r5rr r?r6rrAr:r%r/r,r<r<3s0?/"E !3C3r/r<c\rSrSr%Sr\"S\5rS\S'\"S\ 5r S\S'\"S\5r S\S '\"S \ 5r S\S '\"S \ 5r S\S '\"S\ 5rS\S'\"S\ 5rS\S'Srg) CT_PageMar<z-```` element, defining page margins.zw:top Length | Nonetopzw:rightrightzw:bottombottomzw:leftleftzw:headerheaderzw:footerfooterzw:guttergutterr%N)r1r2r3r4r5rrrFr6rrGrHrIrJrKrLr:r%r/r,rCrC<s7*&C-?E=.)FM,/D-.OFM.OFM.OFMr/rCc\rSrSr%Sr\"S\5rS\S'\"S\5r S\S'\"S\ \ RS 9r S \S 'S r g ) CT_PageSzVz?```` element, defining page dimensions and orientation.zw:wrEwzw:hhzw:orient)defaultr orientr%N)r1r2r3r4r5rrrPr6rQr PORTRAITrSr:r%r/r,rNrNVsSI( A}) A}/NN,C,CFNr/rNc8\rSrSr%SrS\S'S\S'S\S'S \S 'S \S 'S \S 'S\S'S\S'Sr\"S\S9r\"S\S9r \ "S\SSS9r S\S'\ "S\SSS9r S\S'\ "S\SSS9r S \S!'\ "S"\S#SS9rS$\S%'CSHS&jrSHS'jr\SIS(j5r\R&SJS)j5rSKS*jr\SIS+j5r\R&SJS,j5rSLS-jrSLS.jr\SIS/j5r\R&SJS0j5r\SIS1j5r\R&SJS2j5rSMS3jr\SIS4j5r\R&SJS5j5r\SNS6j5r\R&SOS7j5r\SIS8j5r\R&SPS9j5r\SIS:j5r\R&SPS;j5r\SQS<j5rSRS=jr SSS>jr!\SIS?j5r"\"R&SPS@j5r"\STSAj5r#\#R&SUSBj5r#\SVSCj5r$\$R&SWSDj5r$\SISEj5r%\%R&SPSFj5r%SGr&g)X CT_SectPrdzA`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_type)z w:footnotePrz w:endnotePrr>w:pgSzw:pgMarz w:paperSrcz w:pgBordersz w:lnNumTypez w:pgNumTypezw:colsz w:formProtzw:vAlignz w:noEndnote w:titlePgzw:textDirectionzw:bidiz w:rtlGutterz w:docGridzw:printerSettingszw:sectPrChangezw:headerReferencer&zw:footerReferencer>NzCT_SectType | Nonetyper`zCT_PageSz | NonepgSzrazCT_PageMar | NonepgMarrbzCT_OnOff | NonetitlePgc>UR5nXlX#lU$)zhReturn newly added CT_HdrFtrRef element of `type_` with `rId`. The element tag is `w:footerReference`. )r\r?rA)r+r?rAfooterReferences r,add_footerReferenceCT_SectPr.add_footerReference$ 335 %!r/c>UR5nXlX#lU$)zhReturn newly added CT_HdrFtrRef element of `type_` with `rId`. The element tag is `w:headerReference`. )r]r?rA)r+r?rAheaderReferences r,add_headerReferenceCT_SectPr.add_headerReferenceror/c:URnUcgUR$)zValue of the `w:bottom` attr of `` child element, as |Length|. |None| when either the element or the attribute is not present. N)rhrHr+rhs r, bottom_marginCT_SectPr.bottom_margins   =||r/cUR5nUb[U[5(aXlg[U5UlgN)rX isinstancerrHr+valuerhs r,rvrw2%%' % E61J1Ju PVW\P] r/cP[U5nURR5 U$)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)r+ cloned_sectPrs r,cloneCT_SectPr.clones% ! ""$r/c:URnUcgUR$)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)rhrKrus r,rKCT_SectPr.footers  =||r/cUR5nUb[U[5(aXlg[U5Ulgry)rXrzrrKr{s r,rKrr}r/cpS[R"U5-nURU5nU(dgUS$)zAReturn footerReference element of `type_` or None if not present.z!./w:footerReference[@w:type='%s']Nr)r to_xmlr))r+r?pathfooterReferencess r,get_footerReferenceCT_SectPr.get_footerReferences825E5L5LU5SS::d+""r/c|URS[R"U5-5n[U5S:XagUS$)zAReturn headerReference element of `type_` or None if not present.z!./w:headerReference[@w:type='%s']rN)r)r rlen)r+r?matching_headerReferencess r,get_headerReferenceCT_SectPr.get_headerReferencesC$(JJ /2B2I2I%2P P% ! ( )Q .(++r/c:URnUcgUR$)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)rhrLrus r,rLCT_SectPr.gutters   =||r/cUR5nUb[U[5(aXlg[U5Ulgry)rXrzrrLr{s r,rLrr}r/c:URnUcgUR$)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)rhrJrus r,rJCT_SectPr.headers  =||r/cUR5nUb[U[5(aXlg[U5Ulgry)rXrzrrJr{s r,rJrr}r/c,[RU5$)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_elementsr*s r,iter_inner_contentCT_SectPr.iter_inner_contents )AA$GGr/c:URnUcgUR$)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)rhrIrus r, left_marginCT_SectPr.left_margins   =zzr/cUR5nUb[U[5(aXlg[U5Ulgry)rXrzrrIr{s r,rrs0%%'#mz%/H/HU fUZm r/cXURnUc[R$UR$)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. )rfr rTrSr+rfs r, orientationCT_SectPr.orientations(yy <!** *{{r/cjUR5nU(aXlg[RUlgry)rYr rTrSr+r|rfs r,rr*s###%$e .*A*A r/c:URnUcgUR$)zYValue in EMU of the `h` attribute of the `w:pgSz` child element. |None| if not present. N)rfrQrs r, page_heightCT_SectPr.page_height/ yy <vv r/c0UR5nXlgry)rYrQrs r,rr:##%r/c:URnUcgUR$)z_Value in EMU of the ``w`` attribute of the ```` child element. |None| if not present. N)rfrPrs r, page_widthCT_SectPr.page_width?rr/c0UR5nXlgry)rYrPrs r,rrJrr/cPURS5n[U5S:aUS$S$)zCSectPr immediately preceding this one or None if this is the first.z./preceding::w:sectPr[1]rN)r)r)r+preceding_sectPrss r,preceding_sectPrCT_SectPr.preceding_sectPrOs2!JJ'AB'*+<'='A #KtKr/c~URU5nUc [S5eURnURU5 U$)zCReturn rId of w:footerReference child of `type_` after removing it.z!CT_SectPr has no footer reference)r ValueErrorrAremove)r+r?rlrAs r,remove_footerReference CT_SectPr.remove_footerReferenceV@2259  "@A A!! O$ r/c~URU5nUc [S5eURnURU5 U$)zCReturn rId of w:headerReference child of `type_` after removing it.z!CT_SectPr has no header reference)rrrAr)r+r?rqrAs r,remove_headerReference CT_SectPr.remove_headerReference`rr/c:URnUcgUR$)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)rhrGrus r, right_marginCT_SectPr.right_marginjs   ={{r/c0UR5nXlgry)rXrGr{s r,rrts%%' r/crURnUb URc[R$UR$)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.)rdvalrNEW_PAGE)r+rds r, start_typeCT_SectPr.start_typeys0 yy <488+#,, ,xxr/c~UbU[RLaUR5 gUR5nXlgry)rrr_r[r)r+r|rds r,rrs7 =E%5%>%>>     ##%r/c:URnUcgUR$)zEValue of `w:titlePg/@val` or |False| if `./w:titlePg` is not present.F)rjr)r+rjs r, titlePg_valCT_SectPr.titlePg_vals,, ?{{r/c\US;aUR5 gSUR5lg)N)NFT)r^rZr)r+r|s r,rrs' M !  ",0D # # % )r/c:URnUcgUR$)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)rhrFrus r, top_marginCT_SectPr.top_margins   =yyr/c0UR5nXlgry)rXrFr{s r,rrs%%' r/r%)r?r rAr@r0r<)r0rE)r|zint | Length | None)r0rV)r?r r0zCT_HdrFtrRef | None)r0zIterator[CT_P | CT_Tbl])r0r )r|zWD_ORIENTATION | None)r|rE)r0zCT_SectPr | None)r?r r0r@)r?r )r0r)r|WD_SECTION_START | None)r0bool)r|z bool | None)'r1r2r3r4r5r6_tag_seqrrqrlrrdrfrhrjrmrrr9rvsetterrrKrrrLrJrrrrrrrrrrrrr:r%r/r,rVrVdsCK..,,....4444''$$H,!!4JO !4JO(Xab\ D 'Xab\D  )hqrl E  )  G_ ^^   ]]^^#, ]]^^   ]]^^H\\  BBLL 11 r/rVc6\rSrSr%Sr\"S\5rS\S'Sr g) CT_SectTypeiz:```` element, defining the section start type.zw:valrrr%N) r1r2r3r4r5rrrr6r:r%r/r,rrsD#4!$C r/rc\rSrSr%SrSrS\S'SrS\S'SSjr\ SSj5r SS jr SS jr \ SS j5rSS jr\ SS j5rSrg)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_xpathcXlgry)_sectPr)r+sectPrs r,__init__"_SectBlockElementIterator.__init__s r/c.U"U5R5$)zIGenerate each CT_P or CT_Tbl element within extents governed by `sectPr`.)_iter_sect_block_elements)clsrs r,r2_SectBlockElementIterator.iter_sect_block_elementss6{4466r/c## URURp!URU5nUS:XaSOURX#S- 5nUR U5USHnUv M g7f)z0Generate each CT_P or CT_Tbl element in section.rN)r_sectPrsindex%_count_of_blocks_in_and_above_section_blocks_in_and_above_section)r+rsectPrs sectPr_idxn_blks_to_skipelements r,r3_SectBlockElementIterator._iter_sect_block_elementssq,, ]]6* Q ;;GQRNrs-";;'PP%SS")-) i)--,4?44  CCL /d d r/