NDocument Class

In This Topic

Represents a document, that is the root element of an logically connected subtree of elements.

Object Model

Syntax

public abstract class NDocument : NDocumentNode, INDomDeepEquals, INDomDeeplyCloneable, Nevron.Nov.INDeeplyCloneable

Remarks

Documents are elements, which host a single content element, which can be obtained from the Content property. The content of a document is in this way defined by a hierarchy of elements, the root element of which is the one and only element child of the document.

Documents provide its content element subtree with a consistent formatting model based on cascade style sheets, that are accessible from the StyleSheets property. Typically the document stylesheets are created by themes.

Documents provide its document nodes subtree with optional support for undo/redo. The undo/redo functionally of the document is encapsulated in an instance of the NHistoryService class, which can be obtained by the HistoryService property.

Documents are deferrly evaluated, meaning that elements that reside in a document do not immediately perform expression calculations, computed values calculations and measurement and layout, but rather wait for the document to call them back when it is time to do so. The evaluation of the document is performed by the Evaluate method, which is by default invoked at regular intervals of times. The frequency of document evaluation is controlled by the EvaluationRate property.

Because the document is a document node, it can reside in the hierachy of another document. A document is said to be "Embedded", if it resides in another document. A document is said to be "Compound", if it has embedded documents.

When a document is embedded you can specify whether it needs to inherit the cascade stylesheets of the owner document, with the help of the InheritStyleSheets property. The stylesheets inherited by the owner document cascade are always of Inherited origin, while stylesheets contained inside the document StyleSheets collection are always of Local origin.

The evaluation of an embedded document is integrated in the evaluation of the compound document in which it resides.

Inheritance Hierarchy

System.Object
   Nevron.Nov.Dom.NNode
      Nevron.Nov.Dom.NDocumentNode
         Nevron.Nov.Dom.NDocument
            Nevron.Nov.Dom.NGenericDocument<TContent>

Requirements

Target Platforms: Windows 11, Windows 10, Windows 7, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later)

Reference

NDocument Members
Nevron.Nov.Dom Namespace