Excel.Table interface

Представляет таблицу Excel. Чтобы узнать больше об объектной модели таблиц, прочтите работу с таблицами с помощью API JavaScript для Excel.

Свойства

autoFilter

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

columns

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

highlightFirstColumn

Указывает, содержит ли первый столбец специальное форматирование.

highlightLastColumn

Указывает, содержит ли последний столбец специальное форматирование.

id

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

legacyId

Возвращает числовой идентификатор.

name

Имя таблицы.

Имя набора таблицы должно соответствовать рекомендациям, указанным в статье Переименование статьи таблицы Excel .

rows

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

showBandedColumns

Указывает, будут ли в столбцах отображаться чередующиеся форматирование, в котором четные столбцы выделяются не так, как в четном, чтобы упростить чтение таблицы.

showBandedRows

Указывает, будут ли в строках отображаться полосные форматирования, в результате которой нечетные строки выделяются не так, как в четном, чтобы облегчить чтение таблицы.

showFilterButton

Указывает, отображаются ли кнопки фильтра в верхней части каждого заголовка столбца. Это свойство можно использовать, только если таблица содержит строку заголовков.

showHeaders

Указывает, отображается ли строка заголовков. Можно задать это значение, чтобы отобразить или скрыть строку заголовков.

showTotals

Указывает, отображается ли строка итогов. Можно задать это значение, чтобы отобразить или скрыть строку итогов.

sort

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

style

Постоянное значение, представляющее стиль таблицы. Возможные значения: "TableStyleLight1", "TableStyleLight21", "TableStyleMedium1", "TableStyleMedium28", "TableStyleDark1" и "TableStyleDark11". Также можно указать настраиваемый пользовательский стиль, имеющийся в книге.

worksheet

Лист, содержащий текущую таблицу.

Методы

clearFilters()

Удаляет все фильтры, примененные к таблице.

convertToRange()

Преобразовывает таблицу в обычный диапазон ячеек. Все данные сохраняются.

delete()

Удаляет таблицу.

getDataBodyRange()

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

getHeaderRowRange()

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

getRange()

Получает объект диапазона, связанный со всей таблицей.

getTotalRowRange()

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

load(propertyNames)

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

reapplyFilters()

Повторно применяет все текущие фильтры к таблице.

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

autoFilter

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

readonly autoFilter: AutoFilter;

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

columns

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

readonly columns: TableColumnCollection;

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

highlightFirstColumn

Указывает, содержит ли первый столбец специальное форматирование.

highlightFirstColumn: boolean;

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

boolean

highlightLastColumn

Указывает, содержит ли последний столбец специальное форматирование.

highlightLastColumn: boolean;

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

boolean

id

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

readonly id: string;

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

string

legacyId

Возвращает числовой идентификатор.

readonly legacyId: string;

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

string

name

Имя таблицы.

Имя набора таблицы должно соответствовать рекомендациям, указанным в статье Переименование статьи таблицы Excel .

name: string;

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

string

rows

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

readonly rows: TableRowCollection;

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

showBandedColumns

Указывает, будут ли в столбцах отображаться чередующиеся форматирование, в котором четные столбцы выделяются не так, как в четном, чтобы упростить чтение таблицы.

showBandedColumns: boolean;

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

boolean

showBandedRows

Указывает, будут ли в строках отображаться полосные форматирования, в результате которой нечетные строки выделяются не так, как в четном, чтобы облегчить чтение таблицы.

showBandedRows: boolean;

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

boolean

showFilterButton

Указывает, отображаются ли кнопки фильтра в верхней части каждого заголовка столбца. Это свойство можно использовать, только если таблица содержит строку заголовков.

showFilterButton: boolean;

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

boolean

showHeaders

Указывает, отображается ли строка заголовков. Можно задать это значение, чтобы отобразить или скрыть строку заголовков.

showHeaders: boolean;

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

boolean

showTotals

Указывает, отображается ли строка итогов. Можно задать это значение, чтобы отобразить или скрыть строку итогов.

showTotals: boolean;

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

boolean

sort

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

readonly sort: TableSort;

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

Примеры

// Get the current worksheet.
let workbook = context.workbook;
let worksheets = workbook.worksheets;
let selectedSheet = worksheets.getActiveWorksheet();

// Create a table with the used cells.
let usedRange = selectedSheet.getUsedRange();
let newTable = selectedSheet.tables.add(usedRange, true);

// Sort the table using the first column.
newTable.sort.apply([{ key: 0, ascending: true }]);

style

Постоянное значение, представляющее стиль таблицы. Возможные значения: "TableStyleLight1", "TableStyleLight21", "TableStyleMedium1", "TableStyleMedium28", "TableStyleDark1" и "TableStyleDark11". Также можно указать настраиваемый пользовательский стиль, имеющийся в книге.

style: string;

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

string

worksheet

Лист, содержащий текущую таблицу.

readonly worksheet: Worksheet;

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

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

clearFilters()

Удаляет все фильтры, примененные к таблице.

clearFilters(): void;

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

void

convertToRange()

Преобразовывает таблицу в обычный диапазон ячеек. Все данные сохраняются.

convertToRange(): Range;

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

delete()

Удаляет таблицу.

delete(): void;

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

void

getDataBodyRange()

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

getDataBodyRange(): Range;

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

getHeaderRowRange()

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

getHeaderRowRange(): Range;

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

getRange()

Получает объект диапазона, связанный со всей таблицей.

getRange(): Range;

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

getTotalRowRange()

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

getTotalRowRange(): Range;

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

load(propertyNames)

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

load(propertyNames?: string | string[]): void;

Параметры

propertyNames
string | string[]

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

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

void

reapplyFilters()

Повторно применяет все текущие фильтры к таблице.

reapplyFilters(): void;

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

void