PowerPoint.TableCell class

Paquete:
powerpoint

Representa una tabla.

Extends
OfficeExtension.ClientObject

Comentarios

Conjunto de API: PowerPointApi 1.8

Usada por

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.
columnCount

Obtiene el número de columnas de la tabla que abarca esta celda. Será mayor o igual que 1.
columnIndex

Obtiene el índice de columna basado en cero de la celda dentro de la tabla.
context

El contexto de solicitud asociado al objeto. De esta forma, se conecta el proceso del complemento con el 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.
horizontalAlignment

Especifica la alineación horizontal del texto en la celda de tabla. Devuelve null si el texto de la celda contiene alineaciones diferentes.
indentLevel

Especifica el nivel de sangría del texto en la celda de tabla. Devuelve null si el texto de la celda contiene diferentes niveles de sangría.
margins

Obtiene el conjunto de márgenes de la celda de tabla.
rowCount

Obtiene el número de filas de tabla que abarca esta celda. Será mayor o igual que 1.
rowIndex

Obtiene el índice de fila basado en cero de la celda dentro de la tabla.
text

Especifica el contenido de texto de la celda de tabla.
textRuns

Especifica el contenido de la celda de la tabla como una matriz de objetos PowerPoint.TextRun . Cada TextRun objeto representa una secuencia de uno o más caracteres que comparten los mismos atributos de fuente.
verticalAlignment

Especifica la alineación vertical del texto en la celda de tabla.

Métodos

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(propertyNames)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.
load(propertyNamesAndPaths)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.
resize(rowCount, columnCount)

Cambia el tamaño de la celda de la tabla de forma que abarque 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 ya no será un área combinada.
split(rowCount, columnCount)

Divide la celda en el número especificado de filas y columnas.
toJSON()

Reemplaza el método JavaScript toJSON() para proporcionar una salida más útil cuando se pasa un objeto API a JSON.stringify(). (JSON.stringify, a su vez, llama al toJSON método del objeto que se le pasa). Mientras que el objeto original PowerPoint.TableCell es un objeto API, el toJSON método devuelve un objeto JavaScript simple (escrito como PowerPoint.Interfaces.TableCellData) que contiene copias superficiales de cualquier propiedad secundaria cargada del objeto original.

Detalles de las propiedades

borders

Obtiene la colección de bordes de la celda de tabla.

readonly borders: PowerPoint.Borders;

Valor de propiedad

PowerPoint.Borders

Comentarios

Conjunto de API: PowerPointApi 1.9

columnCount

Obtiene el número de columnas de la tabla que abarca esta celda. Será mayor o igual que 1.

readonly columnCount: number;

Valor de propiedad

number

Comentarios

Conjunto de API: PowerPointApi 1.8

columnIndex

Obtiene el índice de columna basado en cero de la celda dentro de la tabla.

readonly columnIndex: number;

Valor de propiedad

number

Comentarios

Conjunto de API: PowerPointApi 1.8

context

El contexto de solicitud asociado al objeto. De esta forma, se conecta el proceso del complemento con el proceso de la aplicación host de Office.

context: RequestContext;

Valor de propiedad

PowerPoint.RequestContext

fill

Obtiene el color de relleno de la celda de tabla.

readonly fill: PowerPoint.ShapeFill;

Valor de propiedad

PowerPoint.ShapeFill

Comentarios

Conjunto de API: PowerPointApi 1.9

font

Obtiene la fuente de la celda de tabla.

readonly font: PowerPoint.ShapeFont;

Valor de propiedad

PowerPoint.ShapeFont

Comentarios

Conjunto de API: PowerPointApi 1.9

horizontalAlignment

Especifica la alineación horizontal del texto en la celda de 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

Conjunto de API: PowerPointApi 1.9

indentLevel

Especifica el nivel de sangría del texto en la celda de tabla. Devuelve null si el texto de la celda contiene diferentes niveles de sangría.

indentLevel: number | null;

Valor de propiedad

number | null

Comentarios

Conjunto de API: PowerPointApi 1.9

margins

Obtiene el conjunto de márgenes de la celda de tabla.

readonly margins: PowerPoint.Margins;

Valor de propiedad

PowerPoint.Margins

Comentarios

Conjunto de API: PowerPointApi 1.9

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

Conjunto de API: PowerPointApi 1.8

rowIndex

Obtiene el índice de fila basado en cero de la celda dentro de la tabla.

readonly rowIndex: number;

Valor de propiedad

number

Comentarios

Conjunto de API: PowerPointApi 1.8

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 la tabla como una matriz de objetos PowerPoint.TextRun . Cada TextRun objeto representa una secuencia de uno o más caracteres que comparten los mismos atributos de fuente.

textRuns: PowerPoint.TextRun[];

Valor de propiedad

PowerPoint.TextRun[]

Comentarios

Conjunto de API: PowerPointApi 1.9

verticalAlignment

Especifica la alineación vertical del texto en la celda de tabla.

verticalAlignment: PowerPoint.TextVerticalAlignment | "Top" | "Middle" | "Bottom" | "TopCentered" | "MiddleCentered" | "BottomCentered";

Valor de propiedad

PowerPoint.TextVerticalAlignment | "Top" | "Middle" | "Bottom" | "TopCentered" | "MiddleCentered" | "BottomCentered"

Comentarios

Conjunto de API: PowerPointApi 1.9

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

options
PowerPoint.Interfaces.TableCellLoadOptions

Proporciona opciones para las propiedades del objeto que se van a cargar.

Devoluciones

PowerPoint.TableCell

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

PowerPoint.TableCell

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

PowerPoint.TableCell

resize(rowCount, columnCount)

Cambia el tamaño de la celda de la tabla de forma que abarque 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 ya no será un área combinada.

resize(rowCount: number, columnCount: number): void;

Parámetros

rowCount

number

El número de filas que abarcará la celda. Debe ser mayor que 0.

columnCount

number

El número de columnas que abarcará la celda. Debe ser mayor que 0.

Devoluciones

void

Comentarios

Conjunto de API: PowerPointApi 1.9

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

El número de filas en que se va a dividir. Debe ser mayor que 0.

columnCount

number

El número de columnas en que se dividirá. Debe ser mayor que 0.

Devoluciones

void

Comentarios

Conjunto de API: PowerPointApi 1.9

toJSON()

Reemplaza el método JavaScript toJSON() para proporcionar una salida más útil cuando se pasa un objeto API a JSON.stringify(). (JSON.stringify, a su vez, llama al toJSON método del objeto que se le pasa). Mientras que el objeto original PowerPoint.TableCell es un objeto API, el toJSON método devuelve un objeto JavaScript simple (escrito como PowerPoint.Interfaces.TableCellData) que contiene copias superficiales de cualquier propiedad secundaria cargada del objeto original.

toJSON(): PowerPoint.Interfaces.TableCellData;

Devoluciones

PowerPoint.Interfaces.TableCellData