word package

Classes

Word.Application

Represents the application object.

Word.Body

Represents the body of a document or a section.

Word.ContentControl

Represents a content control. Content controls are bounded and potentially labeled regions in a document that serve as containers for specific types of content. Individual content controls may contain contents such as images, tables, or paragraphs of formatted text. Currently, only rich text, plain text, and checkbox content controls are supported.

Word.ContentControlCollection

Contains a collection of Word.ContentControl objects. Content controls are bounded and potentially labeled regions in a document that serve as containers for specific types of content. Individual content controls may contain contents such as images, tables, or paragraphs of formatted text. Currently, only rich text and plain text content controls are supported.

Word.CustomProperty

Represents a custom property.

Word.CustomPropertyCollection

Contains the collection of Word.CustomProperty objects.

Word.Document

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.

Word.DocumentCreated

The DocumentCreated object is the top level object created by Application.CreateDocument. A DocumentCreated object is a special Document object.

Word.DocumentProperties

Represents document properties.

Word.Font

Represents a font.

Word.InlinePicture

Represents an inline picture.

Word.InlinePictureCollection

Contains a collection of Word.InlinePicture objects.

Word.List

Contains a collection of Word.Paragraph objects.

Word.ListCollection

Contains a collection of Word.List objects.

Word.ListItem

Represents the paragraph list item format.

Word.Paragraph

Represents a single paragraph in a selection, range, content control, or document body.

Word.ParagraphCollection

Contains a collection of Word.Paragraph objects.

Word.Range

Represents a contiguous area in a document.

Word.RangeCollection

Contains a collection of Word.Range objects.

Word.RequestContext

The RequestContext object facilitates requests to the Word application. Since the Office add-in and the Word application run in two different processes, the request context is required to get access to the Word object model from the add-in.

Word.SearchOptions

Specifies the options to be included in a search operation. To learn more about how to use search options in the Word JavaScript APIs, read Use search options to find text in your Word add-in.

Word.Section

Represents a section in a Word document.

Word.SectionCollection

Contains the collection of the document's Word.Section objects.

Word.Style

Represents a style in a Word document.

Word.Table

Represents a table in a Word document.

Word.TableBorder

Specifies the border style.

Word.TableCell

Represents a table cell in a Word document.

Word.TableCellCollection

Contains the collection of the document's TableCell objects.

Word.TableCollection

Contains the collection of the document's Table objects.

Word.TableRow

Represents a row in a Word document.

Word.TableRowCollection

Contains the collection of the document's TableRow objects.

Interfaces

Word.Interfaces.AnnotationCollectionData

An interface describing the data returned by calling annotationCollection.toJSON().

Word.Interfaces.AnnotationCollectionUpdateData

An interface for updating data on the AnnotationCollection object, for use in annotationCollection.set({ ... }).

Word.Interfaces.AnnotationData

An interface describing the data returned by calling annotation.toJSON().

Word.Interfaces.BodyData

An interface describing the data returned by calling body.toJSON().

Word.Interfaces.BodyLoadOptions

Represents the body of a document or a section.

Word.Interfaces.BodyUpdateData

An interface for updating data on the Body object, for use in body.set({ ... }).

Word.Interfaces.BorderCollectionData

An interface describing the data returned by calling borderCollection.toJSON().

Word.Interfaces.BorderCollectionUpdateData

An interface for updating data on the BorderCollection object, for use in borderCollection.set({ ... }).

Word.Interfaces.BorderData

An interface describing the data returned by calling border.toJSON().

Word.Interfaces.BorderUpdateData

An interface for updating data on the Border object, for use in border.set({ ... }).

Word.Interfaces.CheckboxContentControlData

An interface describing the data returned by calling checkboxContentControl.toJSON().

Word.Interfaces.CheckboxContentControlUpdateData

An interface for updating data on the CheckboxContentControl object, for use in checkboxContentControl.set({ ... }).

Word.Interfaces.CollectionLoadOptions

