o jq iO@sTUdZddlmZddlmZddlmZmZmZm Z m Z ddl m Z ddl mZddlmZmZmZddlmZdd lmZdd lmZmZmZdd lmZdd lmZdd lm Z m!Z!m"Z"m#Z#m$Z$ddl%m&Z&m'Z'dZ(de)d<Gddde Z*Gddde Z+Gddde Z,Gddde Z-Gddde Z.Gddde Z/GdddZ0d S)!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@sXeZdZUdZded<ded<ded<ded <ed d d Zed d d ZedddZ dS) CT_HdrFtrzN`w:hdr` and `w:ftr`, the root element for header and footer part respectively.zCallable[[], CT_P]Zadd_pz List[CT_P]Zp_lstz List[CT_Tbl]Ztbl_lstzCallable[[CT_Tbl], CT_Tbl]Z _insert_tblzw:p successorszw:tblreturnList[CT_P | CT_Tbl]cCs |dS)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)xpathselfrrX/home/app/PaddleOCR-VL/.venv_paddleocr/lib/python3.10/site-packages/docx/oxml/section.pyinner_content_elements)s z CT_HdrFtr.inner_content_elementsN)r!r") __name__ __module__ __qualname____doc____annotations__rptblpropertyr'rrrr&rs   rc@s6eZdZUdZedeZded<edeZ ded<dS) CT_HdrFtrRefz5`w:headerReference` and `w:footerReference` elements.w:typer type_zr:idstrrIdN) r(r)r*r+rr r2r,rr4rrrr&r03s  r0c@seZdZUdZedeZded<edeZ ded<edeZ ded<ed eZ ded <ed eZ ded <ed eZ ded<edeZded<dS) CT_PageMarz-```` element, defining page margins.zw:top Length | Nonetopzw:rightrightzw:bottombottomzw:leftleftzw:headerheaderzw:footerfooterzw:guttergutterN)r(r)r*r+rrr7r,rr8r9r:r;r<r=rrrr&r5<s.       r5c@sNeZdZUdZedeZded<edeZded<ede e j dZ d ed <d S) CT_PageSzz?```` element, defining page dimensions and orientation.zw:wr6wzw:hhzw:orient)defaultr orientN) r(r)r*r+rrr?r,r@r PORTRAITrBrrrr&r>Vs   r>c@seZdZUdZded<ded<ded<ded <d ed <d ed <d ed<d ed<dZededZededZe dedddZ ded<e dedddZ ded<e dedddZ ded <e d!ed"ddZ d#ed$<[dmd+d,Zdmd-d.Zednd0d1Zejdod4d1Zdpd5d6Zednd7d8Zejdod9d8Zdqd;d<Zdqd=d>Zednd?d@ZejdodAd@ZedndBdCZejdodDdCZdrdFdGZedndHdIZejdodJdIZedsdLdMZejdtdOdMZedndPdQZejdudRdQZedndSdTZejdudUdTZedvdWdXZdwdYdZZdxd[d\Z ednd]d^Z!e!jdud_d^Z!edydadbZ"e"jdzdddbZ"ed{dfdgZ#e#jd|didgZ#edndjdkZ$e$jdudldkZ$dS)} 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_type)z w:footnotePrz w:endnotePrr1w: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:headerReferencerzw:footerReferencer1NzCT_SectType | NonetyperMzCT_PageSz | NonepgSzrNzCT_PageMar | NonepgMarrOzCT_OnOff | NonetitlePgr2r r4r3r!r0cC|}||_||_|S)zxReturn newly added CT_HdrFtrRef element of `type_` with `rId`. The element tag is `w:footerReference`. )rIr2r4)r%r2r4footerReferencerrr&add_footerReferencezCT_SectPr.add_footerReferencecCrX)zxReturn newly added CT_HdrFtrRef element of `type_` with `rId`. The element tag is `w:headerReference`. )rJr2r4)r%r2r4headerReferencerrr&add_headerReferencer[zCT_SectPr.add_headerReferencer6cC|j}|dur dS|jS)zValue of the `w:bottom` attr of `` child element, as |Length|. |None| when either the element or the attribute is not present. N)rUr9r%rUrrr& bottom_marginzCT_SectPr.bottom_marginvalueint | Length | NonecC2|}|dus t|tr||_dSt||_dSN)rE isinstancerr9r%rbrUrrr&r`*cCst|}|j|S)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%Z cloned_sectPrrrr&clones zCT_SectPr.clonecCr^)aDistance 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)rUr<r_rrr&r<szCT_SectPr.footercCrdre)rErfrr<rgrrr&r<rhCT_HdrFtrRef | NonecCs(dt|}||}|sdS|dS)zAReturn footerReference element of `type_` or None if not present.z!./w:footerReference[@w:type='%s']Nr)r to_xmlr#)r%r2pathZfooterReferencesrrr&get_footerReferences  zCT_SectPr.get_footerReferencecCs,|dt|}t|dkrdS|dS)zAReturn headerReference element of `type_` or None if not present.z!./w:headerReference[@w:type='%s']rN)r#r rmlen)r%r2Zmatching_headerReferencesrrr&get_headerReferences   zCT_SectPr.get_headerReferencecCr^)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)rUr=r_rrr&r=zCT_SectPr.guttercCrdre)rErfrr=rgrrr&r=rhcCr^)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)rUr;r_rrr&r;szCT_SectPr.headercCrdre)rErfrr;rgrrr&r;rhIterator[CT_P | CT_Tbl]cCs t|S)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$rrr&iter_inner_contents zCT_SectPr.iter_inner_contentcCr^)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)rUr:r_rrr& left_marginrrzCT_SectPr.left_margincCrdre)rErfrr:rgrrr&rwrhr cCs|j}|dur tjS|jS)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. N)rSr rCrBr%rSrrr& orientationszCT_SectPr.orientationWD_ORIENTATION | NonecCs"|}|r ||_dStj|_dSre)rFr rCrBr%rbrSrrr&ry*scCr^)ziValue in EMU of the `h` attribute of the `w:pgSz` child element. |None| if not present. N)rSr@rxrrr& page_height/razCT_SectPr.page_heightcC|}||_dSre)rFr@r{rrr&r|: cCr^)zoValue in EMU of the ``w`` attribute of the ```` child element. |None| if not present. N)rSr?rxrrr& page_width?razCT_SectPr.page_widthcCr}re)rFr?r{rrr&rJr~CT_SectPr | NonecCs"|d}t|dkr|dSdS)zCSectPr immediately preceding this one or None if this is the first.z./preceding::w:sectPr[1]rN)r#rp)r%Zpreceding_sectPrsrrr&preceding_sectPrOs zCT_SectPr.preceding_sectPrcC.||}|dur td|j}|||S)zCReturn rId of w:footerReference child of `type_` after removing it.Nz!CT_SectPr has no footer reference)ro ValueErrorr4remove)r%r2rYr4rrr&remove_footerReferenceV  z CT_SectPr.remove_footerReferencecCr)zCReturn rId of w:headerReference child of `type_` after removing it.Nz!CT_SectPr has no header reference)rqrr4r)r%r2r\r4rrr&remove_headerReference`rz CT_SectPr.remove_headerReferencecCr^)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)rUr8r_rrr& right_marginjrrzCT_SectPr.right_margincCr}re)rEr8rgrrr&rtr~r cCs$|j}|dus |jdurtjS|jS)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.N)rQvalr NEW_PAGE)r%rQrrr& start_typeyszCT_SectPr.start_typeWD_SECTION_START | NonecCs0|dus |tjur|dS|}||_dSre)r rrLrHr)r%rbrQrrr&rs  boolcCs|j}|dur dS|jS)zEValue of `w:titlePg/@val` or |False| if `./w:titlePg` is not present.NF)rWr)r%rWrrr& titlePg_valszCT_SectPr.titlePg_val bool | NonecCs"|dvr |dSd|_dS)N)NFT)rKrGr)r%rbrrr&rs cCr^)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)rUr7r_rrr& top_marginrrzCT_SectPr.top_margincCr}re)rEr7rgrrr&rr~)r2r r4r3r!r0)r!r6)rbrc)r!rD)r2r r!rl)r!rs)r!r )rbrz)rbr6)r!r)r2r r!r3)r2r )r!r )rbr)r!r)rbr)%r(r)r*r+r,Z_tag_seqrr\rYrrQrSrUrWrZr]r/r`setterrkr<rorqr=r;rvrwryr|rrrrrrrrrrrr&rDds                                        rDc@s$eZdZUdZedeZded<dS) CT_SectTypez:```` element, defining the section start type.zw:valrrN)r(r)r*r+rr rr,rrrr&rs rc@s|eZdZUdZdZded<dZded<ddd Zedd d Z dddZ dddZ e d ddZ d!ddZe d"ddZdS)#rtzGenerates 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_xpathsectPrrDcCs ||_dSre)_sectPr)r%rrrr&__init__s z"_SectBlockElementIterator.__init__r!Iterator[BlockElement]cCs ||S)zIGenerate each CT_P or CT_Tbl element within extents governed by `sectPr`.)_iter_sect_block_elements)clsrrrr&rus z2_SectBlockElementIterator.iter_sect_block_elementsccsZ|j|j}}||}|dkrdn|||d}|||dD]}|Vq%dS)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%rZsectPrsZ sectPr_idxZn_blks_to_skipelementrrr&rs z3_SectBlockElementIterator._iter_sect_block_elementsSequence[BlockElement]cCs6|jdurtj|jtdd|_|j}ttt||S)FAll ps and tbls in section defined by `sectPr` and all prior sections.NF namespacesregexp)rr XPath"_blocks_in_and_above_section_xpathrrrrr%rr#rrr&rs z6_SectBlockElementIterator._blocks_in_and_above_sectionr3c Cs,d}d}d}|d|d|d|d| S)zHXPath expr for ps and tbls in context of a sectPr and all prior sectPrs.z./parent::w:pPr/parent::w:pzself::w:sectPr[parent::w:body]z-preceding-sibling::*[self::w:p | self::w:tbl]z | /r)r%Zp_sect_term_blockZbody_sect_termZpred_ps_and_tblsrrr&rs z<_SectBlockElementIterator._blocks_in_and_above_section_xpathintcCs>|jdurtjd|jdtdd|_|j}ttt||S)rNzcount()Fr)rr rrrrrfloatrrrr&rs  z?_SectBlockElementIterator._count_of_blocks_in_and_above_sectionSequence[CT_SectPr]cCs |jdS)z5All w:sectPr elements in document, in document-order.zC/w:document/w:body/w:p/w:pPr/w:sectPr | /w:document/w:body/w:sectPr)rr#r$rrr&rsz"_SectBlockElementIterator._sectPrs)rrD)rrDr!r)r!r)rrDr!r)r!r3)rrDr!r)r!r)r(r)r*r+rr,rr classmethodrurrrrrrrrrr&rts          rtN)1r+ __future__rcopyrtypingrrrrrZlxmlr Ztyping_extensionsr Zdocx.enum.sectionr r r Z docx.oxml.nsrZdocx.oxml.sharedrZdocx.oxml.simpletypesrrrZdocx.oxml.tablerZdocx.oxml.text.paragraphrZdocx.oxml.xmlchemyrrrrrZ docx.sharedrrrr,rr0r5r>rDrrtrrrr&s0          H