B j6[)@shdZddlmZmZmZmZddlmZddlm Z m Z m Z m Z m Z mZddlmZGdd d e Zd S) z Paragraph-related proxy types. )absolute_importdivisionprint_functionunicode_literals)WD_LINE_SPACING) ElementProxyEmu lazypropertyLengthPtTwips)TabStopsc@speZdZdZdZeddZejddZeddZejddZed d Z e jd d Z ed d Z e jdd Z eddZ e jddZ eddZ e jddZ eddZ e jddZ eddZejddZeddZejddZeddZejd dZed!d"Zejd#d"Zed$d%Zed&d'Zejd(d'Zed)d*Zed+d,Zd-S).ParagraphFormatz Provides access to paragraph formatting such as justification, indentation, line spacing, space before and after, and widow/orphan control. )Z _tab_stopscCs|jj}|dkrdS|jS)z A member of the :ref:`WdParagraphAlignment` enumeration specifying the justification setting for this paragraph. A value of |None| indicates paragraph alignment is inherited from the style hierarchy. N)_elementpPrjc_val)selfrrB/var/www/html/venv/lib/python3.7/site-packages/docx/text/parfmt.py alignmentszParagraphFormat.alignmentcCs|j}||_dS)N)rget_or_add_pPrr)rvaluerrrrr%s cCs|jj}|dkrdS|jS)aI |Length| value specifying the relative difference in indentation for the first line of the paragraph. A positive value causes the first line to be indented. A negative value produces a hanging indent. |None| indicates first line indentation is inherited from the style hierarchy. N)rrfirst_line_indent)rrrrrr*s z!ParagraphFormat.first_line_indentcCs|j}||_dS)N)rrr)rrrrrrr8s cCs|jj}|dkrdS|jS)z |True| if the paragraph should be kept "in one piece" and not broken across a page boundary when the document is rendered. |None| indicates its effective value is inherited from the style hierarchy. N)rr keepLines_val)rrrrr keep_together=szParagraphFormat.keep_togethercCs||j_dS)N)rrr)rrrrrrIscCs|jj}|dkrdS|jS)a\ |True| if the paragraph should be kept on the same page as the subsequent paragraph when the document is rendered. For example, this property could be used to keep a section heading on the same page as its first paragraph. |None| indicates its effective value is inherited from the style hierarchy. N)rr keepNext_val)rrrrrkeep_with_nextMs zParagraphFormat.keep_with_nextcCs||j_dS)N)rrr)rrrrrr[scCs|jj}|dkrdS|jS)a1 |Length| value specifying the space between the left margin and the left side of the paragraph. |None| indicates the left indent value is inherited from the style hierarchy. Use an |Inches| value object as a convenient way to apply indentation in units of inches. N)rrind_left)rrrrr left_indent_szParagraphFormat.left_indentcCs|j}||_dS)N)rrr)rrrrrrr ls cCs$|jj}|dkrdS||j|jS)aJ |float| or |Length| value specifying the space between baselines in successive lines of the paragraph. A value of |None| indicates line spacing is inherited from the style hierarchy. A float value, e.g. ``2.0`` or ``1.75``, indicates spacing is applied in multiples of line heights. A |Length| value such as ``Pt(12)`` indicates spacing is a fixed height. The |Pt| value class is a convenient way to apply line spacing in units of points. Assigning |None| resets line spacing to inherit from the style hierarchy. N)rr _line_spacing spacing_linespacing_lineRule)rrrrr line_spacingqs zParagraphFormat.line_spacingcCsd|j}|dkr d|_d|_n@t|trF||_|jtjkr`tj|_nt |t d|_tj |_dS)N) rrr"r# isinstancer rZAT_LEASTZEXACTLYr r MULTIPLE)rrrrrrr$s    cCs$|jj}|dkrdS||j|jS)a| A member of the :ref:`WdLineSpacing` enumeration indicating how the value of :attr:`line_spacing` should be interpreted. Assigning any of the :ref:`WdLineSpacing` members :attr:`SINGLE`, :attr:`DOUBLE`, or :attr:`ONE_POINT_FIVE` will cause the value of :attr:`line_spacing` to be updated to produce the corresponding line spacing. N)rr_line_spacing_ruler"r#)rrrrrline_spacing_rules z!ParagraphFormat.line_spacing_rulecCsn|j}|tjkr(td|_tj|_nB|tjkrFtd|_tj|_n$|tj krdtd|_tj|_n||_dS)Nr%ihi) rrrSINGLEr r"r'r#ONE_POINT_FIVEDOUBLE)rrrrrrr)s          cCs|jj}|dkrdS|jS)z |True| if the paragraph should appear at the top of the page following the prior paragraph. |None| indicates its effective value is inherited from the style hierarchy. N)rrpageBreakBefore_val)rrrrrpage_break_beforesz!ParagraphFormat.page_break_beforecCs||j_dS)N)rrr-)rrrrrr.scCs|jj}|dkrdS|jS)a4 |Length| value specifying the space between the right margin and the right side of the paragraph. |None| indicates the right indent value is inherited from the style hierarchy. Use a |Cm| value object as a convenient way to apply indentation in units of centimeters. N)rr ind_right)rrrrr right_indentszParagraphFormat.right_indentcCs|j}||_dS)N)rrr/)rrrrrrr0s cCs|jj}|dkrdS|jS)a |Length| value specifying the spacing to appear between this paragraph and the subsequent paragraph. |None| indicates this value is inherited from the style hierarchy. |Length| objects provide convenience properties, such as :attr:`~.Length.pt` and :attr:`~.Length.inches`, that allow easy conversion to various length units. N)rr spacing_after)rrrrr space_afters zParagraphFormat.space_aftercCs||j_dS)N)rrr1)rrrrrr2scCs|jj}|dkrdS|jS)av |Length| value specifying the spacing to appear between this paragraph and the prior paragraph. |None| indicates this value is inherited from the style hierarchy. |Length| objects provide convenience properties, such as :attr:`~.Length.pt` and :attr:`~.Length.cm`, that allow easy conversion to various length units. N)rrspacing_before)rrrrr space_befores zParagraphFormat.space_beforecCs||j_dS)N)rrr3)rrrrrr4scCs|j}t|S)zp |TabStops| object providing access to the tab stops defined for this paragraph format. )rrr)rrrrr tab_stopss zParagraphFormat.tab_stopscCs|jj}|dkrdS|jS)a |True| if the first and last lines in the paragraph remain on the same page as the rest of the paragraph when Word repaginates the document. |None| indicates its effective value is inherited from the style hierarchy. N)rrwidowControl_val)rrrrr widow_controlszParagraphFormat.widow_controlcCs||j_dS)N)rrr6)rrrrrr7 scCs&|dkr dS|tjkr"|tdS|S)ac Return the line spacing value calculated from the combination of *spacing_line* and *spacing_lineRule*. Returns a |float| number of lines when *spacing_lineRule* is ``WD_LINE_SPACING.MULTIPLE``, otherwise a |Length| object of absolute line height is returned. Returns |None| when *spacing_line* is |None|. N )rr'r )r"r#rrrr!s   zParagraphFormat._line_spacingcCsD|tjkr@|tdkrtjS|tdkr.tjS|tdkr@tjS|S)z Return the line spacing rule value calculated from the combination of *line* and *lineRule*. Returns special members of the :ref:`WdLineSpacing` enumeration when line spacing is single, double, or 1.5 lines. r%ihi)rr'r r*r+r,)lineZlineRulerrrr( s    z"ParagraphFormat._line_spacing_ruleN)__name__ __module__ __qualname____doc__ __slots__propertyrsetterrrrr r$r)r.r0r2r4r r5r7 staticmethodr!r(rrrrrs:             rN)r= __future__rrrrZ enum.textrsharedrr r r r r Ztabstopsrrrrrrs