Permission to copy, display and distribute the contents of this document (the Specification ), in any medium for any purpose without fee or royalty is hereby granted, provided that you include the following notice on ALL copies of the Specification, or portions thereof, that you make: Copyright (c) Microsoft Corporation. All rights reserved. Permission to copy, display and distribute this document is available at: http://msdn.microsoft.com/library/en-us/odcXMLRef/html/odcXMLRefLegalNotice.asp?frame=true. No right to create modifications or derivatives of this Specification is granted herein. There is a separate patent license available to parties interested in implementing software programs that can read and write files that conform to the Specification. This patent license is available at this location: http://www.microsoft.com/mscorp/ip/format/xmlpatentlicense.asp. THE SPECIFICATION IS PROVIDED "AS IS" AND MICROSOFT MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, OR TITLE; THAT THE CONTENTS OF THE SPECIFICATION ARE SUITABLE FOR ANY PURPOSE; NOR THAT THE IMPLEMENTATION OF SUCH CONTENTS WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS. MICROSOFT WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF OR RELATING TO ANY USE OR DISTRIBUTION OF THE SPECIFICATION. The name and trademarks of Microsoft may NOT be used in any manner, including advertising or publicity pertaining to the Specification or its contents without specific, written prior permission. Title to copyright in the Specification will at all times remain with Microsoft. No other rights are granted by implication, estoppel or otherwise. ==================== B A S I C T Y P E S ====================== EMPTY ELEMENT Defines an element with no content or attributes. BOOLEAN PROPERTY / TYPE Defines a type with values of on or off. Defines a property with values of on or off. Gets or sets the Boolean value of either on or off. Defines a type with values of yes or no. LONG HEX NUMBER PROPERTY / TYPE Defines a 4-byte hexadecimal number that is 8 hexadecimal digits in length. Defines a property that uses a 4-byte hexadecimal number that is 8 hexadecimal digits in length. Gets or sets the value of a 4-byte hexadecimal number that is 8 hexadecimal digits in length. SHORT HEX NUMBER PROPERTY / TYPE Defines a 2-byte hexadecimal number that is 4 hexadecimal digits in length. Defines a property that uses a 2-byte hexadecimal number that is 4 hexadecimal digits in length. Gets or sets the value of a 2-byte hexadecimal number that is 4 hexadecimal digits in length. MEDIUM HEX NUMBER PROPERTY / TYPE Defines a 3-byte hexadecimal number that is 6 hexadecimal digits in length. Defines a property that uses a 3-byte hexadecimal number that is 6 hexadecimal digits in length. Gets or sets the value of a 3-byte hexadecimal number that is 6 hexadecimal digits in length. CHARACTER HEX NUMBER PROPERTY / TYPE Defines a 1-byte hexadecimal number that is 2 hexadecimal digits in length. Defines a property that uses a 1-byte hexadecimal number that is 2 hexadecimal digits in length. Gets or sets the value of a 1-byte hexadecimal number that is 2 hexadecimal digits in length. DECIMAL NUMBER PROPERTY / TYPE Defines a decimal number. Defines a property that uses a decimal number. Gets or sets the value of a decimal number. TWIPS MEASURE PROPERTY / TYPE Defines a positive measurement in twips (twentieths of a point, 1/1440 of an inch). Defines a property that uses a positive measurement in twips (twentieths of a point, 1/1440 of an inch). Gets or sets the value of a positive measurement in twips (twentieths of a point, 1/1440 of an inch). SIGNED TWIPS MEASURE PROPERTY / TYPE Defines a measurement in twips (twentieths of a point, 1/1440 of an inch) that can be positive or negative. Defines a property that uses a measurement in twips (twentieths of a point, 1/1440 of an inch) that can be positive or negative. Gets or sets the value of a measurement in twips (twentieths of a point, 1/1440 of an inch) that can be positive or negative. PIXELS MEASURE PROPERTY / TYPE Defines a measurement in pixels (screen units). Defines a property that uses a measurement in pixels (screen units). Gets or sets the value of a measurement in pixels (screen units). POINTS MEASURE PROPERTY / TYPE Defines a measurement in points (1/72 of an inch). Defines a property that uses a measurement in points (1/72 of an inch). Gets or sets the value of a measurement in points (1/72 of an inch). HALF-POINTS MEASURE PROPERTY / TYPE Defines a positive measurement in half-points (1/144 of an inch). Defines a property that uses a positive measurement in half-points (1/144 of an inch). Gets or sets the value of a positive measurement in half-points (1/144 of an inch). SIGNED HALF-POINTS MEASURE PROPERTY / TYPE Defines a measurement in half-points (1/144 of an inch) that can be positive or negative. Defines a property that can be a measurement in half-points (1/144 of an inch) that can be positive or negative. Gets or sets the value of a measurement in half-points (1/144 of an inch) that can be positive or negative. BORDER WIDTH TYPE Defines a border-width measurement. For art page borders, values are measured in points (1/72 of an inch) and must be between 1 and 31. For borders that are using a border style instead of art, values are measured in 1/8 of a point and must be between 2 and 96 (1/4 pt and 12 pt). EIGHTH-POINT MEASURE TYPE Defines a measurement in eighths of a point (1/576 of an inch). STRING PROPERTY / TYPE Defines a string. Defines a property that uses a string. Gets or sets the value of a string. TEXT SCALE PROPERTY Defines a text-scale percentage value (1 to 600). Defines a property that uses a text-scale percentage value (1 to 600). Gets or sets a text-scale percentage value (1 to 600). HIGHLIGHT COLOR VALUES Defines a highlight-color value. HIGHLIGHT PROPERTY Defines a property that uses a highlight-color value. Gets or sets a highlight-color value. HEX COLOR PROPERTY / TYPE Defines a hexadecimal color value. Defines a property that uses a hexadecimal color value. Gets or sets a hexadecimal color value in the format of RRGGBB or auto. LANGUAGE PROPERTY / TYPE Defines an ISO-6391-letter code or 4-digit hexadecimal code for a language. Defines a property that uses an ISO-6391-letter code or 4-digit hexadecimal code for a language. Gets or sets an ISO-6391-letter code or 4-digit hexadecimal code for a language. UNDERLINE VALUES Defines an underline style. UNDERLINE PROPERTY Defines a property that uses an underline style. Gets or sets an underline style. Gets or sets an underline color. TEXT EFFECT VALUES Defines text-effect style values. TEXT EFFECT PROPERTY Defines a property that uses text-effect style values. Gets or sets text-effect style values. BORDER VALUES Defines border-style values. BORDER PROPERTY Defines a property that uses border-style values. Gets or sets border-style values. Gets or sets the border color. Gets or sets the border width. This is the html equivalent of the border width, in points. this takes into account different internal border styles and represents the appropriate final presentation width. Gets or sets the border space in eighths of a point. Gets or sets a value indicating whether the border has a shadow. Gets or sets a value indicating whether to create a frame effect by reversing the border. SHADING VALUES Defines shading-style values. SHADING PROPERTY Defines a property that uses shading-style values. Gets or sets shading-style values. Gets or sets a foreground-shading color value. Gets or sets a background-fill color value. The HTML equivalent of the background color. This takes into account various shading settings and represents the appropriate final presentation color. VERTICAL ALIGN RUN TYPE Defines the possible settings for vertical alignment of a run of text. Returns the text in this run to the baseline and returns it to the original font size. Raises the text in this run above the baseline and changes it to a smaller size, if a smaller size is available. Lowers the text in this run below the baseline and changes it to a smaller size, if a smaller size is available. VERTICAL ALIGN RUN PROPERTY Defines a property that uses settings for vertical alignment of a run of text. Gets or sets the vertical-alignment setting. FIT TEXT PROPERTY Defines the width of space into which a run of text should fit. Gets or sets the width of space into which a run of text should fit. Gets or sets a unique internal ID that associates multiple runs of fit text. HYPHEN RULE Defines hyphenation options. HYPHEN PROPERTY Defines a property that uses hyphenation options. Gets or sets the hyphen character. Gets or sets the hyphenation rule. EMPHASIS VALUE Defines the emphasis mark. EMPHASIS PROPERTY Defines a property that uses the emphasis mark. Gets or sets the type of emphasis mark. LANGUAGE ELEMENT Defines language-related settings. Gets or sets Latin-language settings Gets or sets Asian-language settings. Gets or sets complex-scripts language settings. ASIAN LAYOUT ELEMENT Specifies bracket style to put around combined text. Specifies combining of either lines or letters. Defines a text layout for Asian languages. Gets or sets a unique internal ID that associates multiple runs of Asian text. Gets or sets a value indicating whether to combine lines or letters. Gets or sets bracket style to put around combined text. Gets or sets a rotation value for Asian half-width characters so that they appear properly as vertical text. Gets or sets a compression value for the rotated text so it fits within one character unit. ABSOLUTE X ALIGN VALUE Defines horizontal (x-axis) alignment values. ABSOLUTE Y ALIGN VALUE Defines vertical (y-axis) alignment values. HEIGHT RULE Specifies how height (h) should be interpreted. Height is automatically calculated. Height should be the exact value specified. Height should be at least the value specified. WRAP VALUE Defines text-wrapping values. Auto wrapping Places object at insertion point in line of text in the document. Wrap text around frame. Wrap text around object instead of bounding box. Places object behind text and removes text wrapping. Places object in front of text and removes text wrapping. VANCHOR VALUE Defines vertical-anchor values. Measure from edge of paragraph Measure from edge of margin Measure from edge of page HANCHOR VALUE Defines horizontal-anchor values. DROP CAP TYPE VALUE Defines drop cap settings. Not a drop cap Dropped in text. Dropped in margin FRAME PROPS PROPERTY Defines frame settings. Gets or sets the position for a drop cap. Gets or sets the lines to drop for a drop cap. Gets or sets frame width. Gets or sets frame height. Gets or sets distance between frame and text above and below the frame. Gets or sets distance between frame and text to the right and left of the frame. Gets or sets text wrapping (valid: none and around). Gets or sets the point from which to measure horizontal position/alignment. Gets or sets the point from which to measure vertical position/alignment. Gets or sets horizontal position Gets or sets horizontal alignment (overrides position). Gets or sets vertical position. Gets or sets vertical alignment (overrides position). Gets or sets how should height (h) be interpreted. Locks the anchor of the frame to the paragraph that currently contains it. TAB JUSTIFICATION VALUE Defines tab-justification settings. Clear the tab that appears at this position due to inherited properties from a style. Extend text to the right of the tab stop. Center text at the tab stop. Extend text to the left of the tab stop. Align a decimal point at the tab stop. Insert a vertical line at the tab stop. Special tab stop used for lists only. TAB LEADER VALUE Defines a tab-leader character. No leader line Dotted leader line Dashed leader line Solid leader line Heavy solid leader line (appears as middle-dot in Word 2000 and beyond) Bullet character leader line TAB PROPERTY Defines a tab stop. Gets or sets tab alignment (or clear). Gets or sets style of the empty space in front of the tab. Gets or sets position. LINE SPACING RULE VALUE Defines a line-spacing rule. SPACING PROPERTY Defines a property that uses line-spacing rules. Gets or sets amount of space above paragraph. Gets or sets number of lines before paragraph (when using character units). Gets or sets whether space/lines before a paragraph is automatic. Gets or sets amount of space below paragraph. Gets or sets number of lines after paragraph (when using character units) Gets or sets whether space/lines after a paragraph is automatic. Gets or sets amount of vertical spacing between lines of text. Specifies interpretation of line attribute. INDENT PROPERTY Defines indentation settings. Specifies space between left margin and text. Negative values move text into margin. Specifies character spaces between left margin and text (when using character units). Negative values move text into margin. Specifies space between text and right margin. Negative values move text into margin. Specifies character spaces between text and right margin (when using character units). Negative values move text into margin. Specifies hanging indent for all lines after first. Specifies character-space hanging indent for all lines after first (when using character units). Specifies indent for first line only (cannot be used with hanging attribute). Specifies character spacing indent for first line only (cannot be used with hanging-chars attribute). JUSTIFICATION VALUE Defines a justification setting. Both left and right justified. JUSTIFICATION PROPERTY Defines a property that uses a justification setting. Gets or sets the value of a justification setting. VIEW VALUE Defines view modes in Word. No view specified. Print Layout view is an editing view that displays your document as it will print. Print layout view uses more system memory, so scrolling may be slower, especially if your document contains many pictures or complex formatting. A view in which you can examine and work with the structure of your file in classic outline form. Work in outline view when you need to organize and develop the content of your file. A view similar to outline view, but designed for master documents which contain subdocuments. The default document view for most word-processing tasks, such as typing, editing, and formatting. Web Layout view is an editing view that displays your document as it will appear in a Web browser. VIEW PROPERTY Controls the view mode in Word. Gets or sets view mode in Word. ZOOM VALUE Defines zoom modes in Word. No zoom specified. Reduces the display so the entire page fits within the document window. This option is available only if you are in print layout view. Reduces or enlarges the display of your document so that it fits within the left and right margins. 'best-fit' (Page width) displays your document so you don't have to scroll horizontally to see a whole line of text. Reduces or enlarges the display of your document to the width of the text on the page. ZOOM PROPERTY Controls how large or small the document appears on the screen. Gets or sets a zoom value based on the size of the window. Gets or sets the percentage (between 10 and 500) at which you want to view your document. WRITING STYLE PROPERTY Defines the writing style you want Word to use to check grammar in this document (Spelling and Grammar option). Gets or sets writing-style language. Gets or sets writing-style DLL vendor ID. Gets or sets writing-style DLL version. Specifies whether the DLL is NLCheck or not. Gets or sets the rule set for the writing style. PROOF TYPE Defines the values for the state of proofing tools. The proofing tool finished checking this document. Errors are marked and only the errors will be rechecked on open. The proofing tool did not finish checking this document. The entire document will have to be rechecked on open. PROOF PROPERTY Defines the state of proofing tools in this document. Gets or sets the state of the spelling checker in this document. Gets or sets the state of the grammar checker in this document. DOC TYPE VALUE Defines a document type. DOC TYPE PROPERTY Defines a property that uses a document type. Gets or sets document type. DOC PROTECT VALUE Defines document-protection editing-restriction values. No document protection; reviewers may make any changes to the document. Let's reviewers make no changes to the document. Let's reviewers insert comments but does not let reviewers change the contents of the document. Let's reviewers change a document but highlights all changes so that the author can track changes. While a document is protected for tracked changes, you cannot turn orr changes tracking nor can you accept or reject tracked changes. Protects a document from changes except in form fields or unprotected sections. To turn protection on or off for a section see the 'FormProt' element inside 'sectPr'. DOC PROTECT PROPERTY Helps prevent unintentional changes to all or part of an online form or document as specified. Gets or sets editing restrictions. Helps prevent unintentional editing changes as specified. Gets or sets formatting restrictions. Prevents unintentional formatting changes except as allowed. This setting does not have an effect unless the formattingEnabled attribute is on. Gets or sets whether the specified restrictions are currently being enforced for this document. Gets or sets password key to unprotect this document from unintentional formatting/editing changes. This password is not secure. MAIL MERGE DOC TYPE VALUE Defines a document type for a mail-merge operation. Catalog Envelopes Mailing Labels Form Letters E-Mail Fax MAIL MERGE DOC TYPE PROPERTY Defines a property that uses a document type for a mail-merge operation. Gets or sets the value of a document type for a mail-merge operation. MAIL MERGE DATA TYPE VALUE Defines a data type for a mail-merge operation. MAIL MERGE DATA TYPE PROPERTY Defines a property that uses a data type for a mail-merge operation. Gets or sets the value of a data type for a mail-merge operation. MAIL MERGE DEST VALUE Defines a destination for a mail-merge operation. MAIL MERGE DEST PROPERTY Defines a property that uses a destination for a mail-merge operation. Gets or sets the value of a destination for a mail-merge operation. MAIL MERGE ODSO FMD FIELD TYPE VALUE Defines Office Data Source Object field types for a mail-merge operation. MAIL MERGE ODSO FMD FIELD TYPE PROPERTY Defines a property that uses Office Data Source Object field types for a mail-merge operation. Gets or sets the value of Office Data Source Object field types for a mail-merge operation. DOC PROP STYLE PROPERTY Defines style reference that is a document property. Gets or sets a built-in style's unique numerical identifier. Gets or sets the style name as show to the user at save time. TRACK CHANGES VIEW PROPERTY Defines view settings for revision tracking in the document. Gets or sets displays track changes markup in document. Defaults to true if not specified. When viewing markup, displays annotations (comments) in document. Defaults to true if not specified. When viewing markup, displays track insertions and deletions in document. Defaults to true if not specified. When viewing markup, displays formatting changes markup in document. Defaults to true if not specified. When viewing markup, displays annotations (comments) in document. Defaults to true if not specified. KINSOKU PROPERTY Specifies characters that are restricted from ending a line (Asian Typography option). Gets or sets the language. Gets or sets a string containing the restriction characters. TEXT DIRECTION VALUE Defines a text-direction setting. Left To Right; Top to Bottom Top to Bottom; Right to Left Bottom to Top; Left to Right Left to Right, Top to Bottom Rotated Top to Bottom; Right to Left Rotated TEXT DIRECTION PROPERTY Defines a property that uses a text-direction setting. Gets or sets the value for a text-direction setting. TEXT ALIGNMENT VALUE Defines a text-alignment setting. TEXT ALIGNMENT PROPERTY Defines a property that uses a text-alignment setting. Gets or sets the value of a text-alignment setting. DISPLACED BY SDT VALUE When bookmarks border Structured Document Tags (SDTs), this attribute ensures that bookmarks are inserted into the document next to the SDTs. We use this attribute because SDTs appear in our XML how they logically appear in the Word document, but not necessarily in the same location as they are in the document. When we displace the SDTs, we also displace the bookmarks next to them so that the intended result is in the XML file. ANNOTATION TYPE VALUES Represents the Word element expressed by this Annotation Markup Language (AML) annotation tag. ANNOTATION ATTRIBUTE GROUP Gets or sets the Word element expressed by this Annotation Markup Language (AML) annotation tag. For bookmarks, specifies the bookmark name. For bookmarks denoting the range of a comment, specifies the initials of the comment's author. For table bookmarks, specifies the column this bookmark begins in. For table bookmarks, specifies the column this bookmark ends in. Gets or sets the original numbering on display field revision marking. When bookmarks border Structured Document Tags (SDTs), this attribute ensures that bookmarks are inserted into the document next to the SDTs. We use this attribute because SDTs appear in our XML how they logically appear in the Word document, but not necessarily in the same location as they are in the document. When we displace the SDTs, we also displace the bookmarks next to them so that the intended result is in the XML file. Defines a list. Represents list-level number. Represents list instantiation (matches lists). The textual representation of this list level. The font of the list level. Revision marking of these list properties. Defines a paragraph border. Represents top border. Represents left border. Represents bottom border. Represents right border. Represents between border. Represents bar border. Defines a collection of tab stops. Represents a tab stop. G L O B A L A T T R I B U T E S Indicates that the XML tag was an auto-recognized smart tag. Gets or sets placeholder text, a Word attribute on user-defined tags. PARA ELEMENT Defines a collection of paragraph settings. Represents paragraph style. Represents Keep with Next Paragraph option: Prevents a page break between this paragraph and the next. Represents Keep Lines Together option: Prevents a page break in this paragraph. Represents Page Break Before option: Forces a page break before this paragraph. Represents text frame and drop cap properties. Represents Widow/Orphan Control option: Prevents Word from printing the last line of a paragraph by itself at the top of the page (widow) or the first line of a paragraph at the bottom of a page (orphan). Represents list properties. Prevents line numbers from appearing next to paragraph. This setting has no effect in documents or sections with no line numbers. Represents borders for the paragraph. Represents paragraph shading. Represents tab stop list. Prevents automatic hyphenation. Use East Asian typography and line-breaking rules to determine which characters begin and end a line on a page (Asian Typography option). Allows a line to break in the middle of a Latin word (Asian Typography option). Allows punctuation to continue one character beyond the alignment of other lines in the paragraph. If you do not use this option, all lines and punctuation must be perfectly aligned (Asian Typography option). Allows punctuation to compress at the start of a line, which lets subsequent characters move in closer (Asian Typography option). Automatically adjusts character spacing between East Asian and Latin text (Asian Typography option). Automatically adjusts character spacing between East Asian text and numbers (Asian Typography option). Sets the alignment and reading order for a paragraph to right-to-left. Automatically adjusts the right indent when you are using the document grid. Aligns text to document grid (when grid is defined). Represents spacing between lines and paragraphs. Represents paragraph indentation. Specifies not to add space between paragraphs of the same style. Specifies not to allow this frame to overlap. Represents paragraph alignment. Represents orientation for the paragraph in the current cell, text box, or text frame. Determines the vertical alignment of all text in a line (Asian Typography option). Represents outline level. Represents ID of HTML DIV element this paragraph is currently in. A string representation of a binary bitmask that represents the conditional formatting results for this paragraph within a table cell (left to right): FirstRow, LastRow, FirstColumn, LastColumn, Band1Vertical, Band2Vertical, Band1Horizontal, Band2Horizontal, NE Cell, NW Cell, SE Cell, SW Cell. Represents run properties for the paragraph mark. Represents section properties for section that terminates at this paragraph mark. Revision marking of these paragraph properties BINARYDATA TYPE Defines the binary data that represents a movie or object. Gets or sets the name of the binary data in this element. Defines the basic type for base64-encoded binary data. OCX Type Contains data for the OCX control this object represents. Gets or sets an OCX control ID. Gets or sets the name. Gets or sets the class ID. Gets or sets the shape ID. Gets or sets the class name. Gets or sets the width. Gets or sets the height. Gets or sets the alignment. Gets or sets OCX control data. A hint as to whether this OCX supports IPersistPropertyBag Defines document-background settings. Gets or sets the background color for this document. Gets or sets the name of the background. PICTURE TYPE Defines a picture. Contains the binary data representing this object. Contains the binary data representing this movie. Represents the background for this document. Contains data for the Java applet this object represents Contains data for the Access Web Bot this object represents. Contains data for the script anchor this object represents. Contains data for the OCX control this object represents. APPLET TYPE Defines an applet. Contains Java applet arguments. Contains text for the Java applet. SCRIPT ANCHOR TYPE Defines a script in the document. Represents script ID. Represents script language. Represents script arguments. Represents script text. FIELDS Defines a field in the document. Represents field data. Represents the run element. This is the leaf container for data in a Word document -- text, pictures, and so on. Represents simple Word field (with plain text instructions). These fields are run-time calculated entities in Word (for example, page numbers). Represents hyperlink element (analogous to HTML <a href=...> tag). Gets or sets instruction text for a field. Gets or sets whether the field is locked from being recalculated. Defines a property that uses a field character type. Defines a field-delimiting character. Represents field data. Specifies whether this field-delimiting character begins a field definition, separates the field definition from the field instructions, or ends the field definition. Gets or sets whether the field is locked from being recalculated. Defines a hyperlink in the document. Represents the run element. This is the leaf container for data in a Word document -- text, pictures, and so. Represents simple Word field (with plain text instructions). These fields are run-time calculated entities in Word (for example, page numbers). Represents the hyperlink element (analogous to HTML <a href=...> tag). Specifies the bookmark location in the document that the hyperlink will jump to. Specifies the frame target for the hyperlink (that is, the frameset). Specifies the text to show as a ScreenTip for this hyperlink. Tracks locations in documents that have no bookmark targets. Used internally by Word. Gets or sets whether to add this target to the history list when it is navigated to. Gets or sets the hyperlink destination. SECTION PROPERTIES SECTION MARK VALUE Defines section type. Breaks the page so that the next section starts at the top of the next page. Breaks the column so that the next section starts at the top of the next column. Starts a new section immediately without breaking the page. Breaks the page so that the next section starts on the next even numbered page. If this section break falls on an even numbered page, Word leaves the next odd numbered page blank. Breaks the page so that the next section start on the next on the next odd numbered page. If this section break falls on an odd numbered page, Word leaves the next page blank. SECTION MARK TYPE Defines section type. Gets or sets section type. PAPER SOURCE TYPE Defines source for paper in printer. Gets or sets code for the printer tray from which you want the first page of each section to print. Gets or sets code for the printer tray from which you want to print the second and subsequent pages in each section. NUMBER FORMAT VALUES Defines number format values for automatic numbering.