hUSrSSKJr SSKJrJrJrJr SSKJ r SSK J r SSK J r SSKJrJr SSKJrJr \(a4SS KJr SS KJrJr SS KJr SS KJr SS KJr SSKJ r J!r! SSK"J#r# SSK$J%r% "SS\5r&"SS\ 5r'g )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) Paragraphcp^\rSrSrSrSU4SjjrSSSjjrSrSSSjjrSSSjjr \ R4SSjjr SS S jjr \S 5r\S 5rS!S jr\S"S j5r\S#Sj5rS$Sjr\S%Sj5r\S&Sj5r\S5r\S'Sj5r\S(Sj5r\S)Sj5rSrU=r$)*DocumentzWordprocessingML (WML) document. Not intended to be constructed directly. Use :func:`docx.Document` to open or create a document. cR>[[U] U5 XlX lSUlgN)superr__init___element_part_Document__body)selfelementpart __class__s ?/var/www/html/env/lib/python3.13/site-packages/docx/document.pyrDocument.__init__"s# h&w/   cxSUs=::aS::dO [SU-5eUS:XaSOSU-nURX5$)amReturn 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_headingDocument.add_heading(sCEQAEIJ J A:<%+?!!$..r(cUR5nUR5R[R5 U$)z=Return newly |Paragraph| object containing only a page break.)r-add_run add_breakr PAGE)r" paragraphs r&add_page_breakDocument.add_page_break5s1&&( %%hmm4r(c8URRX5$)ajReturn 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.r0s r&r-Document.add_paragraph;szz''44r(cbUR5R5nURXU5$)aPReturn 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-r4 add_picture)r"image_path_or_streamwidthheightruns r&r>Document.add_pictureGs-   "**,3FCCr(cURRR5nXl[ X R 5$)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"rG new_sectPrs r& add_sectionDocument.add_sectionZs1 ]]''99; *z::..r(c^URRXUR5nX4lU$)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. )r; add_table _block_widthr0)r"rowscolsr0tables r&rLDocument.add_tableds*  $$T1B1BC  r(c.URR$)zGA |CoreProperties| object providing Dublin Core properties of document.)r core_propertiesr"s r&rSDocument.core_propertiesnszz)))r(c.URR$)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_shapesrTs r&rWDocument.inline_shapessszz'''r(c6URR5$)zHGenerate each `Paragraph` or `Table` in this document in document order.)r;iter_inner_contentrTs r&rZDocument.iter_inner_content}szz,,..r(c.URR$)zThe |Paragraph| instances in the document, in document order. Note that paragraphs within revision marks such as ```` or ```` do not appear in this list. )r; paragraphsrTs r&r]Document.paragraphsszz$$$r(cUR$)z+The |DocumentPart| object of this document.)r rTs r&r$ Document.partszzr(c:URRU5 g)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)r save)r"path_or_streams r&rb Document.saves 'r(cB[URUR5$)zD|Sections| object providing access to each section in this document.)r rr rTs r&sectionsDocument.sectionss tzz22r(c.URR$)zDA |Settings| object providing access to the document-level settings.)r settingsrTs r&riDocument.settingsszz"""r(c.URR$)zBA |Styles| object providing access to the styles in this document.)r stylesrTs r&rlDocument.stylesszz   r(c.URR$)a(All |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. )r;tablesrTs r&roDocument.tablesszz   r(c~URSn[URUR- UR- 5$)zGA |Length| object specifying the space between margins in last section.)rfr page_width left_margin right_margin)r"sections r&rMDocument._block_widths9--#7%%(;(;;g>R>RRSSr(c~URc%[URRU5UlUR$)z>The |_Body| instance containing the content for this document.)r!_BodyrrErTs r&r;Document._bodys0 ;;  2 2D9DK{{r()__bodyrr )r#rr$r))r.strr/int)r|N)r.r~r0zstr | ParagraphStyle | Nonereturnr)NN)r?str | IO[bytes]r@int | Length | NonerAr)rGr r)rNrrOrr0zstr | _TableStyle | None)rzIterator[Paragraph | Table])rzList[Paragraph])rr)rcr)rr )rr)rz List[Table])rr)rry)__name__ __module__ __qualname____firstlineno____doc__rr1r8r-r>r NEW_PAGErIrLpropertyrSrWrZr]r$rbrfrirlrorMr;__static_attributes__ __classcell__r%s@r&rrs2  / 5&*&* D-D#D$ D&4>3F3F/**((/%%(33##!!!!TT r(rc6^\rSrSrSrSU4SjjrSrSrU=r$)ryzgProxy for `` element in this document. It's primary role is a container for document content. c8>[[U] X5 Xlgr)rryrr;)r"body_elmparentr%s r&r_Body.__init__s eT#H5 r(c:URR5 U$)zReturn this |_Body| instance after clearing it of all content. Section properties for the main document story, if present, are preserved. )r; clear_contentrTs r&r_Body.clear_contents   " r()r;)rrrzt.ProvidesStoryPart) rrrrrrrrrrs@r&ryrys r(ry)(r __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.paragraphrrryr(r&rsY."44,(#*)70&"= -a|aH r(