Run constructor
Contents
[
Hide
]Run(doc)
Initializes a new instance of the Run class.
def __init__(self, doc: aspose.words.DocumentBase):
...
| Parameter | Type | Description |
|---|---|---|
| doc | DocumentBase | The owner document. |
Remarks
When Run is created, it belongs to the specified document, but is not
yet part of the document and Node.parent_node is None.
To append Run to the document use CompositeNode.insert_after() or CompositeNode.insert_before() on the paragraph where you want the run inserted.
Run(doc, text)
Initializes a new instance of the Run class.
def __init__(self, doc: aspose.words.DocumentBase, text: str):
...
| Parameter | Type | Description |
|---|---|---|
| doc | DocumentBase | The owner document. |
| text | str | The text of the run. |
Remarks
When Run is created, it belongs to the specified document, but is not
yet part of the document and Node.parent_node is None.
To append Run to the document use CompositeNode.insert_after() or CompositeNode.insert_before() on the paragraph where you want the run inserted.
Examples
Shows how to construct an Aspose.Words document by hand.
doc = aw.Document()
# A blank document contains one section, one body and one paragraph.
# Call the "RemoveAllChildren" method to remove all those nodes,
# and end up with a document node with no children.
doc.remove_all_children()
# This document now has no composite child nodes that we can add content to.
# If we wish to edit it, we will need to repopulate its node collection.
# First, create a new section, and then append it as a child to the root document node.
section = aw.Section(doc)
doc.append_child(section)
# Set some page setup properties for the section.
section.page_setup.section_start = aw.SectionStart.NEW_PAGE
section.page_setup.paper_size = aw.PaperSize.LETTER
# A section needs a body, which will contain and display all its contents
# on the page between the section's header and footer.
body = aw.Body(doc)
section.append_child(body)
# Create a paragraph, set some formatting properties, and then append it as a child to the body.
para = aw.Paragraph(doc)
para.paragraph_format.style_name = 'Heading 1'
para.paragraph_format.alignment = aw.ParagraphAlignment.CENTER
body.append_child(para)
# Finally, add some content to do the document. Create a run,
# set its appearance and contents, and then append it as a child to the paragraph.
run = aw.Run(doc=doc)
run.text = 'Hello World!'
run.font.color = aspose.pydrawing.Color.red
para.append_child(run)
self.assertEqual('Hello World!', doc.get_text().strip())
doc.save(file_name=ARTIFACTS_DIR + 'Section.CreateManually.docx')
Shows how to format a run of text using its font property.
doc = aw.Document()
run = aw.Run(doc=doc, text='Hello world!')
font = run.font
font.name = 'Courier New'
font.size = 36
font.highlight_color = aspose.pydrawing.Color.yellow
doc.first_section.body.first_paragraph.append_child(run)
doc.save(file_name=ARTIFACTS_DIR + 'Font.CreateFormattedRun.docx')
See Also
- module aspose.words
- class Run