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;