PowerPoint.TableCell class
Representa una tabla.
- Extends
Comentarios
[ Conjunto de API: PowerPointApi 1.8 ]
Ejemplos
// 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();
});
Propiedades
| borders | Obtiene la colección de bordes de la celda de tabla. |
| column |
Obtiene el número de columnas de tabla que abarca esta celda. Será mayor o igual que 1. |
| column |
Obtiene el índice de columna de base cero de la celda dentro de la tabla. |
| context | Contexto de solicitud asociado al objeto . Esto conecta el proceso del complemento al proceso de la aplicación host de Office. |
| fill | Obtiene el color de relleno de la celda de tabla. |
| font | Obtiene la fuente de la celda de tabla. |
| horizontal |
Especifica la alineación horizontal del texto en la celda de la tabla. Devuelve |
| indent |
Especifica el nivel de sangría del texto de la celda de tabla. Devuelve |
| margins | Obtiene el conjunto de márgenes de la celda de tabla. |
| row |
Obtiene el número de filas de tabla que abarca esta celda. Será mayor o igual que 1. |
| row |
Obtiene el índice de fila de base cero de la celda dentro de la tabla. |
| text | Especifica el contenido de texto de la celda de tabla. |
| text |
Especifica el contenido de la celda de tabla como una matriz de objetos PowerPoint.TextRun . Cada |
| vertical |
Especifica la alineación vertical del texto en la celda de la tabla. |
Métodos
| load(options) | Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a |
| load(property |
Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a |
| load(property |
Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a |
| resize(row |
Cambia el tamaño de la celda de tabla para abarcar un número especificado de filas y columnas. Si rowCount o columnCount son mayores que 1, la celda se convertirá en un área combinada. Si la celda ya es un área combinada y rowCount y columnCount se establecen en 1, la celda dejará de ser un área combinada. |
| split(row |
Divide la celda en el número especificado de filas y columnas. |
| toJSON() | Invalida el método JavaScript |
Detalles de las propiedades
borders
Obtiene la colección de bordes de la celda de tabla.
readonly borders: PowerPoint.Borders;
Valor de propiedad
Comentarios
columnCount
Obtiene el número de columnas de tabla que abarca esta celda. Será mayor o igual que 1.
readonly columnCount: number;
Valor de propiedad
number
Comentarios
columnIndex
Obtiene el índice de columna de base cero de la celda dentro de la tabla.
readonly columnIndex: number;
Valor de propiedad
number
Comentarios
context
Contexto de solicitud asociado al objeto . Esto conecta el proceso del complemento al proceso de la aplicación host de Office.
context: RequestContext;
Valor de propiedad
fill
Obtiene el color de relleno de la celda de tabla.
readonly fill: PowerPoint.ShapeFill;
Valor de propiedad
Comentarios
font
Obtiene la fuente de la celda de tabla.
readonly font: PowerPoint.ShapeFont;
Valor de propiedad
Comentarios
horizontalAlignment
Especifica la alineación horizontal del texto en la celda de la tabla. Devuelve null si el texto de la celda contiene alineaciones diferentes.
horizontalAlignment: PowerPoint.ParagraphHorizontalAlignment | "Left" | "Center" | "Right" | "Justify" | "JustifyLow" | "Distributed" | "ThaiDistributed" | null;
Valor de propiedad
PowerPoint.ParagraphHorizontalAlignment | "Left" | "Center" | "Right" | "Justify" | "JustifyLow" | "Distributed" | "ThaiDistributed" | null
Comentarios
indentLevel
Especifica el nivel de sangría del texto de la celda de tabla. Devuelve null si el texto de la celda contiene niveles de sangría diferentes.
indentLevel: number | null;
Valor de propiedad
number | null
Comentarios
margins
Obtiene el conjunto de márgenes de la celda de tabla.
readonly margins: PowerPoint.Margins;
Valor de propiedad
Comentarios
rowCount
Obtiene el número de filas de tabla que abarca esta celda. Será mayor o igual que 1.
readonly rowCount: number;
Valor de propiedad
number
Comentarios
rowIndex
Obtiene el índice de fila de base cero de la celda dentro de la tabla.
readonly rowIndex: number;
Valor de propiedad
number
Comentarios
text
Especifica el contenido de texto de la celda de tabla.
text: string;
Valor de propiedad
string
Comentarios
[ Conjunto de API: PowerPointApi 1.8 ]
Ejemplos
// 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
Especifica el contenido de la celda de tabla como una matriz de objetos PowerPoint.TextRun . Cada TextRun objeto representa una secuencia de uno o varios caracteres que comparten los mismos atributos de fuente.
textRuns: PowerPoint.TextRun[];
Valor de propiedad
Comentarios
verticalAlignment
Especifica la alineación vertical del texto en la celda de la tabla.
verticalAlignment: PowerPoint.TextVerticalAlignment | "Top" | "Middle" | "Bottom" | "TopCentered" | "MiddleCentered" | "BottomCentered";
Valor de propiedad
PowerPoint.TextVerticalAlignment | "Top" | "Middle" | "Bottom" | "TopCentered" | "MiddleCentered" | "BottomCentered"
Comentarios
Detalles del método
load(options)
Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.
load(options?: PowerPoint.Interfaces.TableCellLoadOptions): PowerPoint.TableCell;
Parámetros
Proporciona opciones para las propiedades del objeto que se van a cargar.
Devoluciones
load(propertyNames)
Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.
load(propertyNames?: string | string[]): PowerPoint.TableCell;
Parámetros
- propertyNames
-
string | string[]
Una cadena delimitada por comas o una matriz de cadenas que especifican las propiedades que se van a cargar.
Devoluciones
load(propertyNamesAndPaths)
Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.
load(propertyNamesAndPaths?: {
select?: string;
expand?: string;
}): PowerPoint.TableCell;
Parámetros
- propertyNamesAndPaths
-
{ select?: string; expand?: string; }
propertyNamesAndPaths.select es una cadena delimitada por comas que especifica las propiedades que se van a cargar y propertyNamesAndPaths.expand es una cadena delimitada por comas que especifica las propiedades de navegación que se van a cargar.
Devoluciones
resize(rowCount, columnCount)
Cambia el tamaño de la celda de tabla para abarcar un número especificado de filas y columnas. Si rowCount o columnCount son mayores que 1, la celda se convertirá en un área combinada. Si la celda ya es un área combinada y rowCount y columnCount se establecen en 1, la celda dejará de ser un área combinada.
resize(rowCount: number, columnCount: number): void;
Parámetros
- rowCount
-
number
Número de filas que abarcará la celda. Debe ser mayor que 0.
- columnCount
-
number
Número de columnas que abarcará la celda. Debe ser mayor que 0.
Devoluciones
void
Comentarios
split(rowCount, columnCount)
Divide la celda en el número especificado de filas y columnas.
split(rowCount: number, columnCount: number): void;
Parámetros
- rowCount
-
number
Número de filas en las que se va a dividir. Debe ser mayor que 0.
- columnCount
-
number
Número de columnas en las que se va a dividir. Debe ser mayor que 0.
Devoluciones
void
Comentarios
toJSON()
Invalida el método JavaScript toJSON() para proporcionar una salida más útil cuando se pasa un objeto de API a JSON.stringify(). (JSON.stringifya su vez, llama al toJSON método del objeto que se le pasa). Mientras que el objeto original PowerPoint.TableCell es un objeto de API, el toJSON método devuelve un objeto JavaScript sin formato (escrito como PowerPoint.Interfaces.TableCellData) que contiene copias superficiales de las propiedades secundarias cargadas del objeto original.
toJSON(): PowerPoint.Interfaces.TableCellData;