The value of this property is persisted to the core properties section of the document as 'creator'.
The value of this property is persisted to the core properties section of the document as 'description'.
The value of this property is persisted to the extended properties section of the document.
The value of this property is persisted to the extended properties section of the document.
WordprocessingML consumers which do not support the display of pictures or shapes may make use this property to describe the picture to the user. Screen reading applications or other assistive technologies may also make use of the property to describe the picture or shape to handicapped users.
The HorizontalAlignment property is used in conjunction with the
By default, the HorizontalAlignment property is not applicable, and positioning is
implied to be absolute, defined by the value of the
The RelativeHorizontalPosition and HorizontalAlignment properties define the boundary at which the anchor is positioned; the HorizontalOffset property defines an additional amount of space to be added by which to offset the position. For example, if an anchor is left-aligned with the margin, and the offset is set to 72 pts., the object will appear one inch from the left edge of the margin.
The unit of measurement used to express the property value is defined by the
When the
The RelativeHorizontalPosition property defines the area
of the document to which the value of the
The RelativeVerticalPosition property defines the area
of the document to which the value of the
When the
The VerticalAlignment property is used in conjunction with the
By default, the VerticalAlignment property is not applicable, and positioning is
implied to be absolute, defined by the value of the
The
The unit of measurement used to express the property value is defined by the
In the absence of an explicit setting, this property returns null. In this case, pictures are displayed at their natural size, and shapes are displayed at a size of one inch square.
When set explicitly, the unit of measurement used to express the property value is defined by the
The TextWrapping property works in conjunction with the
The TextWrappingSide property works in conjunction with the
The TextWrappingSide property is not applicable when the TextWrapping property is set to 'TextInBackground' or 'TextInForeground'.
Shapes are rendered by the consumer using Vector Markup Language (VML), which is supported in both MS Word 2007 and MS Word 2010.
In the absence of an explicit setting, this property returns null. In this case, shapes are displayed at a size of one inch square.
When set explicitly, the unit of measurement used to express the property value is defined by the
Shapes are rendered by the consumer using Vector Markup Language (VML), which is supported in both MS Word 2007 and MS Word 2010.
The type of the object returned from the Create method is different
based on the specified
To access properties that are specific to the VmlShape-derived type that is returned, the reference returned from this method can be upcasted.
The LineColor property controls the color for a
The LineColor property controls the color of the outer border for
shapes which have area. Use the
When set explicitly, the unit of measurement used to express the property value is defined by the
The LineStyle property controls the style for a
The origin for a line is always implied to be the top-left
corner of it bounding rectangle. When the bounding rectangle's
height is non-zero, the slope of the line is negative (resembles
a backslash); to make the slope positive, set the
To render a horizontal line, set the Height component of the
To render a vertical line, set the Width component of the
The origin for a line is always implied to be the top-left corner of it bounding rectangle. When the bounding rectangle's height is non-zero, the slope of the line is negative (resembles a backslash). Setting the InvertY property switches the orientation of the y-axis, making the slope of the line positive.
In the case where either the width or height component of the
The FillColor property controls the color of the interior region.
Use the
Use positive values between 1 and 180 for clockwise rotation about the x-axis.
Use negative values between -1 and -180 for counter-clockwise rotation about the x-axis.
Rotating a shape by exactly 180 degrees is the equivalent of inverting it about the x-axis.
The apex of the triangle can be made to appear at the bottom
of the bounding rectangle by setting the
The orientation of the triangle can be changed using the
Setting both the InvertX and InvertY properties to true results in no change to the shape's orientation.
The apex for a right triangle is always implied to be aligned with the the left edge of the bounding rectangle. To align it with the right edge, set this property to true.
The apex for a right triangle is always implied to point to the top edge of the bounding rectangle. To switch vertical orientation, set the InvertY property to true.
WordprocessingML consumers which do not support the display of pictures or shapes may make use this property to describe the picture to the user. Screen reading applications or other assistive technologies may also make use of the property to describe the picture or shape to handicapped users.
In the absence of an explicit setting, this property returns null. In this case, shapes are displayed at a size of one inch square, and pictures are displayed at their natural size.
When set explicitly, the unit of measurement used to express the property value is defined by the
Unlike an inline picture, which moves along with adjacent content, an AnchoredPicture remains at a fixed location within the paragraph, with adjacent text flowing around it.
This property is only applicable when the
The unit of measurement used to express the property value is defined by the
The Reset method restores th object to the state it was
in when it was first instantiated. When used within the context of the
The Color property is not applicable unless the
The Style property resolves to 'None', so that by default no outline is drawn around the associated picture.
The LineWidth property is not applicable unless the
The Font class exposes properties like Bold, Italic, Underline, etc., which enable the developer to format characters in the same manner as a user of MS Word.
When not explicitly set, the actual value of the property is determined at a higher level of the property resolution hierarchy.
This property can be restored to its default value by setting it to null.
To reduce the memory footprint, creation of the FontCharacterSpacing object
returned from this property is deferred until it is requested publicly
by a consumer. To avoid triggering creation, use the
The default color value can be reinstated by setting this property to Color.Empty.
The default color value can be reinstated by setting this property to Color.Empty.
By default, no color is applied to the area behind the text. Use this property to fill the rectangle which encloses the text area with a particular color, i.e., to "highlight" the text.
To reduce the memory footprint, creation of the FontEffects object
returned from this property is deferred until it is requested publicly
by a consumer. To avoid triggering creation, use the
When not explicitly set, the actual value of the property is determined at a higher level of the property resolution hierarchy.
This property can be restored to its default value by setting it to null.
When not explicitly set, the actual value of the property is determined at a higher level of the property resolution hierarchy.
This property can be restored to its default value by setting it to null or an empty string.
ASCII characters within the range of 0 through 127 are displayed with the font associated with the value of this property. Other fonts can be designated for use with character sets outside the standard ASCII range using the following properties:
If this property is not explicitly set, the text is displayed in a default font which supports complex script content.
If this property is not explicitly set, the text is displayed in a default font which supports East Asian content.
If this property is not explicitly set, the text is displayed in a default font which supports high ANSI content.
The value assigned to this property must be a value between the range of 1 and 1638 DTPs (desktop publishing points), inclusive.
The unit of measurement used to express the property value is defined by the
This property can be restored to its default value by setting it to null.
When not explicitly set, the actual value of the property is determined at a higher level of the property resolution hierarchy.
The default underline color value can be reinstated by setting this property to Color.Empty.
This setting determines the manner in which the run contents are presented in the document when punctuation characters are part of the run's contents. When this property is specified, each part of the run between a punctuation mark is laid out in a right-to-left direction on the line.
Typically the developer will also set the RightToLeft property on the
Setting this property to true will cause the serialization layer to add
complex script XML elements for the
WordprocessingML uses different XML elements to express the bold, italic,
and size attributes of the font for standard and complex scripts. When the
This property causes the text contained within the associated run to be treated as complex script, effectively resolving any ambiguities that may arise by virtue of the bold, italic, or size attributes being set for both standard and complex scripts.
When not explicitly set, the actual value of the property is determined at a higher level of the property resolution hierarchy.
When not explicitly set, the actual value of the property is determined at a higher level of the property resolution hierarchy.
When the embossing or engraving effect is enabled, the
When not explicitly set, the actual value of the property is determined at a higher level of the property resolution hierarchy.
When not explicitly set, the actual value of the property is determined at a higher level of the property resolution hierarchy.
The Shadow property is not applicable when the
When not explicitly set, the actual value of the property is determined at a higher level of the property resolution hierarchy.
When not explicitly set, the actual value of the property is determined at a higher level of the property resolution hierarchy.
The value assigned to this property must be a value between the range of 1 and 1638 DTPs (desktop publishing points), inclusive.
The unit of measurement used to express the property value is defined by the
The value assigned to this property must be between the range of 1 and 600, inclusive.
This property represents the percentage of scaling, with a value of 100 representing the default scaling for the font. Values less than 100 cause the font to be horizontally compressed; Values greater than 100 cause the font to be horizontally elongated.
The value assigned to this property must be a value between the range of -1584 and +1584 DTPs (desktop publishing points), inclusive.
This property represents the amount of space that appears between horizontally adjacent characters.
The unit of measurement used to express the property value is defined by the
The value assigned to this property must be a value between the range of -1584 and +1584 DTPs (desktop publishing points), inclusive. A value of zero restores the position to normal as relative to the baseline.
This property represents the amount of vertical space between the bottom of the character and the baseline for the associated font. Positive values cause characters to appear higher than characters whose position is normal as relative to the baseline; negative values cause characters to appear lower.
The unit of measurement used to express the property value is defined by the
For tables, the LeftIndent property is not applicable when the
The unit of measurement used to express the property value is defined by the
The unit of measurement used to express the property value is defined by the
The unit of measurement used to express the property value is defined by the
The LineSpacingExact,
In the case where more than one of the properties is explicitly set, the order of precedence is as follows:
The unit of measurement used to express the property value is defined by the
The
In the case where more than one of the properties is explicitly set, the order of precedence is as follows:
The unit of measurement used to express the property value is defined by the
The LineSpacingAuto property provides a way for the developer to space lines
such that the actual value is automatically calculated by the document
consumer based on the line height for the associated paragraph. An explicit
value can be specified for line spacing using the
The
In the case where more than one of the properties is explicitly set, the order of precedence is as follows:
Unlike the LineSpacingExact and LineSpacingMinimum properties,
this property's value is always expressed as a multiple
of the line height for the paragraph, and is never converted
based on the value of the associated WordDocumentWriter's
For example, to apply vertical spacing between lines of text that is equal to .5 times the height of the line itself, assign a value of .5 to the LineSpacingAuto property, and leave the values of the LineSpacingExact and LineSpacingMinimum properties at their respective defaults.
This property only applies to paragraph-level properties, and does not
affect the layout of the text within. Setting this property to true has
an effect similar to that of setting the
To change the layout of the text within the paragraph, use the
When set explicitly, the unit of measurement used to express the property value is defined by the
When the
In the absence of an explicit setting, this property resolves to a value that is equal to 8.5 inches in width by 11 inches in height, or, if the PageOrientation property is explicitly set to 'Landscape', 11" x 8.5".
The maximum page size in MS Word is 22" x 22" (see KB article 95109). An exception is thrown if the specified value is outside this range.
In the absence of an explicit setting, this property resolves to a value that is equal to one inch on all sides.
When set explicitly, the unit of measurement used to express the property value is defined by the
In the absence of an explicit setting, this property resolves to .5".
When set explicitly, the unit of measurement used to express the property value is defined by the
In the absence of an explicit setting, this property resolves to .5".
This property is used to ensure that the proper paper type is chosen if the specified paper size matches the sizes of multiple paper types supported by the current printer. How this value is consumed is dependent solely on the printer, and is not interpreted or modified in any way by this class.
Under the default setting, the actual value is resolved based on the ratio of the width to the height of the page size. If the width is greater than the height, this property resolves to 'Landscape', otherwise it resolves to 'Portrait'.
When the PageOrientation property is explicitly set, the value of the
This property is only applicable when a header/footer is
defined for the section. Headers/footers can be created using the
Page numbers can be specified for a header or footer using the
When no value is specified for this property, page numbers continue from the previous section.
The default unit of measurement is a desktop publishing point, which is equal to 1/72 of an inch.
This enumeration is decorated with the System.Flags attribute, which means that the constants defined herein can be combined using the logical OR operator. For example, to specify that a document section should contain both a header and a footer, on all pages, the values 'HeaderAllPages' (0x0001) and 'FooterAllPages' (0x0002) would be combined in a bitwise manner to produce a numerical value of 0x0003, resulting in both a header and a footer on all pages in the section.
The
The following table lists the classnames of the VML shapes associated with each constant:
| ShapeType | VML Shape |
|---|---|
| Line | |
| Rectangle | |
| Ellipse | |
| IsosceleseTriangle | |
| RightTriangle |
A document consumer may interpret the behavior of line breaking characters differently depending on the characters used to represent them. For example, MS Word interprets a carriage return differently depending on whether the content is enclosed within a table cell. Paragraph justification also behaves differently depending on whether a line break or carriage return is used.
Horizontal alignment of a cell's contents is defined at the paragraph level.
This class is used to override the table-level cell properties for a cell or group of cells. One instance can be used to define the properties of multiple cells.
Cell border properties are inherited from the table to which the cell belongs. This property provides a way to interrupt inheritance of table borders for a cell or group of cells.
The instance returned from this property's get method will be
created when it is first requested, i.e., "lazily". A previously
created instance can be assigned (for example, from a previously
created TableCellProperties instance), provided that they are
associated with the same
By default, a cell spans across only one column, typically having the same PreferredWidth as that column. The ColumnSpan property makes it possible to support horizontal cell merging, whereby one cell can appear to span across two or more columns. For example, consider a grid with 3 columns, A, B, and C. If the developer wants the cell in position A to extend to the left edge of cell C, effectively skipping cell B, the ColumnSpan property of cell A would be set to 2.
In addition to setting the ColumnSpan property, the
The default value of zero logically represents a span of one column.
Similarly to how the
When set to 'Start', a vertical merging run begins with this cell. Subsequent cells whose VerticalMerge property is set to 'Continue' will appear to merge with the cell directly above in the same column. When set to 'None', any existing vertical merging run is interrupted. The 'Start' setting also discontinues any existing vertical merging run.
This property is only applicable when the
The PreferredWidth property provides a way to explicitly define the width of the associated table cell. The value is considered preferred because the actual width may be different based on the current table layout algorithm.
The unit of measurement used to express the property value is defined by the
The PreferredWidth property and the
This property is only applicable when the
This value is considered preferred because a consumer may elect to override this value based on the current table layout algorithm.
The valid range for this property's value is a number between .02 and 100. Note that the unit of measure is not defined by the associated document writer's unit of measure.
The PreferredWidthAsPercentage property and the
The properties of the instance returned from this property are also inherited by the cells which appear within the associated table. For example, if the border style is set to 'Dotted' on this instance, the cells within the associated table will acquire that setting, unless the cell has its own overriding border definition.
The unit of measurement used to express the property value is defined by the
By default, the table layout is automatic, which means that cells are automatically sized to fully display their contents. The Layout property can be used to apply explicit column widths.
This property is only applicable when the
The value of this property is considered preferred because a consumer may elect to override this value based on the current table layout algorithm.
The unit of measurement used to express the property value is defined by the
The PreferredWidth property and the
This property is only applicable when the
This value is considered preferred because a consumer may elect to override this value based on the current table layout algorithm.
The valid range for this property's value is a number between .02 and 100. Note that the unit of measure is not defined by the associated document writer's unit of measure.
The PreferredWidthAsPercentage property and the
Values less than zero are not permitted for either parameter; an exception is thrown when a negative value is assigned. Values that would exceed the minimum or maximum allowable value are rounded to the min/max as required.
All borders are drawn for all cells in a table by default; however, in cases where the border style does not preclude it, the borders of adjacent cells are merged, so as not to cause the borders to appear "thicker" than the user would expect. Because of these border merging algorithms, setting this property may not yield the expected result.
Note that the value of this property takes precedence over the
WordprocessingML persists border widths in units equal to one-eighth of a desktop publishing point; this equates to 1/576 of an inch. The range of valid values spans from one-fourth of a point to 12 points.
A value which is based on a specific number of pixels can be assigned using the
WordprocessingML supports border thicknesses up to one-sixth of an inch. Values which exceed this amount are not recognized, and the resulting border thickness resolves to this value.
By default, the first cell of the row is displayed in the first logical grid position. This property can be used to "offset" the beginning of the row; this can be useful in situations where the row should appear indented with respect to other rows in the same table.
By default, the last cell of the row is displayed in the last logical grid position. This property can be used to omit one or more cells from the end of the row.
The unit of measure is determined by the value of the
When a value is explicitly assigned to the Height property, but not to the
When the HeightRule property is set to 'Auto', the value of the Height property is not applicable.
By default, the row height rule is 'Auto', unless a value is explicitly assigned to the Height property, in which case it defaults to 'Exact'. Explicitly assigning a value to the HeightRule property overrides this behavior.
In the case where this property is not explicitly set, rows are allowed to span multiple pages. This property can be explicitly set to false to ensure that the associated row is not displayed on more than one page.
This method returns an instance which contains a reference to this class,
which enables the instance to observe the
The instance returned from this method can be passed to the
This method returns an instance which contains a reference to this class,
which enables the instance to observe the
The instance returned from this method can be passed to the
This method returns an instance which contains a reference to this class,
which enables the instance to observe the
The instance returned from this method can be passed to the
This method returns an instance which contains a reference to this class,
which enables the instance to observe the
The instance returned from this method can be passed to the
This method returns a font which contains a reference to this class,
which enables the font to observe the
The font returned from this method can be passed to the
This method returns an instance which contains a reference to this class,
which enables the instance to observe the
The instance returned from this method can be passed to the
This method returns an instance which contains a reference to this class,
which enables the instance to observe the
The instance returned from this method can be passed to the
This method returns an instance which contains a reference to this class,
which enables the instance to observe the
The instance returned from this method can be passed to the
This method returns an instance which contains a reference to this class,
which enables the instance to observe the
The instance returned from this method can be passed to the
This method returns an instance which contains a reference to this class,
which enables the instance to observe the
The instance returned from this method can be passed to the
This method returns an instance which contains a reference to this class,
which enables the instance to observe the
The instance returned from this method can be passed to the
This method returns an instance which contains a reference to this class,
which enables the instance to observe the
The instance returned from this method can be passed to the
The instance returned from this method can be passed to the
This method returns an instance which contains a reference to this class,
which enables the instance to observe the
The instance returned from this method can be passed to the
This method returns an instance which contains a reference to this class,
which enables the instance to observe the
The instance returned from this method can be passed to the
This method returns an instance which contains a reference to this class,
which enables the instance to observe the
The instance returned from this method can be passed to the
This method returns an instance which contains a reference to this class,
which enables the instance to observe the
The instance returned from this method can be passed to the
Word processing content consumers such as MS Word may retain the previous paragraph's properties when a new paragraph is added. Adding an empty paragraph after a paragraph with non-default formatting attributes prevents subsequent paragraphs from inheriting these attributes.
This method starts a <paragraph> element.
Callers are responsible for closing this element. The
<paragraph> element can be closed by calling the
This overload uses the default alignment (left) with no indentation.
To specify formatting attributes such as alignment, indentation, etc., use the
This method starts a <p> element.
Callers are responsible for closing this element. The
<p> element can be closed by calling the
The actual character code(s) used in the generated content are determined by the
Before the AddNewLine method can be called, the developer must begin a paragraph via the
Some consumers do not always recognize newline characters within the content.
For example, MS Word does not escape the current line when the paragraph appears
within a table cell. The
Before the AddNewLine method can be called, the developer must begin a paragraph via the
Some consumers do not always recognize newline characters within the content.
For example, MS Word does not escape the current line when the paragraph appears
within a table cell. The
Before the AddTextRun method can be called, the developer must begin a paragraph via the
A new Font instance can be obtained using the
Before the AddTextRun method can be called, the developer must begin a paragraph via the
Before the AddTextRun method can be called, the developer must begin a paragraph via the
Before the AddTextRun method can be called, the developer must begin a paragraph via the
Before the AddHyperlink method can be called, the developer must begin a paragraph via the
Before the AddHyperlink method can be called, the developer must begin a paragraph via the
Before the AddHyperlink method can be called, the developer must begin a paragraph via the
Before the AddHyperlink method can be called, the developer must begin a paragraph via the
This overload makes it possible for the developer to display text with mixed
font attributes in the hyperlink. Each text fragment with different font
attributes must be manifested as a separate text run. Each one is added to
the
Before the AddHyperlink method can be called, the developer must begin a paragraph via the
In the case where the
A
Before the AddInlinePicture method can be called, the developer must begin a paragraph via the
Before the AddInlinePicture method can be called, the developer must begin a paragraph via the
Before the AddInlineShape method can be called, the developer must begin a paragraph via the
Before the AddInlineShape method can be called, the developer must begin a paragraph via the
Before the AddInlineShape method can be called, the developer must begin a paragraph via the
Before the AddInlineShape method can be called, the developer must begin a paragraph via the
Before the AddAnchoredPicture method can be called, the developer must begin a paragraph via the
An AnchoredPicture instance can be obtained using the
Before the AddAnchoredPicture method can be called, the developer must begin a paragraph via the
Before the AddAnchoredShape method can be called, the developer must begin a paragraph via the
An AnchoredShape instance can be obtained using the
Before the AddAnchoredShape method can be called, the developer must begin a paragraph via the
This method starts a <tbl> element.
Callers are responsible for closing this element. The
<tbl> element can be closed by calling the
This method starts a <tbl> element.
Callers are responsible for closing this element. The
<tbl> element can be closed by calling the
This method starts a <tbl> element.
Callers are responsible for closing this element. The
<tbl> element can be closed by calling the
A table must contain at least one and no more than 63 columns; specifying a value outside this range results in an exception being thrown.
WordprocessingML does not natively store the concept of pages, since the number of pages in a document is driven by the nature of the content. Consider the case where the user changes the size of the font for all text in a document; the number of pages in that document is likely to change, since factors such as the number of characters in the document and the size of each character determine the total amount of space required to present the content.
This method defines a section which applies to content (i.e., paragraphs and tables) that was previously written to the document. The properties of the object passed to this method define the page size, orientation, and margins for the pages on which that content will appear, thus defining a section in the document to which the designated content belongs.
Example: To add three paragraphs which are to appear on pages that are 7" x 5" at landscape orientation, first call the StartDocument, AddTextRun, and EndDocument methods for each of the three paragraphs. Next, call the DefineSection method, passing in a SectionProperties instance on which the PageSize property is set to (7, 5), and the PageOrientation property is set to 'Landscape'.
The
The unit of measure in which the return value is expressed
is defined by the value of the
Use the
One inch is equal to 1,440 twips (twentieths of a desktop point).
One inch is equal to 72 desktop points.
Derived classes must override this method and release any resources currently in use.
This property defines the pagination for all content within the
document which is not explicitly associated with a section defined
via the
In the case where the
Headers and/or footers can be defined for the final section using the
The default unit of measurement for the properties which represent graphical quantities is the desktop publishing point, which is equivalent to 1/72 of an inch. This property can be changed to redefine that unit of measurement, so that graphical properties can be interacted with using units that are most comfortable to the end developer.
All property values are stored internally as twips (twentieths of a point), and coverted as appropriate in the property's get and set method implementations. The value of the Unit property can be changed at any time by the developer without affecting previously persisted property values.
The newline character(s) can be represented as either a line break or a carriage return. A document consumer may interpret a line break or carriage return differently depending on the circumstances under which it is used. For example, paragraph justification can behave differently in MS Word depending on whether a line break is contained within the paragraph. A carriage return is recognized in a standard paragraph as a line-breaking character, but is not recognized when the paragraph is contained within a table cell.
The WordprocessingMLWriter class is a concrete implementation of the
The developer communicates with the WordDocumentWriter in a "forward-only" manner; as soon as a content creation method is called, that content is irreversibly written to the target document. While this method is generally considered to be more complicated, it offers the benefit of a greatly reduced memory footprint over an object-driven approach.
A new instance of this class can be created using the
To begin a new WordprocessingML document, the developer calls the
After the StartDocument method is called, blocks of content can be added via (for example) the
Attempting to add content to the document when the writer is not in the required
state for the operation causes a
After all content blocks have been added, the developer calls the
Page size, margins, and orientation can be set for the entire document via the
The content stream is closed when the WordDocumentWriter is disposed of, and the resulting WordprocessingML file is created.
The developer can specify the unit of measure to be used when interpreting
properties which represent graphical measurements using the
This method starts the <document> and <body> elements
for the wordprocessingML document. Callers are responsible for
closing all elements written to the document stream. The
<document> and <body> elements can be closed by calling
the
This method starts a <p> element.
Callers are responsible for closing this element. The
<p> element can be closed by calling the
Before the AddTextRun method can be called, the developer must begin a paragraph via the
An AnchoredPicture instance can be obtained using the
Before the AddAnchoredPicture method can be called, the developer must begin a paragraph via the
An AnchoredShape instance can be obtained using the
Before the AddAnchoredShape method can be called, the developer must begin a paragraph via the
Shapes are rendered by the consumer using Vector Markup Language (VML), which is supported in both MS Word 2007 and MS Word 2010.
Before the AddInlineShape method can be called, the developer must begin a paragraph via the
Shapes are rendered by the consumer using Vector Markup Language (VML), which is supported in both MS Word 2007 and MS Word 2010.
This method starts a <tbl> element.
Callers are responsible for closing this element. The
<tbl> element can be closed by calling the
A table must contain at least one and no more than 63 columns; specifying a value outside this range results in an exception being thrown.
WordprocessingML does not natively store the concept of pages, since the number of pages in a document is driven by the nature of the content. Consider the case where the user changes the size of the font for all text in a document; the number of pages in that document is likely to change, since factors such as the number of characters in the document and the size of each character determine the total amount of space required to present the content.
This method defines a section which applies to content (i.e., paragraphs and tables) that was previously written to the document. The properties of the object passed to this method define the page size, orientation, and margins for the pages on which that content will appear, thus defining a section in the document to which the designated content belongs.
Example: To add three paragraphs which are to appear on pages that are 7" x 5" at landscape orientation, first call the StartDocument, AddTextRun, and EndDocument methods for each of the three paragraphs. Next, call the DefineSection method, passing in a SectionProperties instance on which the PageSize property is set to (7, 5), and the PageOrientation property is set to 'Landscape'.
The
If the
If the StartDocument method was previously called, but the
If the document has been properly started but has not yet been closed
by a call to the
This property defines the pagination for all content within the
document which is not explicitly associated with a section defined
via the
In the case where the
Headers and/or footers can be defined for the final section using the
The DefaultFont property can be used to assign a document-level font, the attributes of which all text runs acquire when no more specific setting exists. For example, to italicize the entire document, set the Italic property of the font returned by this property to true.
If the 'FooterAllPages' bit was set on the 'sectionParts' parameter when the
If the 'FooterAllPages' bit was not set, this property returns null.
If the 'HeaderAllPages' bit was set on the 'sectionParts' parameter when the
If the 'HeaderAllPages' bit was not set, this property returns null.
If the 'FooterFirst' bit was set on the 'sectionParts' parameter when the
If the 'FooterFirst' bit was not set, this property returns null.
If the 'HeaderFirst' bit was set on the 'sectionParts' parameter when the
If the 'HeaderFirst' bit was not set, this property returns null.
This method can only be called when a paragraph is currently open. A page number field is similar to a text run; it can be embedded within the paragraph adjacent to any other kind of content such as text, images, or hyperlinks.
A page number field can be added to either a header or footer.
The page number for the first page in a section can be explicitly set using the
This method can only be called when a paragraph is currently open. A page number field is similar to a text run; it can be embedded within the paragraph adjacent to any other kind of content such as text, images, or hyperlinks.
A page number field can be added to either a header or footer.
The page number for the first page in a section can be explicitly set using the
Before the AddInlineShape method can be called, the developer must begin a paragraph via the
Before the AddInlineShape method can be called, the developer must begin a paragraph via the
The methods exposed by this class are syntactically identical to the
corresponding methods of the
At the time that the containing
This instance stays alive until it is explicitly discarded by the consumer,
or until the associated
Unlike the WordDocumentWriter, which requires a 'StartDocument' method to be called
prior to calling content creation methods, all required prologues are automatically
written to the content stream when the
Page numbers can be specified for a header or footer using the
The
This method writes the root element to the package part associated with the header/footer, but writes no content.
The Close method closes the underlying XML writer, which finalizes the content and commits it to the associated package part.
This method can only be called when a paragraph is currently open. A page number field is similar to a text run; it can be embedded within the paragraph adjacent to any other kind of content such as text, images, or hyperlinks.
A page number field can be added to either a header or footer.
The page number for the first page in a section can be explicitly set using the
In the case where the
Use the
The TextRuns property can be used to create a hyperlink with mixed formatting attributes. Each element in the list contains a fragment of the text to be displayed along with the font which defines the formatting attributes for that fragment.
The