Word.Frame class

Представляет кадр. Объект Frame является членом Word. Объект FrameCollection.

Extends

Свойства

borders

BorderUniversalCollection Возвращает объект , представляющий все границы кадра.

context

Контекст запроса, связанный с объектом . Это соединяет процесс надстройки с процессом ведущего приложения Office.

height

Задает высоту (в точках) кадра.

heightRule

Задает FrameSizeRule значение, представляющее правило для определения высоты кадра.

horizontalDistanceFromText

Задает горизонтальное расстояние между рамкой и окружающим текстом в точках.

horizontalPosition

Задает горизонтальное расстояние между краем кадра и элементом, заданным свойством relativeHorizontalPosition .

lockAnchor

Указывает, заблокирован ли кадр.

range

Range Возвращает объект , представляющий часть документа, содержащуюся в кадре.

relativeHorizontalPosition

Задает относительное горизонтальное положение кадра.

relativeVerticalPosition

Задает относительное вертикальное положение кадра.

shading

ShadingUniversal Возвращает объект , который ссылается на форматирование затенения для кадра.

textWrap

Указывает, будет ли текст документа обтекать рамку.

verticalDistanceFromText

Задает вертикальное расстояние (в точках) между рамкой и окружающим текстом.

verticalPosition

Задает вертикальное расстояние между краем кадра и элементом, заданным свойством relativeVerticalPosition .

width

Задает ширину (в точках) кадра.

widthRule

Задает правило, используемое для определения ширины кадра.

Методы

copy()

Копирует кадр в буфер обмена.

cut()

Удаляет кадр из документа и помещает его в буфер обмена.

delete()

Удаляет кадр.

load(options)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

load(propertyNames)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

load(propertyNamesAndPaths)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

select()

Выбирает кадр.

set(properties, options)

Задает несколько свойств объекта одновременно. Можно передать обычный объект с соответствующими свойствами или другой объект API того же типа.

set(properties)

Задает несколько свойств объекта одновременно на основе существующего загруженного объекта.

toJSON()

Переопределяет метод JavaScript toJSON() , чтобы обеспечить более полезные выходные данные при передаче объекта API в JSON.stringify(). (JSON.stringifyв свою очередь вызывает toJSON метод переданного ему объекта.) В то время как исходный Word.Frame объект является объектом API, toJSON метод возвращает обычный объект JavaScript (типизированный как Word.Interfaces.FrameData), который содержит неглубокие копии всех загруженных дочерних свойств из исходного объекта.

track()

Отслеживает объект для автоматической корректировки с учетом окружающих изменений в документе. Этот вызов является сокращением для context.trackedObjects.add(thisObject). Если вы используете этот объект в вызовах .sync и вне последовательного выполнения пакета .run и получаете ошибку InvalidObjectPath при задании свойства или вызове метода для объекта, необходимо добавить объект в отслеживаемую коллекцию объектов при первом создании объекта. Если этот объект является частью коллекции, следует также отслеживать родительскую коллекцию.

untrack()

Освобождает память, связанную с этим объектом, если он ранее отслеживался. Этот вызов является сокращенным для context.trackedObjects.remove(thisObject). Наличие большого количества отслеживаемых объектов замедляет ведущее приложение, поэтому не забывайте освобождать любые добавленные объекты после завершения их использования. Вызов потребуется выполнить context.sync() до того, как выпуск памяти вступит в силу.

Сведения о свойстве

borders

BorderUniversalCollection Возвращает объект , представляющий все границы кадра.

readonly borders: Word.BorderUniversalCollection;

Значение свойства

Комментарии

Набор API: WordApiDesktop 1.3

context

Контекст запроса, связанный с объектом . Это соединяет процесс надстройки с процессом ведущего приложения Office.

context: RequestContext;

Значение свойства

height

Задает высоту (в точках) кадра.

height: number;

Значение свойства

number

Комментарии

Набор API: WordApiDesktop 1.3

heightRule

Задает FrameSizeRule значение, представляющее правило для определения высоты кадра.

heightRule: Word.FrameSizeRule | "Auto" | "AtLeast" | "Exact";

Значение свойства

Word.FrameSizeRule | "Auto" | "AtLeast" | "Exact"

Комментарии

Набор API: WordApiDesktop 1.3

horizontalDistanceFromText

Задает горизонтальное расстояние между рамкой и окружающим текстом в точках.

horizontalDistanceFromText: number;

Значение свойства

number

Комментарии

Набор API: WordApiDesktop 1.3

horizontalPosition

Задает горизонтальное расстояние между краем кадра и элементом, заданным свойством relativeHorizontalPosition .

horizontalPosition: number;

Значение свойства

number

Комментарии

Набор API: WordApiDesktop 1.3

lockAnchor

Указывает, заблокирован ли кадр.

lockAnchor: boolean;

Значение свойства

boolean

Комментарии

Набор API: WordApiDesktop 1.3

range

Range Возвращает объект , представляющий часть документа, содержащуюся в кадре.

readonly range: Word.Range;

Значение свойства

Комментарии

Набор API: WordApiDesktop 1.3

relativeHorizontalPosition

Задает относительное горизонтальное положение кадра.

relativeHorizontalPosition: Word.RelativeHorizontalPosition | "Margin" | "Page" | "Column" | "Character" | "LeftMargin" | "RightMargin" | "InsideMargin" | "OutsideMargin";

Значение свойства

Word.RelativeHorizontalPosition | "Margin" | "Page" | "Column" | "Character" | "LeftMargin" | "RightMargin" | "InsideMargin" | "OutsideMargin"

Комментарии

Набор API: WordApiDesktop 1.3

relativeVerticalPosition

