Edit

Share via


Word.Interfaces.StyleCollectionLoadOptions interface

Contains a collection of Word.Style objects.

Remarks

[ API set: WordApi 1.5 ]

Properties

$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).

automaticallyUpdate

For EACH ITEM in the collection: Specifies whether the style is automatically redefined based on the selection.

baseStyle

For EACH ITEM in the collection: Specifies the name of an existing style to use as the base formatting of another style.

borders

For EACH ITEM in the collection: Specifies a BorderCollection object that represents all the borders for the specified style.

builtIn

For EACH ITEM in the collection: Gets whether the specified style is a built-in style.

description

For EACH ITEM in the collection: Gets the description of the specified style.

font

For EACH ITEM in the collection: Gets a font object that represents the character formatting of the specified style.

frame

For EACH ITEM in the collection: Returns a Frame object that represents the frame formatting for the style.

hasProofing

For EACH ITEM in the collection: Specifies whether the spelling and grammar checker ignores text formatted with this style.

inUse

For EACH ITEM in the collection: Gets whether the specified style is a built-in style that has been modified or applied in the document or a new style that has been created in the document.

languageId

For EACH ITEM in the collection: Specifies a LanguageId value that represents the language for the style.

languageIdFarEast

For EACH ITEM in the collection: Specifies an East Asian language for the style.

linked

For EACH ITEM in the collection: Gets whether a style is a linked style that can be used for both paragraph and character formatting.

linkStyle

For EACH ITEM in the collection: Specifies a link between a paragraph and a character style.

listLevelNumber

For EACH ITEM in the collection: Returns the list level for the style.

listTemplate

For EACH ITEM in the collection: Gets a ListTemplate object that represents the list formatting for the specified Style object.

locked

For EACH ITEM in the collection: Specifies whether the style cannot be changed or edited.

nameLocal

For EACH ITEM in the collection: Gets the name of a style in the language of the user.

nextParagraphStyle

For EACH ITEM in the collection: Specifies the name of the style to be applied automatically to a new paragraph that is inserted after a paragraph formatted with the specified style.

noSpaceBetweenParagraphsOfSameStyle

For EACH ITEM in the collection: Specifies whether to remove spacing between paragraphs that are formatted using the same style.

paragraphFormat

For EACH ITEM in the collection: Gets a ParagraphFormat object that represents the paragraph settings for the specified style.

priority

For EACH ITEM in the collection: Specifies the priority.

quickStyle

For EACH ITEM in the collection: Specifies whether the style corresponds to an available quick style.

shading

For EACH ITEM in the collection: Gets a Shading object that represents the shading for the specified style. Not applicable to List style.

tableStyle

For EACH ITEM in the collection: Gets a TableStyle object representing Style properties that can be applied to a table.

type

For EACH ITEM in the collection: Gets the style type.

unhideWhenUsed

For EACH ITEM in the collection: Specifies whether the specified style is made visible as a recommended style in the Styles and in the Styles task pane in Microsoft Word after it's used in the document.

visibility

For EACH ITEM in the collection: Specifies whether the specified style is visible as a recommended style in the Styles gallery and in the Styles task pane.

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

automaticallyUpdate

For EACH ITEM in the collection: Specifies whether the style is automatically redefined based on the selection.

automaticallyUpdate?: boolean;

Property Value

boolean

Remarks

[ API set: WordApiDesktop 1.3 ]

baseStyle

For EACH ITEM in the collection: Specifies the name of an existing style to use as the base formatting of another style.

baseStyle?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.5 ]

Note: The ability to set baseStyle was introduced in WordApi 1.6.

borders

For EACH ITEM in the collection: Specifies a BorderCollection object that represents all the borders for the specified style.

borders?: Word.Interfaces.BorderCollectionLoadOptions;

Property Value

Remarks

[ API set: WordApiDesktop 1.1 ]

builtIn

For EACH ITEM in the collection: Gets whether the specified style is a built-in style.

builtIn?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.5 ]

description

Note

This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.

For EACH ITEM in the collection: Gets the description of the specified style.

description?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi BETA (PREVIEW ONLY) ]

font

For EACH ITEM in the collection: Gets a font object that represents the character formatting of the specified style.

font?: Word.Interfaces.FontLoadOptions;

Property Value

Remarks

[ API set: WordApi 1.5 ]

frame

