Compartilhar via


Word.Table class

Representa uma tabela num documento Word.

Extends

Comentários

[ Conjunto de API: WordApi 1.3 ]

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/table-cell-access.yaml

await Word.run(async (context) => {
  // Use a two-dimensional array to hold the initial table values.
  const data = [
    ["Tokyo", "Beijing", "Seattle"],
    ["Apple", "Orange", "Pineapple"]
  ];
  const table: Word.Table = context.document.body.insertTable(2, 3, "Start", data);
  table.styleBuiltIn = Word.BuiltInStyleName.gridTable5Dark_Accent2;
  table.styleFirstColumn = false;

  await context.sync();
});

Propriedades

alignment

Especifica o alinhamento da tabela em relação à coluna de página. O valor pode ser "Esquerda", "Centrado" ou "Direita".

context

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

endnotes

Obtém a coleção de notas de fim na tabela.

fields

Obtém a coleção de objetos de campo na tabela.

font

Obtém a fonte. Use isto para obter e definir o nome, o tamanho e a cor da fonte, além de outras propriedades.

footnotes

Obtém a coleção de notas de rodapé na tabela.

headerRowCount

Especifica o número de linhas de cabeçalho.

horizontalAlignment

Especifica o alinhamento horizontal de cada célula na tabela. O valor pode ser "Esquerda", "Centrado", "À Direita" ou "Justificado".

isUniform

Indica se todas as linhas de tabela são uniformes.

nestingLevel

Obtém o nível de aninhamento da tabela. Tabelas de nível superior têm o nível 1.

parentBody

Obtém o corpo pai da tabela.

parentContentControl

Obtém o controle de conteúdo que contém a tabela. Gera um ItemNotFound erro se não existir um controlo de conteúdo principal.

parentContentControlOrNullObject

Obtém o controle de conteúdo que contém a tabela. Se não existir um controlo de conteúdo principal, este método devolverá um objeto com a respetiva isNullObject propriedade definida como true. Para obter mais informações, veja *OrNullObject methods and properties (Métodos e propriedades do OrNullObject).

parentTable

Obtém a tabela que contém esta tabela. Gera um ItemNotFound erro se não estiver contido numa tabela.

parentTableCell

Obtém a célula de tabela que contém esta tabela. Gera um ItemNotFound erro se não estiver contido numa célula de tabela.

parentTableCellOrNullObject

Obtém a célula de tabela que contém esta tabela. Se não estiver contido numa célula de tabela, este método devolverá um objeto com a respetiva isNullObject propriedade definida como true. Para obter mais informações, veja *OrNullObject methods and properties (Métodos e propriedades do OrNullObject).

parentTableOrNullObject

Obtém a tabela que contém esta tabela. Se não estiver contido numa tabela, este método devolverá um objeto com a respetiva isNullObject propriedade definida como true. Para obter mais informações, veja *OrNullObject methods and properties (Métodos e propriedades do OrNullObject).

rowCount

Obtém a quantidade de linhas na tabela.

rows

Obtém todas as linhas da tabela.

shadingColor

Especifica a cor do sombreado. Você pode definir a cor no formato "#RRGGBB" ou usando o nome da cor.

style

Especifica o nome do estilo da tabela. Use esta propriedade de estilos personalizados e nomes de estilo localizados. Para usar os estilos internos que são portáteis entre localidades, confira a propriedade "styleBuiltIn".

styleBandedColumns

Especifica se a tabela tem colunas listadas.

styleBandedRows

Especifica se a tabela tem linhas listadas.

styleBuiltIn

Especifica o nome de estilo incorporado para a tabela. Use esta propriedade para estilos internos que são portáteis entre localidades. Para usar estilos personalizados ou nomes de estilo localizados, confira a propriedade "estilo".

styleFirstColumn

Especifica se a tabela tem uma primeira coluna com um estilo especial.

styleLastColumn

Especifica se a tabela tem uma última coluna com um estilo especial.

styleTotalRow

Especifica se a tabela tem uma linha total (última) com um estilo especial.

tables

Obtém as tabelas filho aninhadas em um nível mais profundo.

values

Especifica os valores de texto na tabela, como uma matriz JavaScript 2D.

verticalAlignment

Especifica o alinhamento vertical de cada célula na tabela. O valor pode ser "Superior", "Central" ou "Inferior".

width

Especifica a largura da tabela em pontos.

Métodos

addColumns(insertLocation, columnCount, values)

Adiciona colunas ao início ou no final da tabela, usando a primeira ou última coluna existente como um modelo. Isto é aplicável às tabelas uniformes. Os valores de cadeia de caracteres, se especificado, são definidos nas linhas recém-inseridas.

addRows(insertLocation, rowCount, values)

Adiciona linhas ao início ou no final da tabela, usando a primeira ou última linha existente como um modelo. Os valores de cadeia de caracteres, se especificado, são definidos nas linhas recém-inseridas.

autoFitWindow()

Autoajusta as colunas da tabela para a largura da janela.

clear()

Limpa o conteúdo da tabela.

delete()

Exclui toda a tabela.

deleteColumns(columnIndex, columnCount)

Exclui colunas específicas. Isto é aplicável às tabelas uniformes.

deleteRows(rowIndex, rowCount)

Exclui linha específicas.

distributeColumns()

Distribui uniformemente a largura das colunas. Isto é aplicável às tabelas uniformes.

getBorder(borderLocation)

Obtém o estilo de borda para a borda especificada.

getBorder(borderLocationString)

Obtém o estilo de borda para a borda especificada.

getCell(rowIndex, cellIndex)

Obtém a célula da tabela em uma linha e coluna especificada. Gera um ItemNotFound erro se a célula da tabela especificada não existir.

getCellOrNullObject(rowIndex, cellIndex)

