PowerPoint.Table class
Represents a table.
- Extends
Remarks
[ API set: PowerPointApi 1.8 ]
Examples
// 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();
});
Properties
| column |
Gets the number of columns in the table. |
| context | The request context associated with the object. This connects the add-in's process to the Office host application's process. |
| row |
Gets the number of rows in the table. |
| values | Gets all of the values in the table. |
Methods
| get |
Gets the cell at the specified |
| get |
Gets a collection of cells that represent the merged areas of the table. |
| get |
Gets the shape object for the table. |
| load(options) | Queues up a command to load the specified properties of the object. You must call |
| load(property |
Queues up a command to load the specified properties of the object. You must call |
| load(property |
Queues up a command to load the specified properties of the object. You must call |
| toJSON() | Overrides the JavaScript |
Property Details
columnCount
Gets the number of columns in the table.
readonly columnCount: number;Property Value
number
Remarks
context
The request context associated with the object. This connects the add-in's process to the Office host application's process.
context: RequestContext;Property Value
rowCount
Gets the number of rows in the table.
readonly rowCount: number;Property Value
number
Remarks
values
Gets all of the values in the table.
readonly values: string[][];Property Value
string[][]
Remarks
Method Details
getCellOrNullObject(rowIndex, columnIndex)
Gets the cell at the specified rowIndex and columnIndex.
getCellOrNullObject(rowIndex: number, columnIndex: number): PowerPoint.TableCell;Parameters
- rowIndex
-
number
The zero-based row index of the cell.
- columnIndex
-
number
The zero-based column index of the cell.
Returns
The cell at the specified row and column. If the cell is part of a merged area and not the top left cell of the merged area, an object with the isNullObject property set to true is returned. For further information, see *OrNullObject methods and properties.
Remarks
[ API set: PowerPointApi 1.8 ]
Examples
// 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();
});
getMergedAreas()
Gets a collection of cells that represent the merged areas of the table.
getMergedAreas(): PowerPoint.TableCellCollection;Returns
a TableCellCollection with cells that represent the merged areas of the table.
Remarks
getShape()
Gets the shape object for the table.
getShape(): PowerPoint.Shape;Returns
Remarks
load(options)
Queues up a command to load the specified properties of the object. You must call context.sync() before reading the properties.
load(options?: PowerPoint.Interfaces.TableLoadOptions): PowerPoint.Table;Parameters
Provides options for which properties of the object to load.
Returns
load(propertyNames)
Queues up a command to load the specified properties of the object. You must call context.sync() before reading the properties.
load(propertyNames?: string | string[]): PowerPoint.Table;Parameters
- propertyNames
-
string | string[]
A comma-delimited string or an array of strings that specify the properties to load.
Returns
load(propertyNamesAndPaths)
Queues up a command to load the specified properties of the object. You must call context.sync() before reading the properties.
load(propertyNamesAndPaths?: {
select?: string;
expand?: string;
}): PowerPoint.Table;Parameters
- propertyNamesAndPaths
-
{ select?: string; expand?: string; }
propertyNamesAndPaths.select is a comma-delimited string that specifies the properties to load, and propertyNamesAndPaths.expand is a comma-delimited string that specifies the navigation properties to load.
Returns
toJSON()
Overrides the JavaScript toJSON() method in order to provide more useful output when an API object is passed to JSON.stringify(). (JSON.stringify, in turn, calls the toJSON method of the object that's passed to it.) Whereas the original PowerPoint.Table object is an API object, the toJSON method returns a plain JavaScript object (typed as PowerPoint.Interfaces.TableData) that contains shallow copies of any loaded child properties from the original object.
toJSON(): PowerPoint.Interfaces.TableData;