PowerPoint.TableColumnCollection class

Представляет коллекцию столбцов таблицы.

Extends

Комментарии

Набор API: PowerPointApi 1.9

Используется

Свойства

context

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

items

Получает загруженные дочерние элементы в этой коллекции.

Методы

add(index, count)

Добавляет один или несколько столбцов в таблицу.

deleteColumns(columns)

Удаляет указанные столбцы из коллекции.

getCount()

Возвращает количество столбцов в коллекции.

getItemAt(index)

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

load(options)

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

load(propertyNames)

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

load(propertyNamesAndPaths)

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

toJSON()

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

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

context

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

context: RequestContext;

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

items

Получает загруженные дочерние элементы в этой коллекции.

readonly items: PowerPoint.TableColumn[];

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

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

add(index, count)

Добавляет один или несколько столбцов в таблицу.

add(index?: number | null | undefined, count?: number | undefined): void;

Параметры

index

number | null | undefined

Необязательный параметр. Указывает отсчитываемый от нуля индекс, в который добавляются новые столбцы. Существующие столбцы, начиная с расположения индекса, смещаются вправо. Если значение индекса не определено, null, -1 или больше числа столбцов в таблице, новые столбцы добавляются в конце таблицы.

count

number | undefined

Необязательный параметр. Количество добавляемых столбцов. Если значение не определено или равно 0, добавляется только один столбец.

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

void

Комментарии

Набор API: PowerPointApi 1.9

deleteColumns(columns)

Удаляет указанные столбцы из коллекции.

deleteColumns(columns: PowerPoint.TableColumn[]): void;

Параметры

columns

PowerPoint.TableColumn[]

Массив объектов, TableColumn представляющих удаляемые столбцы.

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

void

Комментарии

Набор API: PowerPointApi 1.9

getCount()

Возвращает количество столбцов в коллекции.

getCount(): OfficeExtension.ClientResult<number>;

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

Количество столбцов в коллекции.

Комментарии

Набор API: PowerPointApi 1.9

getItemAt(index)

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

getItemAt(index: number): PowerPoint.TableColumn;

Параметры

index

number

Значение индекса извлекаемого столбца в виде отсчитываемого от нуля индекса.

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

Объект column.

Комментарии

Набор API: PowerPointApi 1.9

load(options)

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

load(options?: PowerPoint.Interfaces.TableColumnCollectionLoadOptions & PowerPoint.Interfaces.CollectionLoadOptions): PowerPoint.TableColumnCollection;

Параметры

options

PowerPoint.Interfaces.TableColumnCollectionLoadOptions & PowerPoint.Interfaces.CollectionLoadOptions

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

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

load(propertyNames)

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

load(propertyNames?: string | string[]): PowerPoint.TableColumnCollection;

Параметры

propertyNames

string | string[]

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

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

load(propertyNamesAndPaths)

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

load(propertyNamesAndPaths?: OfficeExtension.LoadOption): PowerPoint.TableColumnCollection;

Параметры

propertyNamesAndPaths
OfficeExtension.LoadOption

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

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

toJSON()

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

toJSON(): PowerPoint.Interfaces.TableColumnCollectionData;

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