Obtém a célula da tabela em uma linha e coluna especificada. Se a célula de tabela especificada não existir, este método devolverá um objeto com a respetiva isNullObject propriedade definida como true. Para obter mais informações, veja *OrNullObject methods and properties (Métodos e propriedades do OrNullObject).

getCellPadding(cellPaddingLocation)

Obtém o preenchimento de célula em pontos.

getCellPadding(cellPaddingLocationString)

Obtém o preenchimento de célula em pontos.

getNext()

Obtém a próxima tabela. Gera um ItemNotFound erro se esta tabela for a última.

getNextOrNullObject()

Obtém a próxima tabela. Se esta tabela for a última, este método devolverá um objeto com a respetiva isNullObject propriedade definida como true. Para obter mais informações, veja *OrNullObject methods and properties (Métodos e propriedades do OrNullObject).

getParagraphAfter()

Obtém o parágrafo após a tabela. Gera um ItemNotFound erro se não existir um parágrafo a seguir à tabela.

getParagraphAfterOrNullObject()

Obtém o parágrafo após a tabela. Se não existir um parágrafo a seguir à tabela, este método devolverá um objeto com a respetiva isNullObject propriedade definida como true. Para obter mais informações, veja *OrNullObject methods and properties (Métodos e propriedades do OrNullObject).

getParagraphBefore()

Obtém o parágrafo antes da tabela. Gera um ItemNotFound erro se não existir um parágrafo antes da tabela.

getParagraphBeforeOrNullObject()

Obtém o parágrafo antes da tabela. Se não existir um parágrafo antes da tabela, este método devolverá um objeto com a respetiva isNullObject propriedade definida como true. Para obter mais informações, veja *OrNullObject methods and properties (Métodos e propriedades do OrNullObject).

getRange(rangeLocation)

Obtém o intervalo que contém esta tabela, ou o intervalo no início ou no final da tabela.

insertContentControl()

Insere um controle de conteúdo na tabela.

insertParagraph(paragraphText, insertLocation)

Insere um parágrafo no local especificado.

insertTable(rowCount, columnCount, insertLocation, values)

Insere uma tabela com a quantidade especificada de linhas e colunas.

load(options)

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

load(propertyNames)

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

load(propertyNamesAndPaths)

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

mergeCells(topRow, firstCell, bottomRow, lastCell)

Intercala as células delimitadas inclusivamente por uma primeira e última célula.

search(searchText, searchOptions)

Efetua uma pesquisa com as SearchOptions especificadas no âmbito do objeto de tabela. Os resultados da pesquisa são uma coleção de objetos Range.

select(selectionMode)

Seleciona a tabela, ou então, a posição no início ou no final da tabela e navega na interface do usuário do Word até ela.

select(selectionModeString)

Seleciona a tabela, ou então, a posição no início ou no final da tabela e navega na interface do usuário do Word até ela.

set(properties, options)

Define várias propriedades de um objeto ao mesmo tempo. Pode transmitir um objeto simples com as propriedades adequadas ou outro objeto de API do mesmo tipo.

set(properties)

Define várias propriedades no objeto ao mesmo tempo, com base num objeto carregado existente.

setCellPadding(cellPaddingLocation, cellPadding)

Define o preenchimento de célula em pontos.

setCellPadding(cellPaddingLocationString, cellPadding)

Define o preenchimento de célula em pontos.

toJSON()

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 Word.Table é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como Word.Interfaces.TableData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.

track()

Acompanha o objeto para ajuste automático com base nas alterações adjacentes no documento. Esta chamada é uma abreviatura de context.trackedObjects.add(thisObject). Se estiver a utilizar este objeto entre .sync chamadas e fora da execução sequencial de um lote ".run" e receber um erro "InvalidObjectPath" ao definir uma propriedade ou invocar um método no objeto, terá de adicionar o objeto à coleção de objetos controlados quando o objeto foi criado pela primeira vez. Se este objeto fizer parte de uma coleção, também deve controlar a coleção principal.

untrack()

Libere a memória associada a este objeto, se ele já tiver sido rastreado anteriormente. Esta chamada é abreviada para context.trackedObjects.remove(thisObject). Ter muitos objetos rastreados desacelera o aplicativo host, por isso, lembre-se de liberar todos os objetos adicionados após usá-los. Terá de chamar context.sync() antes de a libertação da memória ser aplicada.

Detalhes da propriedade

alignment

Especifica o alinhamento da tabela em relação à coluna de página. O valor pode ser "Esquerda", "Centrado" ou "Direita".

alignment: Word.Alignment | "Mixed" | "Unknown" | "Left" | "Centered" | "Right" | "Justified";

Valor da propriedade

Word.Alignment | "Mixed" | "Unknown" | "Left" | "Centered" | "Right" | "Justified"

Comentários

[ Conjunto de API: WordApi 1.3 ]

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/manage-formatting.yaml

// Gets alignment details about the first table in the document.
await Word.run(async (context) => {
  const firstTable: Word.Table = context.document.body.tables.getFirst();
  firstTable.load(["alignment", "horizontalAlignment", "verticalAlignment"]);
  await context.sync();

  console.log(`Details about the alignment of the first table:`, `- Alignment of the table within the containing page column: ${firstTable.alignment}`, `- Horizontal alignment of every cell in the table: ${firstTable.horizontalAlignment}`, `- Vertical alignment of every cell in the table: ${firstTable.verticalAlignment}`);
});

context

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

endnotes

Obtém a coleção de notas de fim na tabela.

readonly endnotes: Word.NoteItemCollection;

Valor da propriedade

Comentários

[ Conjunto de API: WordApi 1.5 ]

fields

Obtém a coleção de objetos de campo na tabela.

readonly fields: Word.FieldCollection;