Provides ways to load properties of only a subset of members of a collection.

Word.Interfaces.ComboBoxContentControlData

An interface describing the data returned by calling comboBoxContentControl.toJSON().

Word.Interfaces.CommentCollectionData

An interface describing the data returned by calling commentCollection.toJSON().

Word.Interfaces.CommentCollectionUpdateData

An interface for updating data on the CommentCollection object, for use in commentCollection.set({ ... }).

Word.Interfaces.CommentContentRangeData

An interface describing the data returned by calling commentContentRange.toJSON().

Word.Interfaces.CommentContentRangeUpdateData

An interface for updating data on the CommentContentRange object, for use in commentContentRange.set({ ... }).

Word.Interfaces.CommentData

An interface describing the data returned by calling comment.toJSON().

Word.Interfaces.CommentReplyCollectionData

An interface describing the data returned by calling commentReplyCollection.toJSON().

Word.Interfaces.CommentReplyCollectionUpdateData

An interface for updating data on the CommentReplyCollection object, for use in commentReplyCollection.set({ ... }).

Word.Interfaces.CommentReplyData

An interface describing the data returned by calling commentReply.toJSON().

Word.Interfaces.CommentReplyUpdateData

An interface for updating data on the CommentReply object, for use in commentReply.set({ ... }).

Word.Interfaces.CommentUpdateData

An interface for updating data on the Comment object, for use in comment.set({ ... }).

Word.Interfaces.ContentControlCollectionData

An interface describing the data returned by calling contentControlCollection.toJSON().

Word.Interfaces.ContentControlCollectionLoadOptions

Contains a collection of Word.ContentControl objects. Content controls are bounded and potentially labeled regions in a document that serve as containers for specific types of content. Individual content controls may contain contents such as images, tables, or paragraphs of formatted text. Currently, only rich text and plain text content controls are supported.

Word.Interfaces.ContentControlCollectionUpdateData

An interface for updating data on the ContentControlCollection object, for use in contentControlCollection.set({ ... }).

Word.Interfaces.ContentControlData

An interface describing the data returned by calling contentControl.toJSON().

Word.Interfaces.ContentControlListItemCollectionData

An interface describing the data returned by calling contentControlListItemCollection.toJSON().

Word.Interfaces.ContentControlListItemCollectionUpdateData

An interface for updating data on the ContentControlListItemCollection object, for use in contentControlListItemCollection.set({ ... }).

Word.Interfaces.ContentControlListItemData

An interface describing the data returned by calling contentControlListItem.toJSON().

Word.Interfaces.ContentControlListItemUpdateData

An interface for updating data on the ContentControlListItem object, for use in contentControlListItem.set({ ... }).

Word.Interfaces.ContentControlLoadOptions

Represents a content control. Content controls are bounded and potentially labeled regions in a document that serve as containers for specific types of content. Individual content controls may contain contents such as images, tables, or paragraphs of formatted text. Currently, only rich text, plain text, and checkbox content controls are supported.

Word.Interfaces.ContentControlUpdateData

An interface for updating data on the ContentControl object, for use in contentControl.set({ ... }).

Word.Interfaces.CritiqueAnnotationData

An interface describing the data returned by calling critiqueAnnotation.toJSON().

Word.Interfaces.CustomPropertyCollectionData

An interface describing the data returned by calling customPropertyCollection.toJSON().

Word.Interfaces.CustomPropertyCollectionLoadOptions

Contains the collection of Word.CustomProperty objects.

Word.Interfaces.CustomPropertyCollectionUpdateData

An interface for updating data on the CustomPropertyCollection object, for use in customPropertyCollection.set({ ... }).

Word.Interfaces.CustomPropertyData

An interface describing the data returned by calling customProperty.toJSON().

Word.Interfaces.CustomPropertyLoadOptions

Represents a custom property.

Word.Interfaces.CustomPropertyUpdateData

An interface for updating data on the CustomProperty object, for use in customProperty.set({ ... }).

