Edit

Share via


Word.Interfaces.FrameCollectionLoadOptions interface

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.

Represents the collection of Word.Frame objects.

Remarks

[ API set: WordApi BETA (PREVIEW ONLY) ]

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

height

For EACH ITEM in the collection: Specifies the height (in points) of the frame.

heightRule

For EACH ITEM in the collection: Specifies a FrameSizeRule value that represents the rule for determining the height of the frame.

horizontalDistanceFromText

For EACH ITEM in the collection: Specifies the horizontal distance between the frame and the surrounding text, in points.

horizontalPosition

For EACH ITEM in the collection: Specifies the horizontal distance between the edge of the frame and the item specified by the relativeHorizontalPosition property.

lockAnchor

For EACH ITEM in the collection: Specifies if the frame is locked.

range

For EACH ITEM in the collection: Returns a Range object that represents the portion of the document that's contained within the frame.

relativeHorizontalPosition

For EACH ITEM in the collection: Specifies the relative horizontal position of the frame.

relativeVerticalPosition

For EACH ITEM in the collection: Specifies the relative vertical position of the frame.

shading

For EACH ITEM in the collection: Returns a ShadingUniversal object that refers to the shading formatting for the frame.

textWrap

For EACH ITEM in the collection: Specifies if document text wraps around the frame.

verticalDistanceFromText

For EACH ITEM in the collection: Specifies the vertical distance (in points) between the frame and the surrounding text.

verticalPosition

For EACH ITEM in the collection: Specifies the vertical distance between the edge of the frame and the item specified by the relativeVerticalPosition property.

width

For EACH ITEM in the collection: Specifies the width (in points) of the frame.

widthRule

For EACH ITEM in the collection: Specifies the rule used to determine the width of the frame.

Property Details

$all

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.

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

height

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: Specifies the height (in points) of the frame.

height?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi BETA (PREVIEW ONLY) ]

heightRule

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: Specifies a FrameSizeRule value that represents the rule for determining the height of the frame.

heightRule?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi BETA (PREVIEW ONLY) ]

horizontalDistanceFromText

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: Specifies the horizontal distance between the frame and the surrounding text, in points.

horizontalDistanceFromText?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi BETA (PREVIEW ONLY) ]

horizontalPosition

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: Specifies the horizontal distance between the edge of the frame and the item specified by the relativeHorizontalPosition property.

horizontalPosition?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi BETA (PREVIEW ONLY) ]

lockAnchor

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: Specifies if the frame is locked.

lockAnchor?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi BETA (PREVIEW ONLY) ]

range

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: Returns a Range object that represents the portion of the document that's contained within the frame.

range?: Word.Interfaces.RangeLoadOptions;

Property Value

Remarks

[ API set: WordApi BETA (PREVIEW ONLY) ]

relativeHorizontalPosition

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: Specifies the relative horizontal position of the frame.

relativeHorizontalPosition?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi BETA (PREVIEW ONLY) ]

relativeVerticalPosition

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: Specifies the relative vertical position of the frame.

relativeVerticalPosition?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi BETA (PREVIEW ONLY) ]

shading

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: Returns a ShadingUniversal object that refers to the shading formatting for the frame.

shading?: Word.Interfaces.ShadingUniversalLoadOptions;

Property Value

Remarks

[ API set: WordApi BETA (PREVIEW ONLY) ]

textWrap

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: Specifies if document text wraps around the frame.

textWrap?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi BETA (PREVIEW ONLY) ]

verticalDistanceFromText

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: Specifies the vertical distance (in points) between the frame and the surrounding text.

verticalDistanceFromText?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi BETA (PREVIEW ONLY) ]

verticalPosition

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: Specifies the vertical distance between the edge of the frame and the item specified by the relativeVerticalPosition property.

verticalPosition?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi BETA (PREVIEW ONLY) ]

width

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: Specifies the width (in points) of the frame.

width?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi BETA (PREVIEW ONLY) ]

widthRule

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: Specifies the rule used to determine the width of the frame.

widthRule?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi BETA (PREVIEW ONLY) ]