Valor da propriedade

Comentários

[ Conjunto de API: WordApi 1.4 ]

font

Obtém a fonte. Use isto para obter e definir o nome, o tamanho e a cor da fonte, além de outras propriedades.

readonly font: Word.Font;

Valor da propriedade

Comentários

[ Conjunto de API: WordApi 1.3 ]

footnotes

Obtém a coleção de notas de rodapé na tabela.

readonly footnotes: Word.NoteItemCollection;

Valor da propriedade

Comentários

[ Conjunto de API: WordApi 1.5 ]

headerRowCount

Especifica o número de linhas de cabeçalho.

headerRowCount: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: WordApi 1.3 ]

horizontalAlignment

Especifica o alinhamento horizontal de cada célula na tabela. O valor pode ser "Esquerda", "Centrado", "À Direita" ou "Justificado".

horizontalAlignment: Word.Alignment | "Mixed" | "Unknown" | "Left" | "Centered" | "Right" | "Justified";

Valor da propriedade

Word.Alignment | "Mixed" | "Unknown" | "Left" | "Centered" | "Right" | "Justified"

Comentários

[ Conjunto de API: WordApi 1.3 ]

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/manage-formatting.yaml

// Gets alignment details about the first table in the document.
await Word.run(async (context) => {
  const firstTable: Word.Table = context.document.body.tables.getFirst();
  firstTable.load(["alignment", "horizontalAlignment", "verticalAlignment"]);
  await context.sync();

  console.log(`Details about the alignment of the first table:`, `- Alignment of the table within the containing page column: ${firstTable.alignment}`, `- Horizontal alignment of every cell in the table: ${firstTable.horizontalAlignment}`, `- Vertical alignment of every cell in the table: ${firstTable.verticalAlignment}`);
});

isUniform

Indica se todas as linhas de tabela são uniformes.

readonly isUniform: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: WordApi 1.3 ]

nestingLevel

Obtém o nível de aninhamento da tabela. Tabelas de nível superior têm o nível 1.

readonly nestingLevel: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: WordApi 1.3 ]

parentBody

Obtém o corpo pai da tabela.

readonly parentBody: Word.Body;

Valor da propriedade

Comentários

[ Conjunto de API: WordApi 1.3 ]

parentContentControl

Obtém o controle de conteúdo que contém a tabela. Gera um ItemNotFound erro se não existir um controlo de conteúdo principal.

readonly parentContentControl: Word.ContentControl;

Valor da propriedade

Comentários

[ Conjunto de API: WordApi 1.3 ]

parentContentControlOrNullObject

Obtém o controle de conteúdo que contém a tabela. Se não existir um controlo de conteúdo principal, este método devolverá um objeto com a respetiva isNullObject propriedade definida como true. Para obter mais informações, veja *OrNullObject methods and properties (Métodos e propriedades do OrNullObject).

readonly parentContentControlOrNullObject: Word.ContentControl;

Valor da propriedade

Comentários

[ Conjunto de API: WordApi 1.3 ]

parentTable

Obtém a tabela que contém esta tabela. Gera um ItemNotFound erro se não estiver contido numa tabela.

readonly parentTable: Word.Table;

Valor da propriedade

Comentários

[ Conjunto de API: WordApi 1.3 ]

parentTableCell

Obtém a célula de tabela que contém esta tabela. Gera um ItemNotFound erro se não estiver contido numa célula de tabela.

readonly parentTableCell: Word.TableCell;

Valor da propriedade

Comentários

[ Conjunto de API: WordApi 1.3 ]

parentTableCellOrNullObject

Obtém a célula de tabela que contém esta tabela. Se não estiver contido numa célula de tabela, este método devolverá um objeto com a respetiva isNullObject propriedade definida como true. Para obter mais informações, veja *OrNullObject methods and properties (Métodos e propriedades do OrNullObject).

readonly parentTableCellOrNullObject: Word.TableCell;

Valor da propriedade

Comentários

[ Conjunto de API: WordApi 1.3 ]

parentTableOrNullObject

Obtém a tabela que contém esta tabela. Se não estiver contido numa tabela, este método devolverá um objeto com a respetiva isNullObject propriedade definida como true. Para obter mais informações, veja *OrNullObject methods and properties (Métodos e propriedades do OrNullObject).

readonly parentTableOrNullObject: Word.Table;

Valor da propriedade

Comentários

[ Conjunto de API: WordApi 1.3 ]

rowCount

Obtém a quantidade de linhas na tabela.

readonly rowCount: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: WordApi 1.3 ]

rows

Obtém todas as linhas da tabela.

readonly rows: Word.TableRowCollection;

Valor da propriedade

Comentários

[ Conjunto de API: WordApi 1.3 ]

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/manage-formatting.yaml

// Gets content alignment details about the first row of the first table in the document.
await Word.run(async (context) => {
  const firstTable: Word.Table = context.document.body.tables.getFirst();
  const firstTableRow: Word.TableRow = firstTable.rows.getFirst();
  firstTableRow.load(["horizontalAlignment", "verticalAlignment"]);
  await context.sync();

  console.log(`Details about the alignment of the first table's first row:`, `- Horizontal alignment of every cell in the row: ${firstTableRow.horizontalAlignment}`, `- Vertical alignment of every cell in the row: ${firstTableRow.verticalAlignment}`);
});

shadingColor

Especifica a cor do sombreado. Você pode definir a cor no formato "#RRGGBB" ou usando o nome da cor.

shadingColor: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: WordApi 1.3 ]

style

Especifica o nome do estilo da tabela. Use esta propriedade de estilos personalizados e nomes de estilo localizados. Para usar os estilos internos que são portáteis entre localidades, confira a propriedade "styleBuiltIn".

