Paragraph Features Supported on Rich Text Import
Each paragraph in a document is represented in Aspose.Words as a Paragraph node. A paragraph represents a block of text in a document and have a variety of properties and styles.
Using Aspose.Words you can access and change virtually all properties of a paragraph. Nearly all paragraph attributes are supported. You can also easily insert and remove paragraphs.
Paragraph formatting is contained within the ParagraphFormat class which is linked to the paragraph.
See the following links in the documentation for further information:
- Inserting Document Elements
- Paragraph
- Paragraph.ParagraphFormat
General Formatting
| Feature | Supported | Comment | See Also |
|---|---|---|---|
| Paragraph Style | Yes | - ParagraphFormat - ParagraphFormat.Style |
|
| Alignment | Yes | The special “Thai Distributed” alignment is also supported during conversion. There is currently no API to access or modify this alignment. | - ParagraphFormat.Alignment |
| Right to Left Paragraph | Yes | - ParagraphFormat.Bidi | |
| Bullets and Numbers | Yes | - ParagraphFormat.ListFormat - ParagraphFormat.ListLabel |
|
| Outline Level | Yes | - ParagraphFormat.OutlineLevel | |
| Run Properties for the Paragraph Mark | Yes | - ParagraphFormat.ParagraphBreakFont | |
| Suppress Line Numbers | Yes | - ParagraphFormat.SurpressLineNumbers | |
| Suppress Hyphenation | Yes | - ParagraphFormat.SurpressAutoHyphens |
Indents
| Feature | Supported | Comment | See Also |
|---|---|---|---|
| Left Indent | Yes | - ParagraphFormat.LeftIndent | |
| Right Indent | Yes | - ParagraphFormat.RightIndent | |
| First Line Indent | Yes | - ParagraphFormat.FirstLineIndent | |
| Hanging Indent | Yes | - ParagraphFormat.FirstLineIndent | |
| Mirror Indents | Yes | - ParagraphFormat.LeftIndent - ParagraphFormat.RightIndent |
|
| Automatically Adjust Right Indent | Yes |
Spacing
| Feature | Supported | Comment | See Also |
|---|---|---|---|
| Space Before | Yes | - ParagraphFormat.SpaceBefore | |
| Space After | Yes | - ParagraphFormat.SpaceAfter | |
| Space Auto | Yes | - ParagraphFormat.SpaceBeforeAuto - ParagraphFormat.SpaceAfterAuto |
|
| Line Spacing | Yes | - ParagraphFormat.LineSpacing - ParagraphFormat.LineSpacingRule |
|
| No Space between Conforming Paragraphs | Yes | - ParagraphFormat.NoSpaceBetweenParagraphsOfSameStyle | |
| Snap To Grid | Yes |
Keeps and Breaks
| Feature | Supported | Comment | See Also |
|---|---|---|---|
| Widow/Orphan Control | Yes | - ParagraphFormat.WidowControl | |
| Keep With Next | Yes | - ParagraphFormat.KeepWithNext | |
| Keep Lines Together | Yes | - ParagraphFormat.KeepTogether | |
| Page Break Before | Yes | - ParagraphFormat.PageBreakBefore |
Text Frames
This is the legacy text frames from Word 97, not to be confused with the Autoshape Textbox which is discussed under Drawing Objects.
Text frames are preserved in the model but there is no API or node to modify or access information about frames.
| Feature | Supported | Comment | See Also |
|---|---|---|---|
| Text Frames | Yes |
Tab Stops
All features of tab stops are supported in Aspose.Words except for relative tab stops.
Using Aspose.Words you can find tab stops based off position or index. You can change tab stop features like position, alignment etc or remove tabstops completely.
See the following link in the documentation for further information:
- ParagraphFormat.TabStops
| Feature | Supported | Comment | See Also |
|---|---|---|---|
| Absolute Position | Yes | - TabStop.Position | |
| Relative Position | Planned | A relative position tab can be inserted in Microsoft Word using the “Insert Alignment Tab” button. This type of tab is relative to either the page margin or the indent of the paragraph. This allows tab stops to appear in the same relative place even when the position of the paragraph or page is modified. Currently Aspose.Words supports these types of tab stops in OOXML and WordML formats only. There is currently no API to retrieve the properties of this tab e.g RelativeTo, Alignment, Leader etc. Further support is planned. |
- AbsolutePositionTab |
| Alignment: Left, Center, Right, Decimal, Bar | Yes | - TabStop.Alignment | |
| Leader | Yes | - TabStop.Leader |
Drop Caps
Drop Caps are partially supported and preserved during document conversion. A drop cap is a text frame which is imported as a separate paragraph (from the rest of the paragraph as seen in the source document).
You can modify drop cap properties and position, however the new settings are not applied to the drop cap. You cannot yet create new drop caps (although you can easily simulate them through the use of a textbox).
This will be improved in a future version of Aspose.Words.
See the following links in the documentation for further information:
- ParagraphFormat.DropCapPositon
- ParagraphFormat.LinesToDrop
| Feature | Supported | Comment | See Also |
|---|---|---|---|
| Drop Caps | Yes |
Borders
| Feature | Supported | Comment | See Also |
|---|---|---|---|
| Border Sides | Yes | - ParagraphFormat.Borders - LineStyle |
|
| Shadow | Yes | - Border.Shadow | |
| 3D Frame | Yes | - Border.LineStyle | |
| Style | Yes | - Border.LineStyle | |
| Color | Yes | - Border.Color | |
| Width | Yes | - Border.LineWidth | |
| Distance from Text | Yes | - Border.DistanceFromText |
Shading
See the following link in the documentation for further information:
- ParagraphFormat.Shading
| Feature | Supported | Comment | See Also |
|---|---|---|---|
| Shading | Yes |
Asian Typography
Asian Typography settings is fully supported during conversion. However there is currently no API to access or modify these settings.
| Feature | Supported | Comment | See Also |
|---|---|---|---|
| Use Asian Rules for Controlling First and Last Characters | Yes | ||
| Allow Latin Text to Wrap in the Middle of a Word | Yes | ||
| Allow Hanging Punctuation | Yes | ||
| Allow Punctuation at Start of a Line to Compress | Yes | ||
| Automatically Adjust Space between Asian and Latin Text | Yes | ||
| Automatically Adjust Space between Asian Text and Numbers | Yes | ||
| Text Vertical Alignment | Yes |