.
Description
The ParagraphFormatting class is used to specify formatting that should be applied to a paragraph. It also represents the paragraph formatting of named styles in the document.
C#
vb.net
Remarks
There are two ways to obtain an instance of this class: Create a new normal paragraph formatting object using the Document.CreateParagraphFormatting method or access an existing style's paragraph formatting information using the NamedStyle.ParagraphFormatting property. The ParagraphFormatting object that is returned can then be used in conjunction with methods in the Element class to create paragraphs with specific formatting.
The following example demonstrates both ways of getting paragraph formatting, first by retrieving the BodyText style's paragraph formatting from the document, second by retrieving a copy of the BodyText2 style's paragraph formatting. Then, some properties are set and the formatting is applied to a new paragraph.
Examples
C#
vb.net
Properties
Name |
Description |
|---|---|
| Returns an AbsolutePositioning object on which you can control the absolute positioning for a paragraph. | |
Sets or returns a boolean that represents if Word will automatically handle spacing below a paragraph. |
|
Sets or returns a boolean representing if auto hyphening is allowed for a paragraph. |
|
Sets or returns a boolean that represents if Word will automatically handle spacing above a paragraph. |
|
Sets or returns a boolean that represents if Word attempts to keep all lines of a paragraph on the same page. (It prevents a page break within a paragraph.) |
|
Sets or returns a boolean that represents if Word attempts to keep a paragraph on the same page as the next paragraph. (It prevents a page break a paragraph and the next paragraph.) |
|
Sets or returns a boolean that represents if Word will display line numbers next to a paragraph. This property has no effect in documents or sections with no line numbers. |
|
Returns an int representing the line spacing for a paragraph. |
|
| Returns a ParagraphFormatting.LineSpacingRule object that represents the type of line spacing for a paragraph. There are 3 types: AtLeast, Exactly, and Multiple. AtLeast and Exactly use twips to specify a minimum height and exact height respectively. One twip = (1/20 pt) or (1/1440 in). Multiple specifies a spacing as a number of lines. Multiple is the most common type of spacing. | |
Sets or returns a boolean that represents if Word will have a paragraph be the start of a new page. (It inserts a manual page break before the paragraph.) |
|
| Returns a Shading object which on which you can manipulate the shading (fill color and/or pattern) properties of a paragraph. | |
Sets or returns an int representing the amount of whitespace that should be placed below a paragraph in twips. One twip = (1/20 pt) or (1/1440 in) |
|
Sets or returns an int representing the amount of whitespace that should be placed above a paragraph in twips. One twip = (1/20 pt) or (1/1440 in) |
|
| Sets or returns a ParagraphFormatting.Justification object that represents the text justification for a paragraph. | |
Sets or returns a boolean representing if Word will use Widow Control for a paragraph. When set to true, Word will not print the last line of a paragraph by itself at the top of a page (widow) or the first line of a paragraph by itself at the bottom of a page (orphan). |
Methods
Name |
Description |
|---|---|
| Returns a Border object on which you can manipulate the border properties of a paragraph for a specified location. Valid Border locations are: Top, Left, Bottom, Right, Between, and Bar. Bar and Between are less obvious locations and they are explained below. | |
Returns an int representing the indent of the paragraph in twips. |
|
Sets an int representing the indent of the paragraph in twips. |
|
Sets an int representing the line spacing for a paragraph. |
Nested Classes
Name |
Description |
|---|---|
| The page ParagraphFormatting.FontAlignment does not exist. | |
| Indent locations for a paragraph. | |
| Justification types for a paragraph. | |
| Line spacing types for a paragraph. If the line spacing is not at least the height of the font used on the line then the top of the character string is truncated. |