style: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: WordApi 1.3 ]

styleBandedColumns

Especifica se a tabela tem colunas listadas.

styleBandedColumns: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: WordApi 1.3 ]

styleBandedRows

Especifica se a tabela tem linhas listadas.

styleBandedRows: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: WordApi 1.3 ]

styleBuiltIn

Especifica o nome de estilo incorporado para a tabela. Use esta propriedade para estilos internos que são portáteis entre localidades. Para usar estilos personalizados ou nomes de estilo localizados, confira a propriedade "estilo".

styleBuiltIn: Word.BuiltInStyleName | "Other" | "Normal" | "Heading1" | "Heading2" | "Heading3" | "Heading4" | "Heading5" | "Heading6" | "Heading7" | "Heading8" | "Heading9" | "Toc1" | "Toc2" | "Toc3" | "Toc4" | "Toc5" | "Toc6" | "Toc7" | "Toc8" | "Toc9" | "FootnoteText" | "Header" | "Footer" | "Caption" | "FootnoteReference" | "EndnoteReference" | "EndnoteText" | "Title" | "Subtitle" | "Hyperlink" | "Strong" | "Emphasis" | "NoSpacing" | "ListParagraph" | "Quote" | "IntenseQuote" | "SubtleEmphasis" | "IntenseEmphasis" | "SubtleReference" | "IntenseReference" | "BookTitle" | "Bibliography" | "TocHeading" | "TableGrid" | "PlainTable1" | "PlainTable2" | "PlainTable3" | "PlainTable4" | "PlainTable5" | "TableGridLight" | "GridTable1Light" | "GridTable1Light_Accent1" | "GridTable1Light_Accent2" | "GridTable1Light_Accent3" | "GridTable1Light_Accent4" | "GridTable1Light_Accent5" | "GridTable1Light_Accent6" | "GridTable2" | "GridTable2_Accent1" | "GridTable2_Accent2" | "GridTable2_Accent3" | "GridTable2_Accent4" | "GridTable2_Accent5" | "GridTable2_Accent6" | "GridTable3" | "GridTable3_Accent1" | "GridTable3_Accent2" | "GridTable3_Accent3" | "GridTable3_Accent4" | "GridTable3_Accent5" | "GridTable3_Accent6" | "GridTable4" | "GridTable4_Accent1" | "GridTable4_Accent2" | "GridTable4_Accent3" | "GridTable4_Accent4" | "GridTable4_Accent5" | "GridTable4_Accent6" | "GridTable5Dark" | "GridTable5Dark_Accent1" | "GridTable5Dark_Accent2" | "GridTable5Dark_Accent3" | "GridTable5Dark_Accent4" | "GridTable5Dark_Accent5" | "GridTable5Dark_Accent6" | "GridTable6Colorful" | "GridTable6Colorful_Accent1" | "GridTable6Colorful_Accent2" | "GridTable6Colorful_Accent3" | "GridTable6Colorful_Accent4" | "GridTable6Colorful_Accent5" | "GridTable6Colorful_Accent6" | "GridTable7Colorful" | "GridTable7Colorful_Accent1" | "GridTable7Colorful_Accent2" | "GridTable7Colorful_Accent3" | "GridTable7Colorful_Accent4" | "GridTable7Colorful_Accent5" | "GridTable7Colorful_Accent6" | "ListTable1Light" | "ListTable1Light_Accent1" | "ListTable1Light_Accent2" | "ListTable1Light_Accent3" | "ListTable1Light_Accent4" | "ListTable1Light_Accent5" | "ListTable1Light_Accent6" | "ListTable2" | "ListTable2_Accent1" | "ListTable2_Accent2" | "ListTable2_Accent3" | "ListTable2_Accent4" | "ListTable2_Accent5" | "ListTable2_Accent6" | "ListTable3" | "ListTable3_Accent1" | "ListTable3_Accent2" | "ListTable3_Accent3" | "ListTable3_Accent4" | "ListTable3_Accent5" | "ListTable3_Accent6" | "ListTable4" | "ListTable4_Accent1" | "ListTable4_Accent2" | "ListTable4_Accent3" | "ListTable4_Accent4" | "ListTable4_Accent5" | "ListTable4_Accent6" | "ListTable5Dark" | "ListTable5Dark_Accent1" | "ListTable5Dark_Accent2" | "ListTable5Dark_Accent3" | "ListTable5Dark_Accent4" | "ListTable5Dark_Accent5" | "ListTable5Dark_Accent6" | "ListTable6Colorful" | "ListTable6Colorful_Accent1" | "ListTable6Colorful_Accent2" | "ListTable6Colorful_Accent3" | "ListTable6Colorful_Accent4" | "ListTable6Colorful_Accent5" | "ListTable6Colorful_Accent6" | "ListTable7Colorful" | "ListTable7Colorful_Accent1" | "ListTable7Colorful_Accent2" | "ListTable7Colorful_Accent3" | "ListTable7Colorful_Accent4" | "ListTable7Colorful_Accent5" | "ListTable7Colorful_Accent6";

Valor da propriedade

