Word.Interfaces.DocumentLoadOptions interface
The Document object is the top level object. A Document object contains one or more sections, content controls, and the body that contains the contents of the document.
Remarks
Properties
| $all | Specifying |
| active |
Gets the name of the active theme and formatting options. |
| active |
Gets the display name of the active theme. |
| active |
Gets the active window for the document. |
| are |
Gets whether Word encrypts file properties for password-protected documents. |
| are |
Specifies whether grammatical errors are marked by a wavy green line in the document. |
| are |
Specifies whether to use the default math settings when creating new equations. |
| are |
Specifies whether to disable features introduced after a specified version. |
| are |
Specifies whether Microsoft Word underlines spelling errors in the document. |
| are |
Specifies whether the styles in this document are updated to match the styles in the attached template each time the document is opened. |
| are |
Specifies whether Microsoft Word embeds TrueType fonts in the document when it's saved. |
| attached |
Specifies a |
| auto |
Specifies if automatic hyphenation is turned on for the document. |
| auto |
Specifies if the edits in the document are automatically saved. |
| background | Gets a |
| bibliography | Returns a |
| body | Gets the |
| built |
Gets a |
| change |
Specifies the ChangeTracking mode. |
| coauthoring | Gets a |
| code |
Gets the code name for the document. |
| compatibility |
Gets the compatibility mode that Word uses when opening the document. |
| consecutive |
Specifies the maximum number of consecutive lines that can end with hyphens. |
| content | Gets a |
| current |
Gets a random number that Word assigns to changes in the document. |
| custom |
Gets a |
| default |
Specifies the interval (in points) between the default tab stops in the document. |
| default |
Specifies the browser frame for displaying a webpage via hyperlink. |
| do |
Specifies whether Word should not embed common system fonts. |
| encryption |
Specifies the name of the algorithm encryption provider that Microsoft Word uses when encrypting documents. |
| far |
Specifies the East Asian language used for line breaking. |
| far |
Specifies the line break control level. |
| formatting |
Specifies whether Word shows the next heading level when the previous is used. |
| formatting |
Specifies whether to show user-defined styles. |
| full |
Gets the name of a document, including the path. |
| grid |
Specifies the horizontal space between invisible gridlines that Microsoft Word uses when you draw, move, and resize AutoShapes or East Asian characters in the document. |
| grid |
Specifies the vertical space between invisible gridlines that Microsoft Word uses when you draw, move, and resize AutoShapes or East Asian characters in the document. |
| grid |
Specifies whether the character grid starts from the upper-left corner of the page. |
| grid |
Specifies the horizontal origin point for the invisible grid. |
| grid |
Specifies the vertical origin point for the invisible grid. |
| grid |
Specifies the interval for horizontal character gridlines in print layout view. |
| grid |
Specifies the interval for vertical character gridlines in print layout view. |
| has |
Gets whether a password is required to open the document. |
| has |
Gets whether the document has an attached Microsoft Visual Basic for Applications project. |
| hyphenate |
Specifies whether words in all capital letters can be hyphenated. |
| hyphenation |
Specifies the width of the hyphenation zone, in points. |
| is |
Specifies whether automatic formatting options override formatting restrictions. |
| is |
Specifies whether charts in the active document use cell-reference data-point tracking. |
| is |
Specifies whether the compatibility option specified by the |
| is |
Specifies whether the document is final. |
| is |
Specifies whether Microsoft Word saves a subset of the embedded TrueType fonts with the document. |
| is |
Specifies whether Microsoft Word prints onto a preprinted form only the data entered in the corresponding online form. |
| is |
Specifies whether Microsoft Word saves the data entered in a form as a tab-delimited record for use in a database. |
| is |
Specifies whether a grammar check has been run on the document. |
| is |
Gets whether the most recent firing of the |
| is |
Gets whether the document is in form design mode. |
| is |
Specifies whether Word kerns half-width Latin characters and punctuation marks. |
| is |
Specifies whether to embed speech and handwriting data. |
| is |
Gets whether this document is a master document. |
| is |
Specifies whether Word optimizes the document for Word 97. |
| is |
Specifies whether PRINT field instructions (such as PostScript commands) in the document are to be printed on top of text and graphics when a PostScript printer is used. |
| is |
Specifies whether users can change the Quick Style set. |
| is |
Gets whether changes to the document cannot be saved to the original document. |
| is |
Specifies whether Microsoft Word displays a message box whenever a user opens the document, suggesting that it be opened as read-only. |
| is |
Specifies whether AutoShapes or East Asian characters are automatically aligned with an invisible grid. |
| is |
Specifies whether AutoShapes or East Asian characters align with invisible gridlines through other shapes. |
| is |
Specifies whether spelling has been checked throughout the document. |
| is |
Specifies whether formatting restrictions are enforced in a protected document. |
| is |
Gets whether this document is a subdocument of a master document. |
| is |
Specifies whether users can change the document theme. |
| is |
Specifies whether the document was created or opened by the user. |
| is |
Gets whether the VBA project is digitally signed. |
| is |
Gets whether the document is protected with a write password. |
| justification |
Specifies the character spacing adjustment. |
| kind | Specifies the format type that Microsoft Word uses when automatically formatting the document. |
| language |
Specifies whether Microsoft Word has detected the language of the document text. |
| no |
Specifies the kinsoku characters after which Word will not break a line. |
| no |
Specifies the kinsoku characters before which Word will not break a line. |
| open |
Gets the encoding used to open the document. |
| original |
Gets the title of the original document after legal-blackline comparison. |
| page |
Returns a |
| password | Sets a password that must be supplied to open the document. |
| password |
Gets the algorithm used for password encryption. |
| password |
Gets the key length used for password encryption. |
| password |
Gets the name of the password encryption provider. |
| path | Gets the disk or the web path to the document (excludes the document name). |
| print |
Specifies whether revision marks are printed with the document. |
| properties | Gets the properties of the document. |
| protection |
Gets the protection type for the document. |
| reading |
Specifies the width of pages in reading layout view when frozen. |
| reading |
Specifies the height of pages in reading layout view when frozen. |
| reading |
Specifies whether pages in reading layout view are frozen for handwritten markup. |
| remove |
Specifies whether Word removes user information upon saving. |
| revised |
Gets the title of the revised document after legal-blackline comparison. |
| saved | Indicates whether the changes in the document have been saved. A value of |
| save |
Specifies the encoding used when saving the document. |
| save |
Gets the file format of the document. |
| selection | Returns a |
| text |
Specifies the encoding for saving as encoded text. |
| text |
Specifies how Word marks line and paragraph breaks in text files. |
| tracked |
Specifies whether to remove or store date and time metadata for tracked changes. |
| track |
Specifies whether to track formatting changes when change tracking is on. |
| track |
Specifies whether to mark moved text when Track Changes is on. |
| track |
Specifies whether changes are tracked in the document. |
| type | Gets the document type (template or document). |
| web |
Gets the |
| write |
Sets a password for saving changes to the document. |
| xml |
Specifies whether error messages are generated from built-in Word messages or MSXML (Microsoft XML). |
| xml |
Specifies whether to save a document through an Extensible Stylesheet Language Transformation (XSLT). |
| xml |
Specifies the path and file name for the XSLT to apply when saving a document. |
Property Details
$all
Specifying $all for the load options loads all the scalar properties (such as Range.address) but not the navigational properties (such as Range.format.fill.color).
$all?: boolean;
Property Value
boolean
activeTheme
Gets the name of the active theme and formatting options.
activeTheme?: boolean;
Property Value
boolean
Remarks
activeThemeDisplayName
Gets the display name of the active theme.
activeThemeDisplayName?: boolean;
Property Value
boolean
Remarks
activeWindow
Gets the active window for the document.
activeWindow?: Word.Interfaces.WindowLoadOptions;
Property Value
Remarks
areFilePropertiesPasswordEncrypted
Gets whether Word encrypts file properties for password-protected documents.
areFilePropertiesPasswordEncrypted?: boolean;
Property Value
boolean
Remarks
areGrammaticalErrorsShown
Specifies whether grammatical errors are marked by a wavy green line in the document.
areGrammaticalErrorsShown?: boolean;
Property Value
boolean
Remarks
areMathDefaultsUsed
Specifies whether to use the default math settings when creating new equations.
areMathDefaultsUsed?: boolean;
Property Value
boolean
Remarks
areNewerFeaturesDisabled
Specifies whether to disable features introduced after a specified version.
areNewerFeaturesDisabled?: boolean;
Property Value
boolean
Remarks
areSpellingErrorsShown
Specifies whether Microsoft Word underlines spelling errors in the document.
areSpellingErrorsShown?: boolean;
Property Value
boolean
Remarks
areStylesUpdatedOnOpen
Specifies whether the styles in this document are updated to match the styles in the attached template each time the document is opened.
areStylesUpdatedOnOpen?: boolean;
Property Value
boolean
Remarks
areTrueTypeFontsEmbedded
Specifies whether Microsoft Word embeds TrueType fonts in the document when it's saved.
areTrueTypeFontsEmbedded?: boolean;
Property Value
boolean
Remarks
attachedTemplate
Specifies a Template object that represents the template attached to the document.
attachedTemplate?: Word.Interfaces.TemplateLoadOptions;
Property Value
Remarks
autoHyphenation
Specifies if automatic hyphenation is turned on for the document.
autoHyphenation?: boolean;
Property Value
boolean
Remarks
autoSaveOn
Specifies if the edits in the document are automatically saved.
autoSaveOn?: boolean;
Property Value
boolean
Remarks
background
Gets a Shape object that represents the background image for the document.
background?: Word.Interfaces.ShapeLoadOptions;
Property Value
Remarks
bibliography
Returns a Bibliography object that represents the bibliography references contained within the document.
bibliography?: Word.Interfaces.BibliographyLoadOptions;
Property Value
Remarks
body
Gets the Body object of the main document. The body is the text that excludes headers, footers, footnotes, textboxes, etc.
body?: Word.Interfaces.BodyLoadOptions;
Property Value
Remarks
builtInDocumentProperties
Gets a DocumentProperties object that represents all the built-in document properties for the document.
builtInDocumentProperties?: Word.Interfaces.DocumentPropertiesLoadOptions;
Property Value
Remarks
changeTrackingMode
Specifies the ChangeTracking mode.
changeTrackingMode?: boolean;
Property Value
boolean
Remarks
coauthoring
Gets a Coauthoring object for managing coauthoring in the document.
coauthoring?: Word.Interfaces.CoauthoringLoadOptions;
Property Value
Remarks
codeName
Gets the code name for the document.
codeName?: boolean;
Property Value
boolean
Remarks
compatibilityMode
Gets the compatibility mode that Word uses when opening the document.
compatibilityMode?: boolean;
Property Value
boolean
Remarks
consecutiveHyphensLimit
Specifies the maximum number of consecutive lines that can end with hyphens.
consecutiveHyphensLimit?: boolean;
Property Value
boolean
Remarks
content
Gets a Range object that represents the main document story.
content?: Word.Interfaces.RangeLoadOptions;
Property Value
Remarks
currentRsid
Gets a random number that Word assigns to changes in the document.
currentRsid?: boolean;
Property Value
boolean
Remarks
customDocumentProperties
Gets a DocumentProperties collection that represents all the custom document properties for the document.
customDocumentProperties?: Word.Interfaces.DocumentPropertiesLoadOptions;
Property Value
Remarks
defaultTabStop
Specifies the interval (in points) between the default tab stops in the document.
defaultTabStop?: boolean;
Property Value
boolean
Remarks
defaultTargetFrame
Specifies the browser frame for displaying a webpage via hyperlink.
defaultTargetFrame?: boolean;
Property Value
boolean
Remarks
doNotEmbedSystemFonts
Specifies whether Word should not embed common system fonts.
doNotEmbedSystemFonts?: boolean;
Property Value
boolean
Remarks
encryptionProvider
Specifies the name of the algorithm encryption provider that Microsoft Word uses when encrypting documents.
encryptionProvider?: boolean;
Property Value
boolean
Remarks
farEastLineBreakLanguage
Specifies the East Asian language used for line breaking.
farEastLineBreakLanguage?: boolean;
Property Value
boolean
Remarks
farEastLineBreakLevel
Specifies the line break control level.
farEastLineBreakLevel?: boolean;
Property Value
boolean
Remarks
formattingIsNextLevelShown
Specifies whether Word shows the next heading level when the previous is used.
formattingIsNextLevelShown?: boolean;
Property Value
boolean
Remarks
formattingIsUserStyleNameShown
Specifies whether to show user-defined styles.
formattingIsUserStyleNameShown?: boolean;
Property Value
boolean
Remarks
fullName
Gets the name of a document, including the path.
fullName?: boolean;
Property Value
boolean
Remarks
gridDistanceHorizontal
Specifies the horizontal space between invisible gridlines that Microsoft Word uses when you draw, move, and resize AutoShapes or East Asian characters in the document.
gridDistanceHorizontal?: boolean;
Property Value
boolean
Remarks
gridDistanceVertical
Specifies the vertical space between invisible gridlines that Microsoft Word uses when you draw, move, and resize AutoShapes or East Asian characters in the document.
gridDistanceVertical?: boolean;
Property Value
boolean
Remarks
gridIsOriginFromMargin
Specifies whether the character grid starts from the upper-left corner of the page.
gridIsOriginFromMargin?: boolean;
Property Value
boolean
Remarks
gridOriginHorizontal
Specifies the horizontal origin point for the invisible grid.
gridOriginHorizontal?: boolean;
Property Value
boolean
Remarks
gridOriginVertical
Specifies the vertical origin point for the invisible grid.
gridOriginVertical?: boolean;
Property Value
boolean
Remarks
gridSpaceBetweenHorizontalLines
Specifies the interval for horizontal character gridlines in print layout view.
gridSpaceBetweenHorizontalLines?: boolean;
Property Value
boolean
Remarks
gridSpaceBetweenVerticalLines
Specifies the interval for vertical character gridlines in print layout view.
gridSpaceBetweenVerticalLines?: boolean;
Property Value
boolean
Remarks
hasPassword
Gets whether a password is required to open the document.
hasPassword?: boolean;
Property Value
boolean
Remarks
hasVbProject
Gets whether the document has an attached Microsoft Visual Basic for Applications project.
hasVbProject?: boolean;
Property Value
boolean
Remarks
hyphenateCaps
Specifies whether words in all capital letters can be hyphenated.
hyphenateCaps?: boolean;
Property Value
boolean
Remarks
hyphenationZone
Specifies the width of the hyphenation zone, in points.
hyphenationZone?: boolean;
Property Value
boolean
Remarks
isAutoFormatOverrideOn
Specifies whether automatic formatting options override formatting restrictions.
isAutoFormatOverrideOn?: boolean;
Property Value
boolean
Remarks
isChartDataPointTracked
Specifies whether charts in the active document use cell-reference data-point tracking.
isChartDataPointTracked?: boolean;
Property Value
boolean
Remarks
isCompatible
Specifies whether the compatibility option specified by the type property is enabled.
isCompatible?: boolean;
Property Value
boolean
Remarks
isFinal
Specifies whether the document is final.
isFinal?: boolean;
Property Value
boolean
Remarks
isFontsSubsetSaved
Specifies whether Microsoft Word saves a subset of the embedded TrueType fonts with the document.
isFontsSubsetSaved?: boolean;
Property Value
boolean
Remarks
isFormsDataPrinted
Specifies whether Microsoft Word prints onto a preprinted form only the data entered in the corresponding online form.
isFormsDataPrinted?: boolean;
Property Value
boolean
Remarks
isFormsDataSaved
Specifies whether Microsoft Word saves the data entered in a form as a tab-delimited record for use in a database.
isFormsDataSaved?: boolean;
Property Value
boolean
Remarks
isGrammarChecked
Specifies whether a grammar check has been run on the document.
isGrammarChecked?: boolean;
Property Value
boolean
Remarks
isInAutoSave
Gets whether the most recent firing of the Application.DocumentBeforeSave event was the result of an automatic save by the document or a manual save by the user.
isInAutoSave?: boolean;
Property Value
boolean
Remarks
isInFormsDesign
Gets whether the document is in form design mode.
isInFormsDesign?: boolean;
Property Value
boolean
Remarks
isKerningByAlgorithm
Specifies whether Word kerns half-width Latin characters and punctuation marks.
isKerningByAlgorithm?: boolean;
Property Value
boolean
Remarks
isLinguisticDataEmbedded
Specifies whether to embed speech and handwriting data.
isLinguisticDataEmbedded?: boolean;
Property Value
boolean
Remarks
isMasterDocument
Gets whether this document is a master document.
isMasterDocument?: boolean;
Property Value
boolean
Remarks
isOptimizedForWord97
Specifies whether Word optimizes the document for Word 97.
isOptimizedForWord97?: boolean;
Property Value
boolean
Remarks
isPostScriptPrintedOverText
Specifies whether PRINT field instructions (such as PostScript commands) in the document are to be printed on top of text and graphics when a PostScript printer is used.
isPostScriptPrintedOverText?: boolean;
Property Value
boolean
Remarks
isQuickStyleSetLocked
Specifies whether users can change the Quick Style set.
isQuickStyleSetLocked?: boolean;
Property Value
boolean
Remarks
isReadOnly
Gets whether changes to the document cannot be saved to the original document.
isReadOnly?: boolean;
Property Value
boolean
Remarks
isReadOnlyRecommended
Specifies whether Microsoft Word displays a message box whenever a user opens the document, suggesting that it be opened as read-only.
isReadOnlyRecommended?: boolean;
Property Value
boolean
Remarks
isSnappedToGrid
Specifies whether AutoShapes or East Asian characters are automatically aligned with an invisible grid.
isSnappedToGrid?: boolean;
Property Value
boolean
Remarks
isSnappedToShapes
Specifies whether AutoShapes or East Asian characters align with invisible gridlines through other shapes.
isSnappedToShapes?: boolean;
Property Value
boolean
Remarks
isSpellingChecked
Specifies whether spelling has been checked throughout the document.
isSpellingChecked?: boolean;
Property Value
boolean
Remarks
isStyleEnforced
Specifies whether formatting restrictions are enforced in a protected document.
isStyleEnforced?: boolean;
Property Value
boolean
Remarks
isSubdocument
Gets whether this document is a subdocument of a master document.
isSubdocument?: boolean;
Property Value
boolean
Remarks
isThemeLocked
Specifies whether users can change the document theme.
isThemeLocked?: boolean;
Property Value
boolean
Remarks
isUserControl
Specifies whether the document was created or opened by the user.
isUserControl?: boolean;
Property Value
boolean
Remarks
isVbaSigned
Gets whether the VBA project is digitally signed.
isVbaSigned?: boolean;
Property Value
boolean
Remarks
isWriteReserved
Gets whether the document is protected with a write password.
isWriteReserved?: boolean;
Property Value
boolean
Remarks
justificationMode
Specifies the character spacing adjustment.
justificationMode?: boolean;
Property Value
boolean
Remarks
kind
Specifies the format type that Microsoft Word uses when automatically formatting the document.
kind?: boolean;
Property Value
boolean
Remarks
languageDetected
Specifies whether Microsoft Word has detected the language of the document text.
languageDetected?: boolean;
Property Value
boolean
Remarks
noLineBreakAfter
Specifies the kinsoku characters after which Word will not break a line.
noLineBreakAfter?: boolean;
Property Value
boolean
Remarks
noLineBreakBefore
Specifies the kinsoku characters before which Word will not break a line.
noLineBreakBefore?: boolean;
Property Value
boolean
Remarks
openEncoding
Gets the encoding used to open the document.
openEncoding?: boolean;
Property Value
boolean
Remarks
originalDocumentTitle
Gets the title of the original document after legal-blackline comparison.
originalDocumentTitle?: boolean;
Property Value
boolean
Remarks
pageSetup
Returns a PageSetup object that's associated with the document.
pageSetup?: Word.Interfaces.PageSetupLoadOptions;
Property Value
Remarks
password
Sets a password that must be supplied to open the document.
password?: boolean;
Property Value
boolean
Remarks
passwordEncryptionAlgorithm
Gets the algorithm used for password encryption.
passwordEncryptionAlgorithm?: boolean;
Property Value
boolean
Remarks
passwordEncryptionKeyLength
Gets the key length used for password encryption.
passwordEncryptionKeyLength?: boolean;
Property Value
boolean
Remarks
passwordEncryptionProvider
Gets the name of the password encryption provider.
passwordEncryptionProvider?: boolean;
Property Value
boolean
Remarks
path
Gets the disk or the web path to the document (excludes the document name).
path?: boolean;
Property Value
boolean
Remarks
printRevisions
Specifies whether revision marks are printed with the document.
printRevisions?: boolean;
Property Value
boolean
Remarks
properties
Gets the properties of the document.
properties?: Word.Interfaces.DocumentPropertiesLoadOptions;
Property Value
Remarks
protectionType
Gets the protection type for the document.
protectionType?: boolean;
Property Value
boolean
Remarks
readingLayoutSizeX
Specifies the width of pages in reading layout view when frozen.
readingLayoutSizeX?: boolean;
Property Value
boolean
Remarks
readingLayoutSizeY
Specifies the height of pages in reading layout view when frozen.
readingLayoutSizeY?: boolean;
Property Value
boolean
Remarks
readingModeIsLayoutFrozen
Specifies whether pages in reading layout view are frozen for handwritten markup.
readingModeIsLayoutFrozen?: boolean;
Property Value
boolean
Remarks
removePersonalInformationOnSave
Specifies whether Word removes user information upon saving.
removePersonalInformationOnSave?: boolean;
Property Value
boolean
Remarks
revisedDocumentTitle
Gets the title of the revised document after legal-blackline comparison.
revisedDocumentTitle?: boolean;
Property Value
boolean
Remarks
saved
Indicates whether the changes in the document have been saved. A value of true indicates that the document hasn't changed since it was saved.
saved?: boolean;
Property Value
boolean
Remarks
saveEncoding
Specifies the encoding used when saving the document.
saveEncoding?: boolean;
Property Value
boolean
Remarks
saveFormat
Gets the file format of the document.
saveFormat?: boolean;
Property Value
boolean
Remarks
selection
Returns a Selection object that represents the current selection in the document.
selection?: Word.Interfaces.SelectionLoadOptions;
Property Value
Remarks
textEncoding
Specifies the encoding for saving as encoded text.
textEncoding?: boolean;
Property Value
boolean
Remarks
textLineEnding
Specifies how Word marks line and paragraph breaks in text files.
textLineEnding?: boolean;
Property Value
boolean
Remarks
trackedChangesAreDateAndTimeRemoved
Specifies whether to remove or store date and time metadata for tracked changes.
trackedChangesAreDateAndTimeRemoved?: boolean;
Property Value
boolean
Remarks
trackFormatting
Specifies whether to track formatting changes when change tracking is on.
trackFormatting?: boolean;
Property Value
boolean
Remarks
trackMoves
Specifies whether to mark moved text when Track Changes is on.
trackMoves?: boolean;
Property Value
boolean
Remarks
trackRevisions
Specifies whether changes are tracked in the document.
trackRevisions?: boolean;
Property Value
boolean
Remarks
type
Gets the document type (template or document).
type?: boolean;
Property Value
boolean
Remarks
webSettings
Gets the WebSettings object for webpage-related attributes.
webSettings?: Word.Interfaces.WebSettingsLoadOptions;
Property Value
Remarks
writePassword
Sets a password for saving changes to the document.
writePassword?: boolean;
Property Value
boolean
Remarks
xmlAreAdvancedErrorsShown
Specifies whether error messages are generated from built-in Word messages or MSXML (Microsoft XML).
xmlAreAdvancedErrorsShown?: boolean;
Property Value
boolean
Remarks
xmlIsXsltUsedWhenSaving
Specifies whether to save a document through an Extensible Stylesheet Language Transformation (XSLT).
xmlIsXsltUsedWhenSaving?: boolean;
Property Value
boolean
Remarks
xmlSaveThroughXslt
Specifies the path and file name for the XSLT to apply when saving a document.
xmlSaveThroughXslt?: boolean;
Property Value
boolean