PowerPoint.TableCell class

Obtém a coleção de limites para a célula da tabela.

readonly borders: PowerPoint.Borders;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO) ]

Obtém o número de colunas de tabela que esta célula abrange. Será maior ou igual a 1.

readonly columnCount: number;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi 1.8 ]

Obtém o índice de colunas baseado em zero da célula na tabela.

readonly columnIndex: number;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi 1.8 ]

O contexto do pedido associado ao objeto . Esta ação liga o processo do suplemento ao processo da aplicação anfitriã do Office.

context: RequestContext;

Valor da propriedade

Obtém a cor de preenchimento da célula da tabela.

readonly fill: PowerPoint.ShapeFill;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO) ]

Obtém o tipo de letra da célula da tabela.

readonly font: PowerPoint.ShapeFont;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO) ]

Especifica o alinhamento horizontal do texto na célula da tabela. Devolve null se o texto da célula contiver alinhamentos diferentes.

horizontalAlignment: PowerPoint.ParagraphHorizontalAlignment | "Left" | "Center" | "Right" | "Justify" | "JustifyLow" | "Distributed" | "ThaiDistributed" | null;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO) ]

Especifica o nível de avanço do texto na célula da tabela. Devolve null se o texto da célula contiver níveis de avanço diferentes.

indentLevel: number | null;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO) ]

Obtém o conjunto de margens na célula da tabela.

readonly margins: PowerPoint.Margins;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO) ]

Obtém o número de linhas de tabela que esta célula abrange. Será maior ou igual a 1.

readonly rowCount: number;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi 1.8 ]

Obtém o índice de linhas baseado em zero da célula na tabela.

readonly rowIndex: number;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi 1.8 ]

Especifica o conteúdo de texto da célula da tabela.

text: string;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi 1.8 ]

Exemplos

// 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();
});

Especifica o conteúdo da célula da tabela como uma matriz de objetos. Cada TextRun objeto representa uma sequência de um ou mais carateres que partilham os mesmos atributos de tipo de letra.

textRuns: PowerPoint.TextRun[];

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO) ]

Especifica o alinhamento vertical do texto na célula da tabela.

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

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO) ]

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(options?: PowerPoint.Interfaces.TableCellLoadOptions): PowerPoint.TableCell;

Parâmetros

Retornos

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(propertyNames?: string | string[]): PowerPoint.TableCell;

Parâmetros

Retornos

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): PowerPoint.TableCell;

Parâmetros

Retornos

Redimensiona a célula da tabela para abranger um número especificado de linhas e colunas. Se rowCount ou columnCount forem superiores a 1, a célula tornar-se-á numa área unida. Se a célula já for uma área unida e rowCount e columnCount estiverem definidas como 1, a célula deixará de ser uma área unida.

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

Parâmetros

Retornos

Comentários

[ Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO) ]

Divide a célula no número especificado de linhas e colunas.

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

Parâmetros

Retornos

Comentários

[ Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO) ]

Substitui o método JavaScript toJSON() para fornecer uma saída mais útil quando um objeto de API é transmitido para JSON.stringify(). (JSON.stringifypor sua vez, chama o toJSON método do objeto que lhe é transmitido.) Enquanto o objeto original PowerPoint.TableCell é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como PowerPoint.Interfaces.TableCellData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.

toJSON(): PowerPoint.Interfaces.TableCellData;

Retornos