Word.BuiltInStyleName | "Other" | "Normal" | "Heading1" | "Heading2" | "Heading3" | "Heading4" | "Heading5" | "Heading6" | "Heading7" | "Heading8" | "Heading9" | "Toc1" | "Toc2" | "Toc3" | "Toc4" | "Toc5" | "Toc6" | "Toc7" | "Toc8" | "Toc9" | "FootnoteText" | "Header" | "Footer" | "Caption" | "FootnoteReference" | "EndnoteReference" | "EndnoteText" | "Title" | "Subtitle" | "Hyperlink" | "Strong" | "Emphasis" | "NoSpacing" | "ListParagraph" | "Quote" | "IntenseQuote" | "SubtleEmphasis" | "IntenseEmphasis" | "SubtleReference" | "IntenseReference" | "BookTitle" | "Bibliography" | "TocHeading" | "TableGrid" | "PlainTable1" | "PlainTable2" | "PlainTable3" | "PlainTable4" | "PlainTable5" | "TableGridLight" | "GridTable1Light" | "GridTable1Light_Accent1" | "GridTable1Light_Accent2" | "GridTable1Light_Accent3" | "GridTable1Light_Accent4" | "GridTable1Light_Accent5" | "GridTable1Light_Accent6" | "GridTable2" | "GridTable2_Accent1" | "GridTable2_Accent2" | "GridTable2_Accent3" | "GridTable2_Accent4" | "GridTable2_Accent5" | "GridTable2_Accent6" | "GridTable3" | "GridTable3_Accent1" | "GridTable3_Accent2" | "GridTable3_Accent3" | "GridTable3_Accent4" | "GridTable3_Accent5" | "GridTable3_Accent6" | "GridTable4" | "GridTable4_Accent1" | "GridTable4_Accent2" | "GridTable4_Accent3" | "GridTable4_Accent4" | "GridTable4_Accent5" | "GridTable4_Accent6" | "GridTable5Dark" | "GridTable5Dark_Accent1" | "GridTable5Dark_Accent2" | "GridTable5Dark_Accent3" | "GridTable5Dark_Accent4" | "GridTable5Dark_Accent5" | "GridTable5Dark_Accent6" | "GridTable6Colorful" | "GridTable6Colorful_Accent1" | "GridTable6Colorful_Accent2" | "GridTable6Colorful_Accent3" | "GridTable6Colorful_Accent4" | "GridTable6Colorful_Accent5" | "GridTable6Colorful_Accent6" | "GridTable7Colorful" | "GridTable7Colorful_Accent1" | "GridTable7Colorful_Accent2" | "GridTable7Colorful_Accent3" | "GridTable7Colorful_Accent4" | "GridTable7Colorful_Accent5" | "GridTable7Colorful_Accent6" | "ListTable1Light" | "ListTable1Light_Accent1" | "ListTable1Light_Accent2" | "ListTable1Light_Accent3" | "ListTable1Light_Accent4" | "ListTable1Light_Accent5" | "ListTable1Light_Accent6" | "ListTable2" | "ListTable2_Accent1" | "ListTable2_Accent2" | "ListTable2_Accent3" | "ListTable2_Accent4" | "ListTable2_Accent5" | "ListTable2_Accent6" | "ListTable3" | "ListTable3_Accent1" | "ListTable3_Accent2" | "ListTable3_Accent3" | "ListTable3_Accent4" | "ListTable3_Accent5" | "ListTable3_Accent6" | "ListTable4" | "ListTable4_Accent1" | "ListTable4_Accent2" | "ListTable4_Accent3" | "ListTable4_Accent4" | "ListTable4_Accent5" | "ListTable4_Accent6" | "ListTable5Dark" | "ListTable5Dark_Accent1" | "ListTable5Dark_Accent2" | "ListTable5Dark_Accent3" | "ListTable5Dark_Accent4" | "ListTable5Dark_Accent5" | "ListTable5Dark_Accent6" | "ListTable6Colorful" | "ListTable6Colorful_Accent1" | "ListTable6Colorful_Accent2" | "ListTable6Colorful_Accent3" | "ListTable6Colorful_Accent4" | "ListTable6Colorful_Accent5" | "ListTable6Colorful_Accent6" | "ListTable7Colorful" | "ListTable7Colorful_Accent1" | "ListTable7Colorful_Accent2" | "ListTable7Colorful_Accent3" | "ListTable7Colorful_Accent4" | "ListTable7Colorful_Accent5" | "ListTable7Colorful_Accent6"

Comentários

[ Conjunto de API: WordApi 1.3 ]

styleFirstColumn

Especifica se a tabela tem uma primeira coluna com um estilo especial.

styleFirstColumn: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: WordApi 1.3 ]

styleLastColumn

Especifica se a tabela tem uma última coluna com um estilo especial.

styleLastColumn: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: WordApi 1.3 ]

styleTotalRow

Especifica se a tabela tem uma linha total (última) com um estilo especial.

styleTotalRow: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: WordApi 1.3 ]

tables

Obtém as tabelas filho aninhadas em um nível mais profundo.

readonly tables: Word.TableCollection;

Valor da propriedade

Comentários

[ Conjunto de API: WordApi 1.3 ]

values

Especifica os valores de texto na tabela, como uma matriz JavaScript 2D.

values: string[][];

Valor da propriedade

string[][]

Comentários

[ Conjunto de API: WordApi 1.3 ]

verticalAlignment

Especifica o alinhamento vertical de cada célula na tabela. O valor pode ser "Superior", "Central" ou "Inferior".

verticalAlignment: Word.VerticalAlignment | "Mixed" | "Top" | "Center" | "Bottom";

Valor da propriedade

Word.VerticalAlignment | "Mixed" | "Top" | "Center" | "Bottom"

Comentários

[ Conjunto de API: WordApi 1.3 ]

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/manage-formatting.yaml

// Gets alignment details about the first table in the document.
await Word.run(async (context) => {
  const firstTable: Word.Table = context.document.body.tables.getFirst();
  firstTable.load(["alignment", "horizontalAlignment", "verticalAlignment"]);
  await context.sync();

  console.log(`Details about the alignment of the first table:`, `- Alignment of the table within the containing page column: ${firstTable.alignment}`, `- Horizontal alignment of every cell in the table: ${firstTable.horizontalAlignment}`, `- Vertical alignment of every cell in the table: ${firstTable.verticalAlignment}`);
});

width

Especifica a largura da tabela em pontos.