Word.Interfaces.CustomXmlPartCollectionData

An interface describing the data returned by calling customXmlPartCollection.toJSON().

Word.Interfaces.CustomXmlPartCollectionUpdateData

An interface for updating data on the CustomXmlPartCollection object, for use in customXmlPartCollection.set({ ... }).

Word.Interfaces.CustomXmlPartData

An interface describing the data returned by calling customXmlPart.toJSON().

Word.Interfaces.CustomXmlPartScopedCollectionData

An interface describing the data returned by calling customXmlPartScopedCollection.toJSON().

Word.Interfaces.CustomXmlPartScopedCollectionUpdateData

An interface for updating data on the CustomXmlPartScopedCollection object, for use in customXmlPartScopedCollection.set({ ... }).

Word.Interfaces.DocumentCreatedData

An interface describing the data returned by calling documentCreated.toJSON().

Word.Interfaces.DocumentCreatedLoadOptions

The DocumentCreated object is the top level object created by Application.CreateDocument. A DocumentCreated object is a special Document object.

Word.Interfaces.DocumentCreatedUpdateData

An interface for updating data on the DocumentCreated object, for use in documentCreated.set({ ... }).

Word.Interfaces.DocumentData

An interface describing the data returned by calling document.toJSON().

Word.Interfaces.DocumentLoadOptions

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.

Word.Interfaces.DocumentPropertiesData

An interface describing the data returned by calling documentProperties.toJSON().

Word.Interfaces.DocumentPropertiesLoadOptions

Represents document properties.

Word.Interfaces.DocumentPropertiesUpdateData

An interface for updating data on the DocumentProperties object, for use in documentProperties.set({ ... }).

Word.Interfaces.DocumentUpdateData

An interface for updating data on the Document object, for use in document.set({ ... }).

Word.Interfaces.DropDownListContentControlData

An interface describing the data returned by calling dropDownListContentControl.toJSON().

Word.Interfaces.FieldCollectionData

An interface describing the data returned by calling fieldCollection.toJSON().

Word.Interfaces.FieldCollectionUpdateData

An interface for updating data on the FieldCollection object, for use in fieldCollection.set({ ... }).

Word.Interfaces.FieldData

An interface describing the data returned by calling field.toJSON().

Word.Interfaces.FieldUpdateData

An interface for updating data on the Field object, for use in field.set({ ... }).

Word.Interfaces.FontData

An interface describing the data returned by calling font.toJSON().

Word.Interfaces.FontLoadOptions

Represents a font.

Word.Interfaces.FontUpdateData

An interface for updating data on the Font object, for use in font.set({ ... }).

Word.Interfaces.InlinePictureCollectionData

An interface describing the data returned by calling inlinePictureCollection.toJSON().

Word.Interfaces.InlinePictureCollectionLoadOptions

Contains a collection of Word.InlinePicture objects.

Word.Interfaces.InlinePictureCollectionUpdateData

An interface for updating data on the InlinePictureCollection object, for use in inlinePictureCollection.set({ ... }).

Word.Interfaces.InlinePictureData

An interface describing the data returned by calling inlinePicture.toJSON().

Word.Interfaces.InlinePictureLoadOptions

Represents an inline picture.

Word.Interfaces.InlinePictureUpdateData

An interface for updating data on the InlinePicture object, for use in inlinePicture.set({ ... }).

Word.Interfaces.ListCollectionData

An interface describing the data returned by calling listCollection.toJSON().

Word.Interfaces.ListCollectionLoadOptions

Contains a collection of Word.List objects.

Word.Interfaces.ListCollectionUpdateData

An interface for updating data on the ListCollection object, for use in listCollection.set({ ... }).

Word.Interfaces.ListData

An interface describing the data returned by calling list.toJSON().

Word.Interfaces.ListItemData

An interface describing the data returned by calling listItem.toJSON().

Word.Interfaces.ListItemLoadOptions

Represents the paragraph list item format.

