PowerPoint.TableCell class
Представляет таблицу.
- Extends
Комментарии
Используется
Примеры
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/add-modify-tables.yaml
// Updates a table's values.
await PowerPoint.run(async (context) => {
const shapes = context.presentation.getSelectedSlides().getItemAt(0).shapes;
// Add a table (which is a type of Shape).
const shape = shapes.addTable(4, 3);
let table = shape.getTable();
table.load();
await context.sync();
// Update values in the table.
for (let rowIndex = 0; rowIndex < table.rowCount; rowIndex++) {
for (let columnIndex = 0; columnIndex < table.columnCount; columnIndex++) {
const cell = table.getCellOrNullObject(rowIndex, columnIndex);
cell.text = generateRandomString();
}
}
await context.sync();
});
Свойства
| borders | Возвращает коллекцию границ для ячейки таблицы. |
| column |
Возвращает количество столбцов таблицы, по которые охватывает ячейка. Значение больше или равно 1. |
| column |
Возвращает отсчитываемый от нуля индекс столбца ячейки в таблице. |
| context | Контекст запроса, связанный с объектом . Это соединяет процесс надстройки с процессом ведущего приложения Office. |
| fill | Возвращает цвет заливки ячейки таблицы. |
| font | Возвращает шрифт ячейки таблицы. |
| horizontal |
Задает горизонтальное выравнивание текста в ячейке таблицы. Возвращает значение |
| indent |
Задает уровень отступа текста в ячейке таблицы. Возвращает значение |
| margins | Возвращает набор полей в ячейке таблицы. |
| row |
Возвращает количество строк таблицы, в которых эта ячейка охватывает. Значение больше или равно 1. |
| row |
Возвращает отсчитываемый от нуля индекс строки ячейки в таблице. |
| text | Задает текстовое содержимое ячейки таблицы. |
| text |
Задает содержимое ячейки таблицы в виде массива объектов PowerPoint.TextRun . Каждый |
| vertical |
Задает вертикальное выравнивание текста в ячейке таблицы. |
Методы
| load(options) | Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод |
| load(property |
Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод |
| load(property |
Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод |
| resize(row |
Изменяет размер ячейки таблицы, чтобы она охватывала указанное количество строк и столбцов. Если rowCount или columnCount больше 1, ячейка станет объединенной областью. Если ячейка уже является объединенной областью, а rowCount и columnCount имеют значение 1, ячейка больше не будет объединенной областью. |
| split(row |
Разбивает ячейку на указанное количество строк и столбцов. |
| toJSON() | Переопределяет метод JavaScript |
Сведения о свойстве
borders
Возвращает коллекцию границ для ячейки таблицы.
readonly borders: PowerPoint.Borders;Значение свойства
Комментарии
columnCount
Возвращает количество столбцов таблицы, по которые охватывает ячейка. Значение больше или равно 1.
readonly columnCount: number;Значение свойства
number
Комментарии
columnIndex
Возвращает отсчитываемый от нуля индекс столбца ячейки в таблице.
readonly columnIndex: number;Значение свойства
number
Комментарии
context
Контекст запроса, связанный с объектом . Это соединяет процесс надстройки с процессом ведущего приложения Office.
context: RequestContext;Значение свойства
fill
Возвращает цвет заливки ячейки таблицы.
readonly fill: PowerPoint.ShapeFill;Значение свойства
Комментарии
font
Возвращает шрифт ячейки таблицы.
readonly font: PowerPoint.ShapeFont;Значение свойства
Комментарии
horizontalAlignment
Задает горизонтальное выравнивание текста в ячейке таблицы. Возвращает значение null , если текст ячейки содержит различные выравнивания.
horizontalAlignment: PowerPoint.ParagraphHorizontalAlignment | "Left" | "Center" | "Right" | "Justify" | "JustifyLow" | "Distributed" | "ThaiDistributed" | null;Значение свойства
PowerPoint.ParagraphHorizontalAlignment | "Left" | "Center" | "Right" | "Justify" | "JustifyLow" | "Distributed" | "ThaiDistributed" | null
Комментарии
indentLevel
Задает уровень отступа текста в ячейке таблицы. Возвращает значение null , если текст ячейки содержит разные уровни отступа.
indentLevel: number | null;Значение свойства
number | null
Комментарии
margins
Возвращает набор полей в ячейке таблицы.
readonly margins: PowerPoint.Margins;Значение свойства
Комментарии
rowCount
Возвращает количество строк таблицы, в которых эта ячейка охватывает. Значение больше или равно 1.
readonly rowCount: number;Значение свойства
number
Комментарии
rowIndex
Возвращает отсчитываемый от нуля индекс строки ячейки в таблице.
readonly rowIndex: number;Значение свойства
number
Комментарии
text
Задает текстовое содержимое ячейки таблицы.
text: string;Значение свойства
string
Комментарии
Примеры
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/add-modify-tables.yaml
// Updates a table's values.
await PowerPoint.run(async (context) => {
const shapes = context.presentation.getSelectedSlides().getItemAt(0).shapes;
// Add a table (which is a type of Shape).
const shape = shapes.addTable(4, 3);
let table = shape.getTable();
table.load();
await context.sync();
// Update values in the table.
for (let rowIndex = 0; rowIndex < table.rowCount; rowIndex++) {
for (let columnIndex = 0; columnIndex < table.columnCount; columnIndex++) {
const cell = table.getCellOrNullObject(rowIndex, columnIndex);
cell.text = generateRandomString();
}
}
await context.sync();
});
textRuns
Задает содержимое ячейки таблицы в виде массива объектов PowerPoint.TextRun . Каждый TextRun объект представляет последовательность из одного или нескольких символов, которые используют одни и те же атрибуты шрифта.
textRuns: PowerPoint.TextRun[];Значение свойства
Комментарии
verticalAlignment
Задает вертикальное выравнивание текста в ячейке таблицы.
verticalAlignment: PowerPoint.TextVerticalAlignment | "Top" | "Middle" | "Bottom" | "TopCentered" | "MiddleCentered" | "BottomCentered";Значение свойства
PowerPoint.TextVerticalAlignment | "Top" | "Middle" | "Bottom" | "TopCentered" | "MiddleCentered" | "BottomCentered"
Комментарии
Сведения о методе
load(options)
Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().
load(options?: PowerPoint.Interfaces.TableCellLoadOptions): PowerPoint.TableCell;Параметры
Предоставляет параметры свойств объекта для загрузки.
Возвращаемое значение
load(propertyNames)
Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().
load(propertyNames?: string | string[]): PowerPoint.TableCell;Параметры
- propertyNames
-
string | string[]
Строка с разделителями-запятыми или массив строк, указывающих свойства для загрузки.
Возвращаемое значение
load(propertyNamesAndPaths)
Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().
load(propertyNamesAndPaths?: {
select?: string;
expand?: string;
}): PowerPoint.TableCell;Параметры
- propertyNamesAndPaths
-
{ select?: string; expand?: string; }
propertyNamesAndPaths.select — это строка с разделителями-запятыми, указывающая загружаемые свойства, и propertyNamesAndPaths.expand строка с разделителями-запятыми, указывающая загружаемые свойства навигации.
Возвращаемое значение
resize(rowCount, columnCount)
Изменяет размер ячейки таблицы, чтобы она охватывала указанное количество строк и столбцов. Если rowCount или columnCount больше 1, ячейка станет объединенной областью. Если ячейка уже является объединенной областью, а rowCount и columnCount имеют значение 1, ячейка больше не будет объединенной областью.
resize(rowCount: number, columnCount: number): void;Параметры
- rowCount
-
number
Количество строк, в которых будет охватывать ячейка. Должно быть больше 0.
- columnCount
-
number
Количество столбцов, по которые будет охватывать ячейка. Должно быть больше 0.
Возвращаемое значение
void
Комментарии
split(rowCount, columnCount)
Разбивает ячейку на указанное количество строк и столбцов.
split(rowCount: number, columnCount: number): void;Параметры
- rowCount
-
number
Количество строк для разделения. Должно быть больше 0.
- columnCount
-
number
Количество столбцов для разделения. Должно быть больше 0.
Возвращаемое значение
void
Комментарии
toJSON()
Переопределяет метод JavaScript toJSON() , чтобы обеспечить более полезные выходные данные при передаче объекта API в JSON.stringify(). (JSON.stringifyв свою очередь вызывает toJSON метод переданного ему объекта.) В то время как исходный PowerPoint.TableCell объект является объектом API, toJSON метод возвращает обычный объект JavaScript (типизированный как PowerPoint.Interfaces.TableCellData), который содержит неглубокие копии всех загруженных дочерних свойств из исходного объекта.
toJSON(): PowerPoint.Interfaces.TableCellData;