JoinRunsOptions class
JoinRunsOptions class
Provides configuration flags for the join runs operation.
Constructors
| Name | Description |
|---|---|
| JoinRunsOptions() | The default constructor. |
Properties
| Name | Description |
|---|---|
| ignore_insignificant | True indicates that the insignificant attributes of all runs will be ignored when joining runs with same formatting. |
| ignore_redundant | True indicates that the redundant attributes of all runs will be ignored when joining runs with same formatting. |
| ignore_spacing | True indicates that the spacing attributes of all runs will be ignored when joining runs with same formatting. |
Examples
Shows how to join runs with the same formatting while ignoring redundant and insignificant attributes.
doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
# Create runs with identical visible formatting but some internal differences.
builder.font.name = 'Arial'
builder.font.size = 12
builder.write('Hello ')
builder.write('world')
# Verify runs before join.
self.assertEqual(2, doc.first_section.body.first_paragraph.runs.count)
self.assertEqual('Hello ', doc.first_section.body.first_paragraph.runs[0].text)
self.assertEqual('world', doc.first_section.body.first_paragraph.runs[1].text)
# Configure options to ignore redundant and insignificant attributes during join.
options = aw.JoinRunsOptions()
options.ignore_redundant = True # Ignore redundant run properties that don't affect appearance.
options.ignore_insignificant = True # Ignore insignificant differences like whitespace-only runs.
# Join runs that have the same visible formatting using the extended options.
doc.first_section.body.first_paragraph.join_runs_with_same_formatting(options)
# Verify that runs were successfully joined.
self.assertEqual(1, doc.first_section.body.first_paragraph.runs.count)
self.assertEqual('Hello world', doc.first_section.body.first_paragraph.runs[0].text)
doc.save(file_name=ARTIFACTS_DIR + 'Paragraph.JoinRunsWithSameFormattingWithOptions.docx')
See Also
- module aspose.words