o W_I@sdZddlmZmZmZmZddlmZddlm Z ddl m Z ddl m Z mZddlmZmZGdd d eZGd d d eZd S) z&|Document| and closely related objects)absolute_importdivisionprint_functionunicode_literals)BlockItemContainer) WD_SECTION)WD_BREAK)SectionSections) ElementProxyEmucseZdZdZdZfddZd*ddZd d Zd+d d Zd,ddZ e j fddZ d-ddZ eddZeddZeddZeddZddZeddZed d!Zed"d#Zed$d%Zed&d'Zed(d)ZZS).DocumentzWordprocessingML (WML) document. Not intended to be constructed directly. Use :func:`docx.Document` to open or create a document. )_partZ__bodycs tt||||_d|_dSN)superr __init__r_Document__body)selfelementpart __class__=D:\Projects\ConvertPro\env\Lib\site-packages\docx\document.pyrs zDocument.__init__cCsBd|kr dksntd||dkrdnd|}|||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 %dZTitlez Heading %d) ValueError add_paragraph)rtextlevelstylerrr add_headings  zDocument.add_headingcCs|}|tj|S)z=Return newly |Paragraph| object containing only a page break.)radd_runZ add_breakrZPAGE)rZ paragraphrrradd_page_break)szDocument.add_page_breakNcCs|j||S)a Return a paragraph newly added to the end of the document, 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)rrr!rrrr/s zDocument.add_paragraphcCs|}||||S)a Return a new picture shape added in its own paragraph at the 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. )rr# add_picture)rZimage_path_or_streamwidthheightrunrrrr&:s zDocument.add_picturecCs|jj}||_t||jS)a Return a |Section| object representing a new section 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. )_elementbodyZadd_section_break start_typer r)rr,Z new_sectPrrrr add_sectionJs  zDocument.add_sectioncCs|j|||j}||_|S)a% Add a table having row and column counts of *rows* and *cols* respectively and table style of *style*. *style* may be a paragraph style object or a paragraph style name. If *style* is |None|, the table inherits the default table style of the document. )r% add_table _block_widthr!)rZrowscolsr!tablerrrr.UszDocument.add_tablecC|jjS)zx A |CoreProperties| object providing read/write access to the core properties of this document. )rcore_propertiesrrrrr3`zDocument.core_propertiescCr2)a! An |InlineShapes| object providing access to the inline shapes in 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_shapesr4rrrr6hszDocument.inline_shapescCr2)z A list of |Paragraph| instances corresponding to the paragraphs in the document, in document order. Note that paragraphs within revision marks such as ```` or ```` do not appear in this list. )r% paragraphsr4rrrr7rszDocument.paragraphscCs|jS)z= The |DocumentPart| object of this document. )rr4rrrr{sz Document.partcCs|j|dS)z Save this document to *path_or_stream*, which can be either a path to a filesystem location (a string) or a file-like object. N)rsave)rZpath_or_streamrrrr8sz Document.savecCst|j|jS)zD|Sections| object providing access to each section in this document.)r r*rr4rrrsectionsszDocument.sectionscCr2)zp A |Settings| object providing access to the document-level settings for this document. )rsettingsr4rrrr:r5zDocument.settingscCr2)zT A |Styles| object providing access to the styles in this document. )rstylesr4rrrr;szDocument.stylescCr2)az A list of |Table| instances corresponding to the tables 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%tablesr4rrrr<s zDocument.tablescCs |jd}t|j|j|jS)z Return a |Length| object specifying the width of available "writing" space between the margins of the last section of this document. )r9r Z page_widthZ left_marginZ right_margin)rsectionrrrr/s zDocument._block_widthcCs |jdur t|jj||_|jS)zP The |_Body| instance containing the content for this document. N)r_Bodyr*r+r4rrrr%s zDocument._body)rr)rN)NNr)__name__ __module__ __qualname____doc__ __slots__rr"r$rr&rZNEW_PAGEr-r.propertyr3r6r7rr8r9r:r;r<r/r% __classcell__rrrrr s>               r cs(eZdZdZfddZddZZS)r?za Proxy for ```` element in this document, having primarily a container role. cstt|||||_dSr)rr?rr%)rZbody_elmparentrrrrs z_Body.__init__cCs|j|S)z Return this |_Body| instance after clearing it of all content. Section properties for the main document story, if present, are preserved. )r% clear_contentr4rrrrHs z_Body.clear_content)r@rArBrCrrHrFrrrrr?s r?N)rCZ __future__rrrrZ docx.blkcntnrrZdocx.enum.sectionrZdocx.enum.textrZ docx.sectionr r Z docx.sharedr r r r?rrrrs   0