^jUdZddlmZddlmZmZmZmZddlm Z ddl m Z ddl m Z ddlmZmZddlmZmZer4dd lmZdd lmZmZdd lmZdd lmZdd lmZddlm Z m!Z!ddl"m#Z#ddl$m%Z%GddeZ&Gdde Z'y )z'|Document| and closely related objects.) annotations)IO TYPE_CHECKINGIteratorList)BlockItemContainer) WD_SECTION)WD_BREAK)SectionSections) ElementProxyEmuN)CT_Body CT_Document) DocumentPart)Settings)Length)ParagraphStyle _TableStyle)Table) Paragraphc>eZdZdZdfd ZdddZdZdddZ d ddZe jfddZ dddZ e d Ze d Zdd Ze d d Ze d!d Zd"dZe d#dZe d$dZe dZe d%dZe d&dZe d'dZxZS)(DocumentzWordprocessingML (WML) document. Not intended to be constructed directly. Use :func:`docx.Document` to open or create a document. cVtt| |||_||_d|_yN)superr__init___element_part_Document__body)selfelementpart __class__s O/var/www/html/metafoliadorv2/venv/lib/python3.12/site-packages/docx/document.pyrzDocument.__init__"s' h&w/   ctd|cxkrdksntd|z|dk(rdnd|z}|j||S)aReturn a heading paragraph newly added to the end of the document. The heading paragraph will contain `text` and have its paragraph style determined by `level`. If `level` is 0, the style is set to `Title`. If `level` is 1 (or omitted), `Heading 1` is used. Otherwise the style is set to `Heading {level}`. Raises |ValueError| if `level` is outside the range 0-9. r z"level must be in range 0-9, got %dTitlez Heading %d) ValueError add_paragraph)r!textlevelstyles r% add_headingzDocument.add_heading(sEEQAEIJ J A:<%+?!!$..r&c|j}|jjtj|S)z=Return newly |Paragraph| object containing only a page break.)r+add_run add_breakr PAGE)r! paragraphs r%add_page_breakzDocument.add_page_break5s1&&( %%hmm4r&c:|jj||S)aReturn paragraph newly added to the end of the document. The paragraph is populated with `text` and having paragraph style `style`. `text` can contain tab (``\t``) characters, which are converted to the appropriate XML form for a tab. `text` can also include newline (``\n``) or carriage return (``\r``) characters, each of which is converted to a line break. )_bodyr+)r!r,r.s r%r+zDocument.add_paragraph;szz''e44r&cd|jj}|j|||S)aReturn new picture shape added in its own paragraph at end of the document. The picture contains the image at `image_path_or_stream`, scaled based on `width` and `height`. If neither width nor height is specified, the picture appears at its native size. If only one is specified, it is used to compute a scaling factor that is then applied to the unspecified dimension, preserving the aspect ratio of the image. The native size of the picture is calculated using the dots-per-inch (dpi) value specified in the image file, defaulting to 72 dpi if no value is specified, as is often the case. )r+r1 add_picture)r!image_path_or_streamwidthheightruns r%r9zDocument.add_pictureGs/   "**,3UFCCr&c|jjj}||_t ||j S)zReturn a |Section| object newly added at the end of the document. The optional `start_type` argument must be a member of the :ref:`WdSectionStart` enumeration, and defaults to ``WD_SECTION.NEW_PAGE`` if not provided. )rbodyadd_section_break start_typer r)r!rA new_sectPrs r% add_sectionzDocument.add_sectionZs5 ]]''99; * z4::..r&cb|jj|||j}||_|S)zAdd a table having row and column counts of `rows` and `cols` respectively. `style` may be a table style object or a table style name. If `style` is |None|, the table inherits the default table style of the document. )r7 add_table _block_widthr.)r!rowscolsr.tables r%rEzDocument.add_tableds.  $$T41B1BC  r&c.|jjS)zGA |CoreProperties| object providing Dublin Core properties of document.)rcore_propertiesr!s r%rKzDocument.core_propertiesnszz)))r&c.|jjS)zThe |InlineShapes| collection for this document. An inline shape is a graphical object, such as a picture, contained in a run of text and behaving like a character glyph, being flowed like other text in a paragraph. )r inline_shapesrLs r%rNzDocument.inline_shapessszz'''r&c6|jjS)zHGenerate each `Paragraph` or `Table` in this document in document order.)r7iter_inner_contentrLs r%rPzDocument.iter_inner_content}szz,,..r&c.|jjS)zThe |Paragraph| instances in the document, in document order. Note that paragraphs within revision marks such as ```` or ```` do not appear in this list. )r7 paragraphsrLs r%rRzDocument.paragraphsszz$$$r&c|jS)z+The |DocumentPart| object of this document.)rrLs r%r#z Document.partszzr&c:|jj|y)zSave this document to `path_or_stream`. `path_or_stream` can be either a path to a filesystem location (a string) or a file-like object. N)rsave)r!path_or_streams r%rUz Document.saves 'r&cBt|j|jS)zD|Sections| object providing access to each section in this document.)r rrrLs r%sectionszDocument.sectionss tzz22r&c.|jjS)zDA |Settings| object providing access to the document-level settings.)rsettingsrLs r%rZzDocument.settingsszz"""r&c.|jjS)zBA |Styles| object providing access to the styles in this document.)rstylesrLs r%r\zDocument.stylesszz   r&c.|jjS)aPAll |Table| instances in the document, in document order. Note that only tables appearing at the top level of the document appear in this list; a table nested inside a table cell does not appear. A table within revision marks such as ```` or ```` will also not appear in the list. )r7tablesrLs r%r^zDocument.tablesszz   r&c~|jd}t|j|jz |jz S)zGA |Length| object specifying the space between margins in last section.)rXr page_width left_margin right_margin)r!sections r%rFzDocument._block_widths9--#7%%(;(;;g>R>RRSSr&c||j%t|jj||_|jS)z>The |_Body| instance containing the content for this document.)r _Bodyrr?rLs r%r7zDocument._bodys0 ;;  2 2D9DK{{r&)r"rr#r))r,strr-int)rgN)r,rir.zstr | ParagraphStyle | Nonereturnr)NN)r:str | IO[bytes]r;int | Length | Noner<rm)rAr r)rGrjrHrjr.zstr | _TableStyle | None)rkzIterator[Paragraph | Table])rkzList[Paragraph])rkr)rVrl)rkr )rkr)rkz List[Table])rkr)rkrf)__name__ __module__ __qualname____doc__rr/r5r+r9r NEW_PAGErCrEpropertyrKrNrPrRr#rUrXrZr\r^rFr7 __classcell__r$s@r%rrs2  / 5&*&* D-D#D$ D&4>3F3F/**((/%%(33##!!!!TT r&rc*eZdZdZdfd ZdZxZS)rfzoProxy for `` element in this document. It's primary role is a container for document content. c<tt| ||||_yr)rrfrr7)r!body_elmparentr$s r%rz_Body.__init__s eT#Hf5 r&c:|jj|S)zReturn this |_Body| instance after clearing it of all content. Section properties for the main document story, if present, are preserved. )r7 clear_contentrLs r%r{z_Body.clear_contents   " r&)rxrryzt.ProvidesStoryPart)rnrorprqrr{rtrus@r%rfrfs r&rf)(rq __future__rtypingrrrr docx.blkcntnrrdocx.enum.sectionr docx.enum.textr docx.sectionr r docx.sharedr r docx.typestypestdocx.oxml.documentrrdocx.parts.documentr docx.settingsrrdocx.styles.stylerr docx.tablerdocx.text.paragraphrrrfr&r%rsY."44,(#*)70&"= -a|aH r&