ó
    ‰*£hc(  ã                   óV   • S r SSKJr  SSKJrJrJrJrJrJ	r	  SSK
Jr   " S S\5      rg)zParagraph-related proxy types.é    )ÚWD_LINE_SPACING)ÚElementProxyÚEmuÚLengthÚPtÚTwipsÚlazyproperty)ÚTabStopsc                   ó¸  • \ rS rSrSr\S 5       r\R                  S 5       r\S 5       r\R                  S 5       r\S 5       r	\	R                  S 5       r	\S	 5       r
\
R                  S
 5       r
\S 5       r\R                  S 5       r\S 5       r\R                  S 5       r\S 5       r\R                  S 5       r\S 5       r\R                  S 5       r\S 5       r\R                  S 5       r\S 5       r\R                  S 5       r\S 5       r\R                  S 5       r\S 5       r\S 5       r\R                  S 5       r\S 5       r\S 5       rSrg) ÚParagraphFormaté   z‹Provides access to paragraph formatting such as justification, indentation, line
spacing, space before and after, and widow/orphan control.c                 óN   • U R                   R                  nUc  gUR                  $ )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)Ú_elementÚpPrÚjc_val©Úselfr   s     ÚM/home/mande/repo/quber/.venv/lib/python3.13/site-packages/docx/text/parfmt.pyÚ	alignmentÚParagraphFormat.alignment   s%   € ð �m‰m×ÑˆØ‰;ØØ�z‰zÐó    c                 óD   • U R                   R                  5       nXl        g ©N)r   Úget_or_add_pPrr   ©r   Úvaluer   s      r   r   r      s   € à�m‰m×*Ñ*Ó,ˆØ�
r   c                 óN   • U R                   R                  nUc  gUR                  $ )a  |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)r   r   Úfirst_line_indentr   s     r   r   Ú!ParagraphFormat.first_line_indent   s'   € ð �m‰m×ÑˆØ‰;ØØ×$Ñ$Ð$r   c                 óD   • U R                   R                  5       nXl        g r   )r   r   r   r   s      r   r   r   ,   s   € à�m‰m×*Ñ*Ó,ˆØ %Õr   c                 óN   • U R                   R                  nUc  gUR                  $ )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)r   r   ÚkeepLines_valr   s     r   Úkeep_togetherÚParagraphFormat.keep_together1   s'   € ð �m‰m×ÑˆØ‰;ØØ× Ñ Ð r   c                 ó@   • XR                   R                  5       l        g r   )r   r   r"   ©r   r   s     r   r#   r$   =   ó   € à7<�‰×$Ñ$Ó&Õ4r   c                 óN   • U R                   R                  nUc  gUR                  $ )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)r   r   ÚkeepNext_valr   s     r   Úkeep_with_nextÚParagraphFormat.keep_with_nextA   s'   € ð �m‰m×ÑˆØ‰;ØØ×ÑÐr   c                 ó@   • XR                   R                  5       l        g r   )r   r   r)   r&   s     r   r*   r+   O   s   € à6;�‰×$Ñ$Ó&Õ3r   c                 óN   • U R                   R                  nUc  gUR                  $ )a	  |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)r   r   Úind_leftr   s     r   Úleft_indentÚParagraphFormat.left_indentS   s%   € ð �m‰m×ÑˆØ‰;ØØ�|‰|Ðr   c                 óD   • U R                   R                  5       nXl        g r   )r   r   r.   r   s      r   r/   r0   a   s   € à�m‰m×*Ñ*Ó,ˆØ�r   c                 ó‚   • U R                   R                  nUc  gU R                  UR                  UR                  5      $ )a  |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)r   r   Ú_line_spacingÚspacing_lineÚspacing_lineRuler   s     r   Úline_spacingÚParagraphFormat.line_spacingf   s:   € ð �m‰m×ÑˆØ‰;ØØ×!Ñ! #×"2Ñ"2°C×4HÑ4HÓIÐIr   c                 ó^  • U R                   R                  5       nUc  S Ul        S Ul        g [	        U[
        5      (       a;  Xl        UR                  [        R                  :w  a  [        R                  Ul        g g [        U[        S5      -  5      Ul        [        R                  Ul        g )Néð   )r   r   r4   r5   Ú
isinstancer   r   ÚAT_LEASTÚEXACTLYr   r   ÚMULTIPLEr   s      r   r6   r7   w   sŠ   € à�m‰m×*Ñ*Ó,ˆØ‰=Ø#ˆCÔØ#'ˆCÕ Ü˜œv×&Ñ&Ø$ÔØ×#Ñ#¤×'?Ñ'?Ó?Ü'6×'>Ñ'>�Õ$ð @ô  # 5¬5°«:Ñ#5Ó6ˆCÔÜ#2×#;Ñ#;ˆCÕ r   c                 ó‚   • U R                   R                  nUc  gU R                  UR                  UR                  5      $ )aL  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)r   r   Ú_line_spacing_ruler4   r5   r   s     r   Úline_spacing_ruleÚ!ParagraphFormat.line_spacing_rule…   s:   € ð �m‰m×ÑˆØ‰;ØØ×&Ñ& s×'7Ñ'7¸×9MÑ9MÓNÐNr   c                 ó   • U R                   R                  5       nU[        R                  :X  a&  [	        S5      Ul        [        R                  Ul        g U[        R                  :X  a&  [	        S5      Ul        [        R                  Ul        g U[        R                  :X  a&  [	        S5      Ul        [        R                  Ul        g Xl        g )Nr9   éh  éà  )
r   r   r   ÚSINGLEr   r4   r=   r5   ÚONE_POINT_FIVEÚDOUBLEr   s      r   r@   rA   “   s’   € à�m‰m×*Ñ*Ó,ˆØ”O×*Ñ*Ó*Ü$ S›zˆCÔÜ#2×#;Ñ#;ˆCÕ Ø”o×4Ñ4Ó4Ü$ S›zˆCÔÜ#2×#;Ñ#;ˆCÕ Ø”o×,Ñ,Ó,Ü$ S›zˆCÔÜ#2×#;Ñ#;ˆCÕ à#(Õ r   c                 óN   • U R                   R                  nUc  gUR                  $ )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)r   r   ÚpageBreakBefore_valr   s     r   Úpage_break_beforeÚ!ParagraphFormat.page_break_before¢   s'   € ð �m‰m×ÑˆØ‰;ØØ×&Ñ&Ð&r   c                 ó@   • XR                   R                  5       l        g r   )r   r   rI   r&   s     r   rJ   rK   ®   s   € à=B�‰×$Ñ$Ó&Õ:r   c                 óN   • U R                   R                  nUc  gUR                  $ )a  |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)r   r   Ú	ind_rightr   s     r   Úright_indentÚParagraphFormat.right_indent²   s%   € ð �m‰m×ÑˆØ‰;ØØ�}‰}Ðr   c                 óD   • U R                   R                  5       nXl        g r   )r   r   rN   r   s      r   rO   rP   À   s   € à�m‰m×*Ñ*Ó,ˆØ�r   c                 óN   • U R                   R                  nUc  gUR                  $ )aG  |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)r   r   Úspacing_afterr   s     r   Úspace_afterÚParagraphFormat.space_afterÅ   s'   € ð �m‰m×ÑˆØ‰;ØØ× Ñ Ð r   c                 ó@   • XR                   R                  5       l        g r   )r   r   rS   r&   s     r   rT   rU   Ó   r'   r   c                 óN   • U R                   R                  nUc  gUR                  $ )a>  |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)r   r   Úspacing_beforer   s     r   Úspace_beforeÚParagraphFormat.space_before×   s'   € ð �m‰m×ÑˆØ‰;ØØ×!Ñ!Ð!r   c                 ó@   • XR                   R                  5       l        g r   )r   r   rX   r&   s     r   rY   rZ   å   s   € à8=�‰×$Ñ$Ó&Õ5r   c                 óL   • U R                   R                  5       n[        U5      $ )zV|TabStops| object providing access to the tab stops defined for this
paragraph format.)r   r   r
   r   s     r   Ú	tab_stopsÚParagraphFormat.tab_stopsé   s    € ð �m‰m×*Ñ*Ó,ˆÜ˜‹}Ðr   c                 óN   • U R                   R                  nUc  gUR                  $ )zÚ|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)r   r   ÚwidowControl_valr   s     r   Úwidow_controlÚParagraphFormat.widow_controlð   s'   € ð �m‰m×ÑˆØ‰;ØØ×#Ñ#Ð#r   c                 ó@   • XR                   R                  5       l        g r   )r   r   r`   r&   s     r   ra   rb   ü   s   € à:?�‰×$Ñ$Ó&Õ7r   c                 óR   • U c  gU[         R                  :X  a  U [        S5      -  $ U $ )a3  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é   )r   r=   r   )r4   r5   s     r   r3   ÚParagraphFormat._line_spacing   s0   € ð ÑØØœ×7Ñ7Ó7Ø¤" R£&Ñ(Ð(ØÐr   c                 óè   • U[         R                  :X  a]  U [        S5      :X  a  [         R                  $ U [        S5      :X  a  [         R                  $ U [        S5      :X  a  [         R
                  $ U$ )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.