width: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: WordApi 1.3 ]

Detalhes do método

addColumns(insertLocation, columnCount, values)

Adiciona colunas ao início ou no final da tabela, usando a primeira ou última coluna existente como um modelo. Isto é aplicável às tabelas uniformes. Os valores de cadeia de caracteres, se especificado, são definidos nas linhas recém-inseridas.

addColumns(insertLocation: Word.InsertLocation.start | Word.InsertLocation.end | "Start" | "End", columnCount: number, values?: string[][]): void;

Parâmetros

insertLocation

start | end | "Start" | "End"

Obrigatório. Tem de ser "Iniciar" ou "Terminar", correspondente ao lado adequado da tabela.

columnCount

number

Obrigatório. Número de colunas a adicionar.

values

string[][]

Matriz 2D opcional. As células serão preenchidas se as cadeias de caracteres correspondentes estiverem especificadas na matriz.

Retornos

void

Comentários

[ Conjunto de API: WordApi 1.3 ]

addRows(insertLocation, rowCount, values)

Adiciona linhas ao início ou no final da tabela, usando a primeira ou última linha existente como um modelo. Os valores de cadeia de caracteres, se especificado, são definidos nas linhas recém-inseridas.

addRows(insertLocation: Word.InsertLocation.start | Word.InsertLocation.end | "Start" | "End", rowCount: number, values?: string[][]): Word.TableRowCollection;

Parâmetros

insertLocation

start | end | "Start" | "End"

Obrigatório. Tem de ser "Iniciar" ou "Terminar".

rowCount

number

Obrigatório. Número de linhas a adicionar.

values

string[][]

Matriz 2D opcional. As células serão preenchidas se as cadeias de caracteres correspondentes estiverem especificadas na matriz.

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

autoFitWindow()

Autoajusta as colunas da tabela para a largura da janela.

autoFitWindow(): void;

Retornos

void

Comentários

[ Conjunto de API: WordApi 1.3 ]

clear()

Limpa o conteúdo da tabela.

clear(): void;

Retornos

void

Comentários

[ Conjunto de API: WordApi 1.3 ]

delete()

Exclui toda a tabela.

delete(): void;

Retornos

void

Comentários

[ Conjunto de API: WordApi 1.3 ]

deleteColumns(columnIndex, columnCount)

Exclui colunas específicas. Isto é aplicável às tabelas uniformes.

deleteColumns(columnIndex: number, columnCount?: number): void;

Parâmetros

columnIndex

number

Obrigatório. A primeira coluna a eliminar.

columnCount

number

Opcional. O número de colunas a eliminar. Predefinição 1.

Retornos

void

Comentários

[ Conjunto de API: WordApi 1.3 ]

deleteRows(rowIndex, rowCount)

Exclui linha específicas.

deleteRows(rowIndex: number, rowCount?: number): void;

Parâmetros

rowIndex

number

Obrigatório. A primeira linha a eliminar.

rowCount

number

Opcional. O número de linhas a eliminar. Predefinição 1.

Retornos

void

Comentários

[ Conjunto de API: WordApi 1.3 ]

distributeColumns()

Distribui uniformemente a largura das colunas. Isto é aplicável às tabelas uniformes.

distributeColumns(): void;

Retornos

void

Comentários

[ Conjunto de API: WordApi 1.3 ]

getBorder(borderLocation)

Obtém o estilo de borda para a borda especificada.

getBorder(borderLocation: Word.BorderLocation): Word.TableBorder;

Parâmetros

borderLocation
Word.BorderLocation

Obrigatório. A localização do limite.

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/manage-formatting.yaml

// Gets border details about the first table in the document.
await Word.run(async (context) => {
  const firstTable: Word.Table = context.document.body.tables.getFirst();
  const borderLocation = Word.BorderLocation.top;
  const border: Word.TableBorder = firstTable.getBorder(borderLocation);
  border.load(["type", "color", "width"]);
  await context.sync();

  console.log(`Details about the ${borderLocation} border of the first table:`, `- Color: ${border.color}`, `- Type: ${border.type}`, `- Width: ${border.width} points`);
});

getBorder(borderLocationString)

Obtém o estilo de borda para a borda especificada.

getBorder(borderLocationString: "Top" | "Left" | "Bottom" | "Right" | "InsideHorizontal" | "InsideVertical" | "Inside" | "Outside" | "All"): Word.TableBorder;

Parâmetros

borderLocationString

"Top" | "Left" | "Bottom" | "Right" | "InsideHorizontal" | "InsideVertical" | "Inside" | "Outside" | "All"

Obrigatório. A localização do limite.

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

getCell(rowIndex, cellIndex)

Obtém a célula da tabela em uma linha e coluna especificada. Gera um ItemNotFound erro se a célula da tabela especificada não existir.

getCell(rowIndex: number, cellIndex: number): Word.TableCell;

Parâmetros

rowIndex

number

Obrigatório. O índice da linha.

cellIndex

number

Obrigatório. O índice da célula na linha.

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/table-cell-access.yaml

// Gets the content of the first cell in the first table.
await Word.run(async (context) => {
  const firstCell: Word.Body = context.document.body.tables.getFirst().getCell(0, 0).body;
  firstCell.load("text");

  await context.sync();
  console.log("First cell's text is: " + firstCell.text);
});

getCellOrNullObject(rowIndex, cellIndex)

Obtém a célula da tabela em uma linha e coluna especificada. Se a célula de tabela especificada não existir, este método devolverá um objeto com a respetiva isNullObject propriedade definida como true. Para obter mais informações, veja *OrNullObject methods and properties (Métodos e propriedades do OrNullObject).

getCellOrNullObject(rowIndex: number, cellIndex: number): Word.TableCell;

Parâmetros

