如何使用 python-docx 更改图像位置和文本换行？

Question

使用 add_method() 添加图像后，我想更改图像位置和文本换行属性。

我想更改文本换行：在文本前面

我想将属性更改为

水平

对齐方式：右对齐，相对于：边距

垂直

绝对位置：2.15 cm，下图：页面

这是我在word中手动更改它的方法，但我想使用python-docx来完成

有什么办法可以完成吗？

Answer 1

简短的回答是“不。”

在 Word 中放置图像有两种方式，内联图像和浮动图像。

内联图像放置在一个运行中，本质上被视为一个大字符。它出现的行的高度向上调整以适合图像，并且它所在的段落根据其前面的文本在页面之间流动，就像任何其他段落一样。

浮动图像位于绘图层上，就像文本所在的文档层上方的透明塑料片一样。它被赋予绝对位置，并且通常不随文本流动（尽管它可以锚定到文本的一部分）。文本可以设置为环绕图像，无论它位于页面上的哪个位置。

python-docx

目前仅支持内嵌图像。现有的 API 不支持浮动图像（以及它们允许的文本换行）。

Answer 2

以下示例将向您展示如何执行此操作。如果我需要将文本换行设置为“方形”，它就适用于我的情况。

import os
from docx.oxml import parse_xml, register_element_cls
from docx.oxml.ns import nsdecls
from docx.oxml.shape import CT_Picture
from docx.oxml.xmlchemy import BaseOxmlElement, OneAndOnlyOne
from docx import Document
from docx.shared import Inches, Pt


class CT_Anchor(BaseOxmlElement):
    extent = OneAndOnlyOne('wp:extent')
    docPr = OneAndOnlyOne('wp:docPr')
    graphic = OneAndOnlyOne('a:graphic')

    @classmethod
    def new(cls, cx, cy, shape_id, pic, pos_x, pos_y):
        anchor = parse_xml(cls._anchor_xml(pos_x, pos_y))
        anchor.extent.cx = cx
        anchor.extent.cy = cy
        anchor.docPr.id = shape_id
        anchor.docPr.name = 'Picture %d' % shape_id
        anchor.graphic.graphicData.uri = (
            'http://schemas.openxmlformats.org/drawingml/2006/picture'
        )
        anchor.graphic.graphicData._insert_pic(pic)
        return anchor

    @classmethod
    def new_pic_anchor(cls, shape_id, rId, filename, cx, cy, pos_x, pos_y):
        pic_id = 0
        pic = CT_Picture.new(pic_id, filename, rId, cx, cy)
        anchor = cls.new(cx, cy, shape_id, pic, pos_x, pos_y)
        anchor.graphic.graphicData._insert_pic(pic)
        return anchor

    @classmethod
    def _anchor_xml(cls, pos_x, pos_y):
        return (
            '<wp:anchor distT="0" distB="0" distL="0" distR="0" simplePos="0" relativeHeight="0" \n'
            '           behindDoc="1" locked="0" layoutInCell="1" allowOverlap="1" \n'
            '           %s>\n'
            '  <wp:simplePos x="0" y="0"/>\n'
            '  <wp:positionH relativeFrom="page">\n'
            '    <wp:posOffset>%d</wp:posOffset>\n'
            '  </wp:positionH>\n'
            '  <wp:positionV relativeFrom="page">\n'
            '    <wp:posOffset>%d</wp:posOffset>\n'
            '  </wp:positionV>\n'                    
            '  <wp:extent cx="914400" cy="914400"/>\n'
            '  <wp:wrapSquare wrapText = "bothSides"/>\n'
            '  <wp:docPr id="666" name="unnamed"/>\n'
            '  <wp:cNvGraphicFramePr>\n'
            '    <a:graphicFrameLocks noChangeAspect="1"/>\n'
            '  </wp:cNvGraphicFramePr>\n'
            '  <a:graphic>\n'
            '    <a:graphicData uri="URI not set"/>\n'
            '  </a:graphic>\n'
            '</wp:anchor>' % ( nsdecls('wp', 'a', 'pic', 'r'), int(pos_x), int(pos_y) )
        )


def new_pic_anchor(part, image_descriptor, width, height, pos_x, pos_y):
    rId, image = part.get_or_add_image(image_descriptor)
    cx, cy = image.scaled_dimensions(width, height)
    shape_id, filename = part.next_id, image.filename
    return CT_Anchor.new_pic_anchor(shape_id, rId, filename, cx, cy, pos_x, pos_y)


# refer to docx.text.run.add_picture
def add_float_picture(p, image_path_or_stream, width=None, height=None, pos_x=0, pos_y=0):
    """Add float picture at fixed position `pos_x` and `pos_y` to the top-left point of page.
    """
    run = p.add_run()
    anchor = new_pic_anchor(run.part, image_path_or_stream, width, height, pos_x, pos_y)
    run._r.add_drawing(anchor)


if __name__ == '__main__':
    register_element_cls('wp:anchor', CT_Anchor)
    document = Document("document.docx")

    p = document.add_paragraph()
    add_float_picture(p, 'image_test.png', width=Inches(2.25), pos_x=Pt(400), pos_y=Pt(30))

    p.add_run('Hello World'*50)

    document.save('document.docx')
    os.system("start document.docx")

为了信用起见，这最初是由用户 Kill0geR 在 python-docx GitHub 页面上报告的：

https://github.com/python-openxml/python-docx/issues/159#issuecomment-1955319955