For EACH ITEM in the collection: Returns a Frame object that represents the frame formatting for the style.

frame?: Word.Interfaces.FrameLoadOptions;

Property Value

Remarks

[ API set: WordApiDesktop 1.3 ]

hasProofing

For EACH ITEM in the collection: Specifies whether the spelling and grammar checker ignores text formatted with this style.

hasProofing?: boolean;

Property Value

boolean

Remarks

[ API set: WordApiDesktop 1.3 ]

inUse

For EACH ITEM in the collection: Gets whether the specified style is a built-in style that has been modified or applied in the document or a new style that has been created in the document.

inUse?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.5 ]

languageId

For EACH ITEM in the collection: Specifies a LanguageId value that represents the language for the style.

languageId?: boolean;

Property Value

boolean

Remarks

[ API set: WordApiDesktop 1.3 ]

languageIdFarEast

For EACH ITEM in the collection: Specifies an East Asian language for the style.

languageIdFarEast?: boolean;

Property Value

boolean

Remarks

[ API set: WordApiDesktop 1.3 ]

linked

For EACH ITEM in the collection: Gets whether a style is a linked style that can be used for both paragraph and character formatting.

linked?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.5 ]

linkStyle

For EACH ITEM in the collection: Specifies a link between a paragraph and a character style.

linkStyle?: Word.Interfaces.StyleLoadOptions;

Property Value

Remarks

[ API set: WordApiDesktop 1.3 ]

listLevelNumber

For EACH ITEM in the collection: Returns the list level for the style.

listLevelNumber?: boolean;

Property Value

boolean

Remarks

[ API set: WordApiDesktop 1.3 ]

listTemplate

For EACH ITEM in the collection: Gets a ListTemplate object that represents the list formatting for the specified Style object.

listTemplate?: Word.Interfaces.ListTemplateLoadOptions;

Property Value

Remarks

[ API set: WordApiDesktop 1.1 ]

locked

For EACH ITEM in the collection: Specifies whether the style cannot be changed or edited.

locked?: boolean;

Property Value

boolean

Remarks

[ API set: WordApiDesktop 1.3 ]

nameLocal

For EACH ITEM in the collection: Gets the name of a style in the language of the user.

nameLocal?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.5 ]

nextParagraphStyle

For EACH ITEM in the collection: Specifies the name of the style to be applied automatically to a new paragraph that is inserted after a paragraph formatted with the specified style.

nextParagraphStyle?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.5 ]

Note: The ability to set nextParagraphStyle was introduced in WordApi 1.6.

noSpaceBetweenParagraphsOfSameStyle

For EACH ITEM in the collection: Specifies whether to remove spacing between paragraphs that are formatted using the same style.

noSpaceBetweenParagraphsOfSameStyle?: boolean;

Property Value

boolean

Remarks

[ API set: WordApiDesktop 1.3 ]

paragraphFormat

For EACH ITEM in the collection: Gets a ParagraphFormat object that represents the paragraph settings for the specified style.

paragraphFormat?: Word.Interfaces.ParagraphFormatLoadOptions;

Property Value

Remarks

[ API set: WordApi 1.5 ]

priority

For EACH ITEM in the collection: Specifies the priority.

priority?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.5 ]

quickStyle

For EACH ITEM in the collection: Specifies whether the style corresponds to an available quick style.

quickStyle?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.5 ]

shading

For EACH ITEM in the collection: Gets a Shading object that represents the shading for the specified style. Not applicable to List style.

shading?: Word.Interfaces.ShadingLoadOptions;

Property Value

Remarks

[ API set: WordApi 1.6 ]

tableStyle

For EACH ITEM in the collection: Gets a TableStyle object representing Style properties that can be applied to a table.

tableStyle?: Word.Interfaces.TableStyleLoadOptions;

Property Value

Remarks

[ API set: WordApi 1.6 ]

type

For EACH ITEM in the collection: Gets the style type.

type?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.5 ]

unhideWhenUsed

For EACH ITEM in the collection: Specifies whether the specified style is made visible as a recommended style in the Styles and in the Styles task pane in Microsoft Word after it's used in the document.

unhideWhenUsed?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.5 ]

visibility

For EACH ITEM in the collection: Specifies whether the specified style is visible as a recommended style in the Styles gallery and in the Styles task pane.

visibility?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.5 ]