feature: remove single run/paragraph

I make some pptx templates processing and this is really desired feature for me. API proposal:

paragraph.remove(run)

and

textframe.remove(paragraph)

[scanny]

Hi @theres, I think the API we’ll use is .delete() on each individual object for which it’s valid, so something like this:

paragraph.runs[0].delete()
run.delete()
paragraph.delete()
# etc. ...

In the meantime, this code should do the trick for plain content. The trickiness comes in when there are links to external content, like a picture or hyperlink:

def delete_paragraph(paragraph):
    p = paragraph._p
    parent_element = p.getparent()
    parent_element.remove(p)

# this second form is a little more direct, although perhaps not
# quite as clear on all the steps that are happening
def delete_run(run):
    r = run._r
    r.getparent().remove(r)

You’ll need to be careful about using any remaining reference to the paragraph after calling delete_paragraph(). It will seem to work but won’t affect the presentation content that gets saved. That’s one of the reasons using the form delete_paragraph(text_frame.paragraphs[idx]) would be preferred since it doesn’t leave a reference hanging around.

Dealing with these smaller details and edge cases will be some of the work that will go into the actual feature when we add it.

Let us know how you go if you decide to use the workaround function 😃

[zhouaide0924]

Hi Scanny, Thanks for your response, it is work now. I find I used it in a wrong way. Sorry for this issue.