Word.Interfaces.ListItemUpdateData

An interface for updating data on the ListItem object, for use in listItem.set({ ... }).

Word.Interfaces.ListLevelCollectionData

An interface describing the data returned by calling listLevelCollection.toJSON().

Word.Interfaces.ListLevelCollectionUpdateData

An interface for updating data on the ListLevelCollection object, for use in listLevelCollection.set({ ... }).

Word.Interfaces.ListLevelData

An interface describing the data returned by calling listLevel.toJSON().

Word.Interfaces.ListLevelUpdateData

An interface for updating data on the ListLevel object, for use in listLevel.set({ ... }).

Word.Interfaces.ListLoadOptions

Contains a collection of Word.Paragraph objects.

Word.Interfaces.ListTemplateData

An interface describing the data returned by calling listTemplate.toJSON().

Word.Interfaces.ListTemplateUpdateData

An interface for updating data on the ListTemplate object, for use in listTemplate.set({ ... }).

Word.Interfaces.NoteItemCollectionData

An interface describing the data returned by calling noteItemCollection.toJSON().

Word.Interfaces.NoteItemCollectionUpdateData

An interface for updating data on the NoteItemCollection object, for use in noteItemCollection.set({ ... }).

Word.Interfaces.NoteItemData

An interface describing the data returned by calling noteItem.toJSON().

Word.Interfaces.NoteItemUpdateData

An interface for updating data on the NoteItem object, for use in noteItem.set({ ... }).

Word.Interfaces.ParagraphCollectionData

An interface describing the data returned by calling paragraphCollection.toJSON().

Word.Interfaces.ParagraphCollectionLoadOptions

Contains a collection of Word.Paragraph objects.

Word.Interfaces.ParagraphCollectionUpdateData

An interface for updating data on the ParagraphCollection object, for use in paragraphCollection.set({ ... }).

Word.Interfaces.ParagraphData

An interface describing the data returned by calling paragraph.toJSON().

Word.Interfaces.ParagraphFormatData

An interface describing the data returned by calling paragraphFormat.toJSON().

Word.Interfaces.ParagraphFormatUpdateData

An interface for updating data on the ParagraphFormat object, for use in paragraphFormat.set({ ... }).

Word.Interfaces.ParagraphLoadOptions

Represents a single paragraph in a selection, range, content control, or document body.

Word.Interfaces.ParagraphUpdateData

An interface for updating data on the Paragraph object, for use in paragraph.set({ ... }).

Word.Interfaces.RangeCollectionData

An interface describing the data returned by calling rangeCollection.toJSON().

Word.Interfaces.RangeCollectionLoadOptions

Contains a collection of Word.Range objects.

Word.Interfaces.RangeCollectionUpdateData

An interface for updating data on the RangeCollection object, for use in rangeCollection.set({ ... }).

Word.Interfaces.RangeData

An interface describing the data returned by calling range.toJSON().

Word.Interfaces.RangeLoadOptions

Represents a contiguous area in a document.

Word.Interfaces.RangeUpdateData

An interface for updating data on the Range object, for use in range.set({ ... }).

Word.Interfaces.SearchOptionsData

An interface describing the data returned by calling searchOptions.toJSON().

Word.Interfaces.SearchOptionsLoadOptions

Specifies the options to be included in a search operation. To learn more about how to use search options in the Word JavaScript APIs, read Use search options to find text in your Word add-in.

Word.Interfaces.SearchOptionsUpdateData

An interface for updating data on the SearchOptions object, for use in searchOptions.set({ ... }).

Word.Interfaces.SectionCollectionData

An interface describing the data returned by calling sectionCollection.toJSON().

Word.Interfaces.SectionCollectionLoadOptions

Contains the collection of the document's Word.Section objects.

Word.Interfaces.SectionCollectionUpdateData

An interface for updating data on the SectionCollection object, for use in sectionCollection.set({ ... }).

Word.Interfaces.SectionData

An interface describing the data returned by calling section.toJSON().

