3 Structure Examples


This section contains examples of some of the most commonly used structures in OneNote files. The examples are based on common content found in a OneNote file.

For readability in the examples, the content of a OneNote file is presented as XML. The following should be noted when reading the XML:

  • Unless otherwise noted, the names of the XML elements correspond to the names of Property structures, or Property Set structures (section 2.1.13) if the element contains a jcid attribute.

  • The jcid attribute corresponds to the JCID value for the object, as specified in [MS-ONESTORE] section 2.6.14.

  • The RootRole attribute corresponds to the RootRole value for root objects (section 2.1.8).

  • For convenience, some objects are presented as child objects of the property that references the object. The id attribute represents the identifier of the objects. With the exception of the Context elements, only the CompactIDs of the objects are given ([MS-ONESTORE] section 2.2.2). When stored in a revision store file, properties that reference objects only store the CompactID of the object.

  • The id attribute of the Context elements are presented as an ExtendedGUID ([MS-ONESTORE] section 2.2.1) for the identification of the Context ([MS-ONESTORE] section 2.1.11).

  • For properties that store an array of elements, the value is presented as a comma-delimited list within curly-braces, unless the objects are presented as child elements of the property.

  • Properties that contain a FILETIME structure (as specified in [MS-DTYP]) or Time32 structure (section 2.3.1) are presented as friendly text rather than a numeric value.

  • The values of some complex structures (such as LayoutAlignment, Color, and COLORREF) are abbreviated as an unsigned 32-bit integer, rather than the individual fields of the structure.

For brevity, not all property values are explained in the examples: only those that are relevant to the purpose of the example, or a subset for illustrative purposes. References to additional properties can be found in the table of properties (section 2.1.12).

Section 3.1 provides an example of a complete OneNote file that is a section containing a single page.