System.Windows.Documents.DocumentStructures Namespace
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Provides classes to describe the structure of an XpsDocument in terms of sections, paragraphs, figures, bulleted or numbered lists, and tables.
Classes
| BlockElement |
Do not use. |
| FigureStructure |
Represents a drawing, chart, or diagram in a document. |
| ListItemStructure |
Represents an item in a list or outline. |
| ListStructure |
Represents a list of items in a document. |
| NamedElement |
Identifies an element within the hierarchy of elements under a FixedPage. |
| ParagraphStructure |
Represents a paragraph in a document. |
| SectionStructure |
Represents a section of content in a document. |
| SemanticBasicElement |
An XML element in the markup for XML Paper Specification (XPS) documents. |
| StoryBreak |
Identifies the start or end of story composed of one or more StoryFragment elements. |
| StoryFragment |
Represents all or part of a story within an XPS document. |
| StoryFragments |
Represents a set of one or more StoryFragment elements. |
| TableCellStructure |
Represents a cell in a table. |
| TableRowGroupStructure |
Represents a set of one or more rows in a table. |
| TableRowStructure |
Represents a row of one or more cells in a table. |
| TableStructure |
Represents a table in a document. |
Remarks
The formatting and layout of an XPS document enables different parts of the content to behave in a semantic form such as in paragraphs, tables, and lists. Humans can perceive the semantic structure of the content from its appearance; but the physical format and layout of the markup does not explicitly identify the actual semantic elements. To enable programmatic understanding of the document organization, the System.Windows.Documents.DocumentStructures namespace provides structure elements that can be used to define the document by its semantic parts.
Each page of an XPS document contains a FixedPage element that defines its content in the form of positional text runs and graphics. Through the use of document structure elements, pages of an XPS document can also be associated with StoryFragment elements that define the structure of the page in the form of sections, paragraphs, lists, figures, and tables. The NamedElement class is used to define the associations between content and structure parts of the document markup. A NamedElement is the child of a structural element, such as a table cell or bullet list item that is located in the StoryFragment hierarchy of a page. A NamedElement identifies an item in the FixedPage hierarchy of the same page. The item it refers to is the content of the structural element.
Applications that create XPS documents are not required to include structural markup, but use of document structure elements enhances the flexibility by which applications can access and use the content of a document.
For more information about structure elements of XPS documents, see Chapter 9 and Appendix E of the XML Paper Specification (XPS) available for download at Ecma International.