Word.Interfaces.SectionLoadOptions

Represents a section in a Word document.

Word.Interfaces.SectionUpdateData

An interface for updating data on the Section object, for use in section.set({ ... }).

Word.Interfaces.SettingCollectionData

An interface describing the data returned by calling settingCollection.toJSON().

Word.Interfaces.SettingCollectionUpdateData

An interface for updating data on the SettingCollection object, for use in settingCollection.set({ ... }).

Word.Interfaces.SettingData

An interface describing the data returned by calling setting.toJSON().

Word.Interfaces.SettingUpdateData

An interface for updating data on the Setting object, for use in setting.set({ ... }).

Word.Interfaces.ShadingData

An interface describing the data returned by calling shading.toJSON().

Word.Interfaces.ShadingUpdateData

An interface for updating data on the Shading object, for use in shading.set({ ... }).

Word.Interfaces.StyleCollectionData

An interface describing the data returned by calling styleCollection.toJSON().

Word.Interfaces.StyleCollectionUpdateData

An interface for updating data on the StyleCollection object, for use in styleCollection.set({ ... }).

Word.Interfaces.StyleData

An interface describing the data returned by calling style.toJSON().

Word.Interfaces.StyleLoadOptions

Represents a style in a Word document.

Word.Interfaces.StyleUpdateData

An interface for updating data on the Style object, for use in style.set({ ... }).

Word.Interfaces.TableBorderData

An interface describing the data returned by calling tableBorder.toJSON().

Word.Interfaces.TableBorderLoadOptions

Specifies the border style.

Word.Interfaces.TableBorderUpdateData

An interface for updating data on the TableBorder object, for use in tableBorder.set({ ... }).

Word.Interfaces.TableCellCollectionData

An interface describing the data returned by calling tableCellCollection.toJSON().

Word.Interfaces.TableCellCollectionLoadOptions

Contains the collection of the document's TableCell objects.

Word.Interfaces.TableCellCollectionUpdateData

An interface for updating data on the TableCellCollection object, for use in tableCellCollection.set({ ... }).

Word.Interfaces.TableCellData

An interface describing the data returned by calling tableCell.toJSON().

Word.Interfaces.TableCellLoadOptions

Represents a table cell in a Word document.

Word.Interfaces.TableCellUpdateData

An interface for updating data on the TableCell object, for use in tableCell.set({ ... }).

Word.Interfaces.TableCollectionData

An interface describing the data returned by calling tableCollection.toJSON().

Word.Interfaces.TableCollectionLoadOptions

Contains the collection of the document's Table objects.

Word.Interfaces.TableCollectionUpdateData

An interface for updating data on the TableCollection object, for use in tableCollection.set({ ... }).

Word.Interfaces.TableData

An interface describing the data returned by calling table.toJSON().

Word.Interfaces.TableLoadOptions

Represents a table in a Word document.

Word.Interfaces.TableRowCollectionData

An interface describing the data returned by calling tableRowCollection.toJSON().

Word.Interfaces.TableRowCollectionLoadOptions

Contains the collection of the document's TableRow objects.

Word.Interfaces.TableRowCollectionUpdateData

An interface for updating data on the TableRowCollection object, for use in tableRowCollection.set({ ... }).

Word.Interfaces.TableRowData

An interface describing the data returned by calling tableRow.toJSON().

Word.Interfaces.TableRowLoadOptions

Represents a row in a Word document.

Word.Interfaces.TableRowUpdateData

An interface for updating data on the TableRow object, for use in tableRow.set({ ... }).

Word.Interfaces.TableStyleData

An interface describing the data returned by calling tableStyle.toJSON().

Word.Interfaces.TableStyleUpdateData

An interface for updating data on the TableStyle object, for use in tableStyle.set({ ... }).

Word.Interfaces.TableUpdateData

An interface for updating data on the Table object, for use in table.set({ ... }).

Word.Interfaces.TrackedChangeCollectionData