rowIndex

number

Obrigatório. O índice da linha.

cellIndex

number

Obrigatório. O índice da célula na linha.

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

getCellPadding(cellPaddingLocation)

Obtém o preenchimento de célula em pontos.

getCellPadding(cellPaddingLocation: Word.CellPaddingLocation): OfficeExtension.ClientResult<number>;

Parâmetros

cellPaddingLocation
Word.CellPaddingLocation

Obrigatório. A localização do preenchimento da célula tem de ser "Superior", "Esquerda", "Inferior" ou "Direita".

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/40-tables/manage-formatting.yaml

// Gets cell padding details about the first table in the document.
await Word.run(async (context) => {
  const firstTable: Word.Table = context.document.body.tables.getFirst();
  const cellPaddingLocation = Word.CellPaddingLocation.right;
  const cellPadding = firstTable.getCellPadding(cellPaddingLocation);
  await context.sync();

  console.log(
    `Cell padding details about the ${cellPaddingLocation} border of the first table: ${cellPadding.value} points`
  );
});

getCellPadding(cellPaddingLocationString)

Obtém o preenchimento de célula em pontos.

getCellPadding(cellPaddingLocationString: "Top" | "Left" | "Bottom" | "Right"): OfficeExtension.ClientResult<number>;

Parâmetros

cellPaddingLocationString

"Top" | "Left" | "Bottom" | "Right"

Obrigatório. A localização do preenchimento da célula tem de ser "Superior", "Esquerda", "Inferior" ou "Direita".

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

getNext()

Obtém a próxima tabela. Gera um ItemNotFound erro se esta tabela for a última.

getNext(): Word.Table;

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

getNextOrNullObject()

Obtém a próxima tabela. Se esta tabela for a última, este método devolverá um objeto com a respetiva isNullObject propriedade definida como true. Para obter mais informações, veja *OrNullObject methods and properties (Métodos e propriedades do OrNullObject).

getNextOrNullObject(): Word.Table;

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

getParagraphAfter()

Obtém o parágrafo após a tabela. Gera um ItemNotFound erro se não existir um parágrafo a seguir à tabela.

getParagraphAfter(): Word.Paragraph;

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

getParagraphAfterOrNullObject()

Obtém o parágrafo após a tabela. Se não existir um parágrafo a seguir à tabela, este método devolverá um objeto com a respetiva isNullObject propriedade definida como true. Para obter mais informações, veja *OrNullObject methods and properties (Métodos e propriedades do OrNullObject).

getParagraphAfterOrNullObject(): Word.Paragraph;

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

getParagraphBefore()

Obtém o parágrafo antes da tabela. Gera um ItemNotFound erro se não existir um parágrafo antes da tabela.

getParagraphBefore(): Word.Paragraph;

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

getParagraphBeforeOrNullObject()

Obtém o parágrafo antes da tabela. Se não existir um parágrafo antes da tabela, este método devolverá um objeto com a respetiva isNullObject propriedade definida como true. Para obter mais informações, veja *OrNullObject methods and properties (Métodos e propriedades do OrNullObject).

getParagraphBeforeOrNullObject(): Word.Paragraph;

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

getRange(rangeLocation)

Obtém o intervalo que contém esta tabela, ou o intervalo no início ou no final da tabela.

getRange(rangeLocation?: Word.RangeLocation.whole | Word.RangeLocation.start | Word.RangeLocation.end | Word.RangeLocation.after | "Whole" | "Start" | "End" | "After"): Word.Range;

Parâmetros

rangeLocation

whole | start | end | after | "Whole" | "Start" | "End" | "After"

Opcional. A localização do intervalo tem de ser "Inteiro", "Iniciar", "Terminar" ou "Depois".

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

insertContentControl()

Insere um controle de conteúdo na tabela.

insertContentControl(): Word.ContentControl;

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

insertParagraph(paragraphText, insertLocation)

Insere um parágrafo no local especificado.

insertParagraph(paragraphText: string, insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After"): Word.Paragraph;

Parâmetros

paragraphText

string

Obrigatório. O texto do parágrafo a ser inserido.

insertLocation

before | after | "Before" | "After"

Obrigatório. O valor tem de ser "Antes" ou "Depois".

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

insertTable(rowCount, columnCount, insertLocation, values)

Insere uma tabela com a quantidade especificada de linhas e colunas.

insertTable(rowCount: number, columnCount: number, insertLocation: Word.InsertLocation.before | Word.InsertLocation.after | "Before" | "After", values?: string[][]): Word.Table;

Parâmetros

rowCount

number

Obrigatório. A quantidade de linhas na tabela.

columnCount

number

Obrigatório. A quantidade de colunas na tabela.

insertLocation

before | after | "Before" | "After"

Obrigatório. O valor tem de ser "Antes" ou "Depois".

values

string[][]

Matriz 2D opcional. As células serão preenchidas se as cadeias de caracteres correspondentes estiverem especificadas na matriz.

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

load(options)

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

load(options?: Word.Interfaces.TableLoadOptions): Word.Table;

Parâmetros

options
Word.Interfaces.TableLoadOptions

Fornece opções para as propriedades do objeto a carregar.

Retornos

load(propertyNames)

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[]): Word.Table;

Parâmetros

propertyNames

string | string[]

Uma cadeia delimitada por vírgulas ou uma matriz de cadeias que especificam as propriedades a carregar.

Retornos

load(propertyNamesAndPaths)

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;
        }): Word.Table;

Parâmetros

propertyNamesAndPaths

{ select?: string; expand?: string; }

propertyNamesAndPaths.select é uma cadeia delimitada por vírgulas que especifica as propriedades a carregar e propertyNamesAndPaths.expand é uma cadeia delimitada por vírgulas que especifica as propriedades de navegação a carregar.

