o
eÜ? ã @ sŠ d Z ddlmZ ddlmZmZmZ ddlmZm Z ddl
m Z ddl m
Z
mZ ddlmZ ddlmZ dd lmZ dd
lmZ d d lmZ d@dd„ZdAdefdd„Zdd„ Z dBde fdd„Z dd„ Z dCd e fd d „Z dDd e fd!d"„Z!d#e"fd$d%„Z#d#e"fd&d'„Z$d(d)„ Z%d*d+„ Z&G d,d-„ d-e
ƒZ'ed.e'ƒ dEd0d1„Z(d2e fd3d4„Z)d5efd6d7„Z*d5ed#e"fd8d9„Z+d5efd:d;„Z,dFd5ed=e-fd>d?„Z.d/S )Gz1docx operation methods based on ``python-docx``.
é )ÚPt)Ú OxmlElementÚ parse_xmlÚregister_element_cls)ÚqnÚnsdecls)Ú
CT_Picture)ÚBaseOxmlElementÚ
OneAndOnlyOne)ÚWD_COLOR_INDEX)ÚUnrecognizedImageError)Ú_Cell)ÚRELATIONSHIP_TYPEé )Ú rgb_valueé c C sD | j d¡d }| tdƒt|ƒ¡ | tdƒttd| ƒƒ¡ dS )a Set section column count and space. All the columns have same width.
Args:
section : ``python-docx`` Section instance.
num (int): Column count. Defaults to 2.
space (int, optional): Space between adjacent columns. Unit: Pt. Defaults to 0.
ú./w:colsr úw:numúw:spaceé N)Ú_sectPrÚxpathÚsetr ÚstrÚint)ÚsectionÚnumÚspaceÚcol© r úDD:\Projects\ConvertPro\env\Lib\site-packages\pdf2docx/common/docx.pyÚset_equal_columns s r! Ú
width_listc C sœ | j d¡d }| tdƒtt|ƒƒ¡ | tdƒd¡ |ddd… D ](}tdƒ}| td ƒttd
| ƒƒ¡ | td ƒttd
| ƒƒ¡ | d|¡ q#dS ) aŸ Set section column count and space.
Args:
section : ``python-docx`` Section instance.
width_list (list|tuple): Width of each column.
space (int, optional): Space between adjacent columns. Unit: Pt. Defaults to 0.
Scheme::
r r r z w:equalWidthÚ0Néÿÿÿÿzw:colúw:wr r ) r r r r r Úlenr r Úinsert)r r" r ÚcolsÚwÚer r r Ú set_columns" s ür+ c C s$ | j }| ¡ |¡ d | _| _ dS )z‚Delete a paragraph.
Reference:
https://github.com/python-openxml/python-docx/issues/33#issuecomment-77661907
N)Ú_elementZ getparentÚremoveÚ_p)Ú paragraphÚpr r r Údelete_paragraph> s r1 çÍÌÌÌÌÌð?Ú line_spacingc C s† | j }||_tdƒ|_tdƒ|_tdƒ|_tdƒ|_d|_d t dƒ¡}| j
¡ dt
|ƒ¡ d t dƒ¡}| j
¡ dt
|ƒ¡ |S )a¤ Reset paragraph format, especially line spacing.
Two kinds of line spacing, corresponding to the setting in MS Office Word:
* line_spacing=1.05: single or multiple
* line_spacing=Pt(1): exactly
Args:
p (Paragraph): ``python-docx`` paragraph instance.
line_spacing (float, optional): Line spacing. Defaults to 1.05.
Returns:
paragraph_format: Paragraph format.
r Tz r) z )Úparagraph_formatr3 r Z space_beforeZ space_afterZ left_indentZ right_indentZ
widow_controlÚformatr r. Zget_or_add_pPrr' r )r0 r3 ÚpfÚxmlr r r Úreset_paragraph_formatI s
r8 c C s< t dƒ}t dƒ}t dƒ}| |¡ | |¡ | j |¡ dS )a Hide paragraph. This method just sets the paragraph property, while the added text must
be hided explicitly.
r = p.add_run()
r.text = "Hidden"
r.font.hidden = True
Args:
p (Paragraph): python-docx created paragraph.
zw:pPrúw:rPrzw:vanishN)r Úappendr. )r0 ZpPrÚrPrÚvr r r Úset_hidden_propertyj s
r= ç ð?Úscalec C ó* | j ¡ dtd tdƒd| ¡ƒ¡ dS )a Set character spacing: scaling.
Manual operation in MS Word: Font | Advanced | Character Spacing | Scaling.
Args:
p_run (docx.text.run.Run): Proxy object wrapping element.
scale (float, optional): scaling factor. Defaults to 1.0.
r zr) éd N©Ú_rÚget_or_add_rPrr' r r5 r )Úp_runr? r r r Úset_char_scaling€ ó ÿrF ç r c C r@ )a1 Set character spacing.
Manual operation in MS Word: Font | Advanced | Character Spacing | Spacing.
Args:
p_run (docx.text.run.Run): Proxy object wrapping element.
space (float, optional): Spacing value in Pt. Expand if positive else condense. Defaults to 0.0.
r zr) r NrB )rE r r r r Úset_char_spacing rG rI Úsrgbc C s˜ t dƒtjt dƒtjt dƒtjt dƒtjt dƒtjt dƒtji}||v r,|| | j_ dS t
|ƒdd… d ¡}d
t
d ƒ|¡}| j ¡ d t|ƒ¡ dS )
a Set character shading color, in case the color is out of highlight color scope.
Reference:
http://officeopenxml.com/WPtextShading.php
Args:
p_run (docx.text.run.Run): Proxy object wrapping element.
srgb (int): Color value.
)r r r )r r r )r r r )r r r )r r r )r r r r Né z4r) r )r r ZREDZ BRIGHT_GREENZBLUEZYELLOWZPINKZ TURQUOISEZfontÚhighlight_colorÚhexÚzfillr5 r rC rD r' r )rE rJ Z color_mapÚcr7 r r r Úset_char_shadingš s
úrP c C s@ t |ƒdd… d¡}d tdƒ|¡}| j ¡ dt|ƒ¡ dS )z•Set underline and color.
Args:
p_run (docx.text.run.Run): Proxy object wrapping element.
srgb (int): Color value.
r NrK z%r) r )rM rN r5 r rC rD r' r )rE rJ rO r7 r r r Úset_char_underline¸ s rQ c
C s¤ | j }|j|tjdd}tdƒ}| tdƒ|¡ | tdƒd¡ tdƒ}tdƒ}td ƒ}| td
ƒd ¡ | |¡ | |¡ ||_| |¡ | ¡ } | j
|¡ | S ) a“ Create a hyperlink within a paragraph object.
Reference:
https://github.com/python-openxml/python-docx/issues/74#issuecomment-215678765
Args:
paragraph (Paragraph): ``python-docx`` paragraph adding the hyperlink to.
url (str): The required url.
text (str): The text displayed for the url.
Returns:
Run: A Run object containing the hyperlink.
T)Z is_externalz w:hyperlinkzr:idz w:historyÚ1zw:rr9 zw:rStyleúw:valZ Hyperlink) ÚpartZ relate_tor Z HYPERLINKr r r r: ÚtextÚadd_runrC )
r/ ÚurlrU rT Zr_idZ hyperlinkZnew_runr; ZrStyleÚrr r r Ú
add_hyperlinkÄ s
rY c C sN | ¡ }z|j|t|ƒt|ƒd W n ty tdƒ Y dS w d| j_dS )zþ Add image to paragraph.
Args:
p (Paragraph): ``python-docx`` paragraph instance.
image_path_or_stream (str, bytes): Image path or stream.
width (float): Image width in Pt.
height (float): Image height in Pt.
)ÚwidthÚheightzUnrecognized Image.Nr> )rV Z add_picturer r Úprintr4 r3 )r0 Úimage_path_or_streamrZ r[ Z docx_spanr r r Ú add_imageø s þ r^ c @ sL e Zd ZdZedƒZedƒZedƒZedd„ ƒZ edd„ ƒZ
ed d
„ ƒZ d S ) Ú
_CT_AnchorzA
```` element, container for a floating image.
z wp:extentzwp:docPrz a:graphicc C sP t | ||¡ƒ}||j_||j_||j_d| |j_d|jj _
|jj |¡ |S )zn
Return a new ```` element populated with the values passed
as parameters.
z
Picture %dz8http://schemas.openxmlformats.org/drawingml/2006/picture) r Ú _anchor_xmlÚextentÚcxÚcyÚdocPrÚidÚnameÚgraphicÚ graphicDataÚuriÚ _insert_pic)Úclsrb rc Úshape_idÚpicÚpos_xÚpos_yÚanchorr r r Únew s ÿz_CT_Anchor.newc C s< d}t |||||¡} | |||| ||¡}
|
jj | ¡ |
S )z}
Return a new `wp:anchor` element containing the `pic:pic` element
specified by the argument values.
r )r rq rg rh rj ) rk rl ÚrIdÚfilenamerb rc rn ro Zpic_idrm rp r r r Únew_pic_anchor% s
z_CT_Anchor.new_pic_anchorc C s dt ddddƒt|ƒt|ƒf S )NaŽ
%d
%d
ZwpÚarm rX )r r )rk rn ro r r r r` 1 s íÿz_CT_Anchor._anchor_xmlN) Ú__name__Ú
__module__Ú __qualname__Ú__doc__r
ra rd rg Ú classmethodrq rt r` r r r r r_ s
r_ z wp:anchorNc
C sj | ¡ }|j |¡\}}| t|ƒd¡\}} |jj|j}
} t |
|| || t|ƒt|ƒ¡} |j
| ¡ dS )aÊ Add float image behind text.
Args:
p (Paragraph): ``python-docx`` Paragraph object this picture belongs to.
image_path_or_stream (str, bytes): Image path or stream.
width (float): Displaying width of picture, in unit Pt.
pos_x (float): X-position (English Metric Units) to the top-left point of page valid region
pos_y (float): Y-position (English Metric Units) to the top-left point of page valid region
N) rV rT Zget_or_add_imageZscaled_dimensionsr Znext_idrs r_ rt rC Z add_drawing)
r0 r] rZ rn ro Úrunrr Úimagerb rc rl rs rp r r r Úadd_float_imageM s
r} Úindentc C sV | j d¡}|r)tdƒ}| tdƒtd| ƒ¡ | tdƒd¡ |d |¡ dS dS ) z™Indent a table.
Args:
table (Table): ``python-docx`` Table object.
indent (float): Indent value, the basic unit is 1/20 pt.
zw:tblPrzw:tblIndr% r úw:typeÚdxar N)r, r r r r r r: )Útabler~ Ztbl_prr* r r r Ú indent_tablec s ür‚ Úcellc K sx | j }| ¡ }tdƒ}dD ]'}||v r4td |¡ƒ}| tdƒt| |¡ƒ¡ | tdƒd¡ | |¡ q
| |¡ dS )aë Set cell margins. Provided values are in twentieths of a point (1/1440 of an inch).
Reference:
* https://blog.csdn.net/weixin_44312186/article/details/104944773
* http://officeopenxml.com/WPtableCellMargins.php
Args:
cell (_Cell): ``python-docx`` Cell instance you want to modify.
kwargs (dict): Dict with keys: top, bottom, start, end.
Usage::
set_cell_margins(cell, top=50, start=50, bottom=50, end=50)
zw:tcMar)ÚtopÚstartÚbottomÚendúw:{}r% r r€ N) Ú_tcÚget_or_add_tcPrr r5 r r r Úgetr: )rƒ ÚkwargsÚtcÚtcPrZtcMarÚmÚnoder r r Úset_cell_marginsr s
€r‘ c C s: t |ƒdd… d¡}| j ¡ td tdƒ|¡ƒ¡ dS )a Set cell background-color.
Reference:
https://stackoverflow.com/questions/26752856/python-docx-set-table-cell-background-and-text-color
Args:
cell (_Cell): ``python-docx`` Cell instance you want to modify
srgb (int): RGB color value.
r NrK zr) )rM rN r‰ rŠ r: r r5 r )rƒ rJ rO r r r Úset_cell_shading s
$r’ c
K s° | j }| ¡ }| d¡}|du rtdƒ}| |¡ dD ]:}| |¡}|rUd |¡}| t|ƒ¡}|du r=t|ƒ}| |¡ dD ]} | |v rT| td | ¡ƒt
|| ƒ¡ q?qdS )a² Set cell`s border.
Reference:
* https://stackoverflow.com/questions/33069697/how-to-setup-cell-borders-with-python-docx
* https://blog.csdn.net/weixin_44312186/article/details/104944110
Args:
cell (_Cell): ``python-docx`` Cell instance you want to modify.
kwargs (dict): Dict with keys: top, bottom, start, end.
Usage::
set_cell_border(
cell,
top={"sz": 12, "val": "single", "color": "#FF0000", "space": "0"},
bottom={"sz": 12, "color": "#00FF00", "val": "single"},
start={"sz": 24, "val": "dashed", "shadow": "true"},
end={"sz": 12, "val": "dashed"},
)
z w:tcBordersN)r… r„ r‡ r† ZinsideHZinsideVrˆ )ÚszÚvalÚcolorr Zshadow) r‰ rŠ Zfirst_child_found_inr r: r‹ r5 Úfindr r r )
rƒ rŒ r rŽ Z tcBordersÚedgeZ edge_dataÚtagÚelementÚkeyr r r Úset_cell_borderž s&
€òr› ÚbtLrÚ directionc C s4 | j }| ¡ }tdƒ}| tdƒ|¡ | |¡ dS )zòSet vertical text direction for cell.
Reference:
https://stackoverflow.com/questions/47738013/how-to-rotate-text-in-table-cells
Args:
direction (str): Either "tbRl" (top to bottom) or "btLr" (bottom to top).
zw:textDirectionrS N)r‰ rŠ r r r r: )rƒ r r rŽ Z
textDirectionr r r Úset_vertical_cell_directionÎ s
rž )r r )r )r2 )r> )rH )NN)rœ )/ry Z docx.sharedr Z docx.oxmlr r r Z docx.oxml.nsr r Zdocx.oxml.shaper Zdocx.oxml.xmlchemyr r
Zdocx.enum.textr Zdocx.image.exceptionsr Z
docx.tabler
Zdocx.opc.constantsr Úsharer r! Úlistr+ r1 Úfloatr8 r= rF rI r rP rQ rY r^ r_ r} r‚ r‘ r’ r› r rž r r r r Ú s<
!
4
>
0