An interface describing the data returned by calling trackedChangeCollection.toJSON().

Word.Interfaces.TrackedChangeCollectionUpdateData

An interface for updating data on the TrackedChangeCollection object, for use in trackedChangeCollection.set({ ... }).

Word.Interfaces.TrackedChangeData

An interface describing the data returned by calling trackedChange.toJSON().

Enums

Word.Alignment
Word.BodyType
Word.BorderLocation
Word.BorderType
Word.BreakType

Specifies the form of a break.

Word.BuiltInStyleName

Represents the built-in style in a Word document.

Word.CellPaddingLocation
Word.ContentControlAppearance

ContentControl appearance.

Word.ContentControlType

Specifies supported content control types and subtypes.

Word.DocumentPropertyType
Word.ErrorCodes
Word.HeaderFooterType
Word.InsertLocation

The insertion location types.

Word.ListBullet
Word.ListLevelType
Word.ListNumbering
Word.LocationRelation
Word.RangeLocation
Word.SaveBehavior

Specifies the save behavior for Document.save.

Word.SelectionMode

This enum sets where the cursor (insertion point) in the document is after a selection.

Word.UnderlineType

The supported styles for underline format.

Word.VerticalAlignment

Functions

Word.run(objects, batch)

Executes a batch script that performs actions on the Word object model, using the RequestContext of previously created API objects.

Word.run(object, batch)

Executes a batch script that performs actions on the Word object model, using the RequestContext of a previously created API object. When the promise is resolved, any tracked objects that were automatically allocated during execution will be released.

Word.run(batch)

Executes a batch script that performs actions on the Word object model, using a new RequestContext. When the promise is resolved, any tracked objects that were automatically allocated during execution will be released.

Function Details

Word.run(objects, batch)

Executes a batch script that performs actions on the Word object model, using the RequestContext of previously created API objects.

export function run<T>(objects: OfficeExtension.ClientObject[], batch: (context: Word.RequestContext) => Promise<T>): Promise<T>;

Parameters

objects

OfficeExtension.ClientObject[]

An array of previously created API objects. The array will be validated to make sure that all of the objects share the same context. The batch will use this shared RequestContext, which means that any changes applied to these objects will be picked up by context.sync().

batch

(context: Word.RequestContext) => Promise<T>

A function that takes in a RequestContext and returns a promise (typically, just the result of context.sync()). The context parameter facilitates requests to the Word application. Since the Office add-in and the Word application run in two different processes, the RequestContext is required to get access to the Word object model from the add-in.

Returns

Promise<T>

Word.run(object, batch)

Executes a batch script that performs actions on the Word object model, using the RequestContext of a previously created API object. When the promise is resolved, any tracked objects that were automatically allocated during execution will be released.

export function run<T>(object: OfficeExtension.ClientObject, batch: (context: Word.RequestContext) => Promise<T>): Promise<T>;

Parameters

object
OfficeExtension.ClientObject

A previously created API object. The batch will use the same RequestContext as the passed-in object, which means that any changes applied to the object will be picked up by context.sync().

batch

(context: Word.RequestContext) => Promise<T>

A function that takes in a RequestContext and returns a promise (typically, just the result of context.sync()). The context parameter facilitates requests to the Word application. Since the Office add-in and the Word application run in two different processes, the RequestContext is required to get access to the Word object model from the add-in.

Returns

Promise<T>

Word.run(batch)

Executes a batch script that performs actions on the Word object model, using a new RequestContext. When the promise is resolved, any tracked objects that were automatically allocated during execution will be released.

export function run<T>(batch: (context: Word.RequestContext) => Promise<T>): Promise<T>;

Parameters

batch

(context: Word.RequestContext) => Promise<T>

A function that takes in a RequestContext and returns a promise (typically, just the result of context.sync()). The context parameter facilitates requests to the Word application. Since the Office add-in and the Word application run in two different processes, the RequestContext is required to get access to the Word object model from the add-in.

Returns

Promise<T>