Retornos

mergeCells(topRow, firstCell, bottomRow, lastCell)

Intercala as células delimitadas inclusivamente por uma primeira e última célula.

mergeCells(topRow: number, firstCell: number, bottomRow: number, lastCell: number): Word.TableCell;

Parâmetros

topRow

number

Obrigatório. A linha da primeira célula

firstCell

number

Obrigatório. O índice da primeira célula na linha

bottomRow

number

Obrigatório. A linha da última célula

lastCell

number

Obrigatório. O índice da última célula na linha

Retornos

Comentários

[ Conjunto de API: WordApi 1.4 ]

search(searchText, searchOptions)

Efetua uma pesquisa com as SearchOptions especificadas no âmbito do objeto de tabela. Os resultados da pesquisa são uma coleção de objetos Range.

search(searchText: string, searchOptions?: Word.SearchOptions | {
            ignorePunct?: boolean;
            ignoreSpace?: boolean;
            matchCase?: boolean;
            matchPrefix?: boolean;
            matchSuffix?: boolean;
            matchWholeWord?: boolean;
            matchWildcards?: boolean;
        }): Word.RangeCollection;

Parâmetros

searchText

string

Obrigatório. O texto da pesquisa.

searchOptions

Word.SearchOptions | { ignorePunct?: boolean; ignoreSpace?: boolean; matchCase?: boolean; matchPrefix?: boolean; matchSuffix?: boolean; matchWholeWord?: boolean; matchWildcards?: boolean; }

Opcional. Opções da pesquisa.

Retornos

Comentários

[ Conjunto de API: WordApi 1.3 ]

select(selectionMode)

Seleciona a tabela, ou então, a posição no início ou no final da tabela e navega na interface do usuário do Word até ela.

select(selectionMode?: Word.SelectionMode): void;

Parâmetros

selectionMode
Word.SelectionMode

Opcional. O modo de seleção tem de ser "Selecionar", "Iniciar" ou "Terminar". 'Select' é o padrão.

Retornos

void

Comentários

[ Conjunto de API: WordApi 1.3 ]

select(selectionModeString)

Seleciona a tabela, ou então, a posição no início ou no final da tabela e navega na interface do usuário do Word até ela.

select(selectionModeString?: "Select" | "Start" | "End"): void;

Parâmetros

selectionModeString

"Select" | "Start" | "End"

Opcional. O modo de seleção tem de ser "Selecionar", "Iniciar" ou "Terminar". 'Select' é o padrão.

Retornos

void

Comentários

[ Conjunto de API: WordApi 1.3 ]

set(properties, options)

Define várias propriedades de um objeto ao mesmo tempo. Pode transmitir um objeto simples com as propriedades adequadas ou outro objeto de API do mesmo tipo.

set(properties: Interfaces.TableUpdateData, options?: OfficeExtension.UpdateOptions): void;

Parâmetros

properties
Word.Interfaces.TableUpdateData

Um objeto JavaScript com propriedades que são estruturadas isomorfoticamente para as propriedades do objeto no qual o método é chamado.

options
OfficeExtension.UpdateOptions

Fornece uma opção para suprimir erros se o objeto de propriedades tentar definir quaisquer propriedades só de leitura.

Retornos

void

set(properties)

Define várias propriedades no objeto ao mesmo tempo, com base num objeto carregado existente.

set(properties: Word.Table): void;

Parâmetros

properties
Word.Table

Retornos

void

setCellPadding(cellPaddingLocation, cellPadding)

Define o preenchimento de célula em pontos.

setCellPadding(cellPaddingLocation: Word.CellPaddingLocation, cellPadding: number): void;

Parâmetros

cellPaddingLocation
Word.CellPaddingLocation

Obrigatório. A localização do preenchimento da célula tem de ser "Superior", "Esquerda", "Inferior" ou "Direita".

cellPadding

number

Obrigatório. O preenchimento da célula.

Retornos

void

Comentários

[ Conjunto de API: WordApi 1.3 ]

setCellPadding(cellPaddingLocationString, cellPadding)

Define o preenchimento de célula em pontos.

setCellPadding(cellPaddingLocationString: "Top" | "Left" | "Bottom" | "Right", cellPadding: number): void;

Parâmetros

cellPaddingLocationString

"Top" | "Left" | "Bottom" | "Right"

Obrigatório. A localização do preenchimento da célula tem de ser "Superior", "Esquerda", "Inferior" ou "Direita".

cellPadding

number

Obrigatório. O preenchimento da célula.

Retornos

void

Comentários

[ Conjunto de API: WordApi 1.3 ]

toJSON()

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 Word.Table é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como Word.Interfaces.TableData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.

toJSON(): Word.Interfaces.TableData;

Retornos

track()

Acompanha o objeto para ajuste automático com base nas alterações adjacentes no documento. Esta chamada é uma abreviatura de context.trackedObjects.add(thisObject). Se estiver a utilizar este objeto entre .sync chamadas e fora da execução sequencial de um lote ".run" e receber um erro "InvalidObjectPath" ao definir uma propriedade ou invocar um método no objeto, terá de adicionar o objeto à coleção de objetos controlados quando o objeto foi criado pela primeira vez. Se este objeto fizer parte de uma coleção, também deve controlar a coleção principal.

track(): Word.Table;

Retornos

untrack()

Libere a memória associada a este objeto, se ele já tiver sido rastreado anteriormente. Esta chamada é abreviada para context.trackedObjects.remove(thisObject). Ter muitos objetos rastreados desacelera o aplicativo host, por isso, lembre-se de liberar todos os objetos adicionados após usá-los. Terá de chamar context.sync() antes de a libertação da memória ser aplicada.

untrack(): Word.Table;

Retornos