Задает относительное вертикальное положение кадра.

relativeVerticalPosition: Word.RelativeVerticalPosition | "Margin" | "Page" | "Paragraph" | "Line" | "TopMargin" | "BottomMargin" | "InsideMargin" | "OutsideMargin";

Значение свойства

Word.RelativeVerticalPosition | "Margin" | "Page" | "Paragraph" | "Line" | "TopMargin" | "BottomMargin" | "InsideMargin" | "OutsideMargin"

Комментарии

Набор API: WordApiDesktop 1.3

shading

ShadingUniversal Возвращает объект , который ссылается на форматирование затенения для кадра.

readonly shading: Word.ShadingUniversal;

Значение свойства

Комментарии

Набор API: WordApiDesktop 1.3

textWrap

Указывает, будет ли текст документа обтекать рамку.

textWrap: boolean;

Значение свойства

boolean

Комментарии

Набор API: WordApiDesktop 1.3

verticalDistanceFromText

Задает вертикальное расстояние (в точках) между рамкой и окружающим текстом.

verticalDistanceFromText: number;

Значение свойства

number

Комментарии

Набор API: WordApiDesktop 1.3

verticalPosition

Задает вертикальное расстояние между краем кадра и элементом, заданным свойством relativeVerticalPosition .

verticalPosition: number;

Значение свойства

number

Комментарии

Набор API: WordApiDesktop 1.3

width

Задает ширину (в точках) кадра.

width: number;

Значение свойства

number

Комментарии

Набор API: WordApiDesktop 1.3

widthRule

Задает правило, используемое для определения ширины кадра.

widthRule: Word.FrameSizeRule | "Auto" | "AtLeast" | "Exact";

Значение свойства

Word.FrameSizeRule | "Auto" | "AtLeast" | "Exact"

Комментарии

Набор API: WordApiDesktop 1.3

Сведения о методе

copy()

Копирует кадр в буфер обмена.

copy(): void;

Возвращаемое значение

void

Комментарии

Набор API: WordApiDesktop 1.3

cut()

Удаляет кадр из документа и помещает его в буфер обмена.

cut(): void;

Возвращаемое значение

void

Комментарии

Набор API: WordApiDesktop 1.3

delete()

Удаляет кадр.

delete(): void;

Возвращаемое значение

void

Комментарии

Набор API: WordApiDesktop 1.3

load(options)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

load(options?: Word.Interfaces.FrameLoadOptions): Word.Frame;

Параметры

options
Word.Interfaces.FrameLoadOptions

Предоставляет параметры свойств объекта для загрузки.

Возвращаемое значение

load(propertyNames)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

load(propertyNames?: string | string[]): Word.Frame;

Параметры

propertyNames

string | string[]

Строка с разделителями-запятыми или массив строк, указывающих свойства для загрузки.

Возвращаемое значение

load(propertyNamesAndPaths)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Word.Frame;

Параметры

propertyNamesAndPaths

{ select?: string; expand?: string; }

propertyNamesAndPaths.select — это строка с разделителями-запятыми, указывающая загружаемые свойства, и propertyNamesAndPaths.expand строка с разделителями-запятыми, указывающая загружаемые свойства навигации.

Возвращаемое значение

select()

Выбирает кадр.

select(): void;

Возвращаемое значение

void

Комментарии

Набор API: WordApiDesktop 1.3

set(properties, options)

Задает несколько свойств объекта одновременно. Можно передать обычный объект с соответствующими свойствами или другой объект API того же типа.

set(properties: Interfaces.FrameUpdateData, options?: OfficeExtension.UpdateOptions): void;

Параметры

properties
Word.Interfaces.FrameUpdateData

Объект JavaScript со свойствами, структурированными изоморфно по свойствам объекта, для которого вызывается метод .

options
OfficeExtension.UpdateOptions

Предоставляет возможность подавления ошибок, если объект свойств пытается задать какие-либо свойства, доступные только для чтения.

Возвращаемое значение

void

set(properties)

Задает несколько свойств объекта одновременно на основе существующего загруженного объекта.

set(properties: Word.Frame): void;

Параметры

properties
Word.Frame

Возвращаемое значение

void

toJSON()

Переопределяет метод JavaScript toJSON() , чтобы обеспечить более полезные выходные данные при передаче объекта API в JSON.stringify(). (JSON.stringifyв свою очередь вызывает toJSON метод переданного ему объекта.) В то время как исходный Word.Frame объект является объектом API, toJSON метод возвращает обычный объект JavaScript (типизированный как Word.Interfaces.FrameData), который содержит неглубокие копии всех загруженных дочерних свойств из исходного объекта.

toJSON(): Word.Interfaces.FrameData;

Возвращаемое значение

track()

Отслеживает объект для автоматической корректировки с учетом окружающих изменений в документе. Этот вызов является сокращением для context.trackedObjects.add(thisObject). Если вы используете этот объект в вызовах .sync и вне последовательного выполнения пакета .run и получаете ошибку InvalidObjectPath при задании свойства или вызове метода для объекта, необходимо добавить объект в отслеживаемую коллекцию объектов при первом создании объекта. Если этот объект является частью коллекции, следует также отслеживать родительскую коллекцию.

track(): Word.Frame;

Возвращаемое значение

untrack()

Освобождает память, связанную с этим объектом, если он ранее отслеживался. Этот вызов является сокращенным для context.trackedObjects.remove(thisObject). Наличие большого количества отслеживаемых объектов замедляет ведущее приложение, поэтому не забывайте освобождать любые добавленные объекты после завершения их использования. Вызов потребуется выполнить context.sync() до того, как выпуск памяти вступит в силу.

untrack(): Word.Frame;

Возвращаемое значение