r9   rC   rD   )r   r=   r   rE   rF   rG   )ÚlineÚlineRules     r   r?   Ú"ParagraphFormat._line_spacing_rule  s_   € ð ”×/Ñ/Ó/Ø”u˜S“zÓ!Ü&×-Ñ-Ð-Ø”u˜S“zÓ!Ü&×5Ñ5Ð5Ø”u˜S“zÓ!Ü&×-Ñ-Ð-Øˆr   © N)Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__Ú__doc__Úpropertyr   Úsetterr   r#   r*   r/   r6   r@   rJ   rO   rT   rY   r	   r]   ra   Ústaticmethodr3   r?   Ú__static_attributes__rk   r   r   r   r      st  † ñBð ñ
ó ð
ð ×Ññó ðð ñ%ó ð%ð ×Ññ&ó ð&ð ñ	!ó ð	!ð ×Ññ=ó ð=ð ñ ó ð ð ×Ññ<ó ð<ð ñó ðð ×Ññó ðð ñJó ðJð  ×Ññ<ó ð<ð ñOó ðOð ×Ññ)ó ð)ð ñ	'ó ð	'ð ×ÑñCó ðCð ñó ðð ×Ññó ðð ñ!ó ð!ð ×Ññ=ó ð=ð ñ"ó ð"ð ×Ññ>ó ð>ð ñó ðð ñ	$ó ð	$ð ×Ññ@ó ð@ð ñó ðð ñó ór   r   N)rp   Údocx.enum.textr   Údocx.sharedr   r   r   r   r   r	   Údocx.text.tabstopsr
   r   rk   r   r   Ú<module>rx      s"   ðÙ $å *ß J× JÝ 'ôV�lõ Vr   