Class TableCell

TableCell

Um elemento que representa uma célula da tabela. Um TableCell está sempre contido em um TableRow e pode conter elementos ListItem, Paragraph ou Table. Para Saiba mais sobre a estrutura do documento no guia para ampliar os arquivos do Documentos Google.

Métodos

MétodoTipo de retornoBreve descrição
appendHorizontalRule()HorizontalRuleCria e anexa um novo HorizontalRule.
appendImage(image)InlineImageCria e anexa um novo InlineImage do blob de imagem especificado.
appendImage(image)InlineImageAnexa o InlineImage fornecido.
appendListItem(listItem)ListItemAnexa o ListItem fornecido.
appendListItem(text)ListItemCria e anexa um novo ListItem.
appendParagraph(paragraph)ParagraphAnexa o Paragraph fornecido.
appendParagraph(text)ParagraphCria e anexa um novo Paragraph.
appendTable()TableCria e anexa um novo Table.
appendTable(cells)TableAnexa um novo Table contendo as células especificadas.
appendTable(table)TableAnexa o Table fornecido.
clear()TableCellLimpa o conteúdo do elemento.
copy()TableCellRetorna uma cópia detalhada e removida do elemento atual.
editAsText()TextRecebe uma versão Text do elemento atual para edição.
findElement(elementType)RangeElementPesquisa o conteúdo do elemento em busca de um descendente do tipo especificado.
findElement(elementType, from)RangeElementPesquisa o conteúdo do elemento em busca de um descendente do tipo especificado, começando pelo RangeElement especificado.
findText(searchPattern)RangeElementPesquisa o conteúdo do elemento para o padrão de texto especificado usando expressões regulares.
findText(searchPattern, from)RangeElementPesquisa o conteúdo do elemento em busca do padrão de texto especificado, começando por um resultado da pesquisa.
getAttributes()ObjectRecupera os atributos do elemento.
getBackgroundColor()StringRecupera a cor do plano de fundo.
getChild(childIndex)ElementRecupera o elemento filho no índice filho especificado.
getChildIndex(child)IntegerRecupera o índice filho para o elemento filho especificado.
getColSpan()IntegerRecupera o período da coluna, que é o número de colunas das células da tabela que essa célula abrange.
getLinkUrl()StringRecupera o URL do link.
getNextSibling()ElementRecupera o próximo elemento irmão do elemento.
getNumChildren()IntegerRecupera o número de filhos.
getPaddingBottom()NumberRecupera o padding da parte de baixo, em pontos.
getPaddingLeft()NumberRecupera o padding esquerdo, em pontos.
getPaddingRight()NumberRecupera o padding correto, em pontos.
getPaddingTop()NumberRecupera o padding superior, em pontos.
getParent()ContainerElementRecupera o elemento pai do elemento.
getParentRow()TableRowRecupera o TableRow que contém o TableCell atual.
getParentTable()TableRecupera o Table que contém o TableCell atual.
getPreviousSibling()ElementRecupera o elemento irmão anterior do elemento.
getRowSpan()IntegerRecupera o período da linha, que é o número de linhas de células da tabela que essa célula abrange.
getText()StringRecupera o conteúdo do elemento como uma string de texto.
getTextAlignment()TextAlignmentExtrai o alinhamento do texto.
getType()ElementTypeRecupera o ElementType do elemento.
getVerticalAlignment()VerticalAlignmentRecupera o VerticalAlignment.
getWidth()NumberRecupera a largura da coluna que contém a célula, em pontos.
insertHorizontalRule(childIndex)HorizontalRuleCria e insere um novo HorizontalRule no índice especificado.
insertImage(childIndex, image)InlineImageCria e insere um InlineImage do blob de imagem especificado, no índice.
insertImage(childIndex, image)InlineImageInsere o InlineImage fornecido no índice especificado.
insertListItem(childIndex, listItem)ListItemInsere o ListItem fornecido no índice especificado.
insertListItem(childIndex, text)ListItemCria e insere um novo ListItem no índice especificado.
insertParagraph(childIndex, paragraph)ParagraphInsere o Paragraph fornecido no índice especificado.
insertParagraph(childIndex, text)ParagraphCria e insere um novo Paragraph no índice especificado.
insertTable(childIndex)TableCria e insere um novo Table no índice especificado.
insertTable(childIndex, cells)TableCria e insere um novo Table contendo as células especificadas no índice especificado.
insertTable(childIndex, table)TableInsere o Table fornecido no índice especificado.
isAtDocumentEnd()BooleanDetermina se o elemento está no final do Document.
merge()TableCellMescla o elemento com o irmão anterior do mesmo tipo.
removeChild(child)TableCellRemove o elemento filho especificado.
removeFromParent()TableCellRemove o elemento do pai.
replaceText(searchPattern, replacement)ElementSubstitui todas as ocorrências de um determinado padrão de texto por uma string de substituição específica, usando valores expressões idiomáticas.
setAttributes(attributes)TableCellDefine os atributos do elemento.
setBackgroundColor(color)TableCellDefine a cor do plano de fundo.
setLinkUrl(url)TableCellDefine o URL do link.
setPaddingBottom(paddingBottom)TableCellDefine o padding da parte de baixo, em pontos.
setPaddingLeft(paddingLeft)TableCellDefine o padding esquerdo, em pontos.
setPaddingRight(paddingRight)TableCellDefine o padding direito, em pontos.
setPaddingTop(paddingTop)TableCellDefine o padding superior, em pontos.
setText(text)TableCellDefine o conteúdo como texto simples.
setTextAlignment(textAlignment)TableCellDefine o alinhamento do texto.
setVerticalAlignment(alignment)TableCellDefine o alinhamento vertical.
setWidth(width)TableCellDefine a largura, em pontos, da coluna que contém a célula atual.

Documentação detalhada

appendHorizontalRule()

Cria e anexa um novo HorizontalRule.

O HorizontalRule vai estar contido em um novo Paragraph.

Retornar

HorizontalRule: a nova regra horizontal

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendImage(image)

Cria e anexa um novo InlineImage do blob de imagem especificado.

O InlineImage vai estar contido em um novo Paragraph.

Parâmetros

NomeTipoDescrição
imageBlobSourceos dados da imagem

Retornar

InlineImage: a nova imagem

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendImage(image)

Anexa o InlineImage fornecido.

O InlineImage vai estar contido em um novo Paragraph.

Parâmetros

NomeTipoDescrição
imageInlineImageos dados da imagem

Retornar

InlineImage: a imagem anexada.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendListItem(listItem)

Anexa o ListItem fornecido.

Parâmetros

NomeTipoDescrição
listItemListItemo item da lista a ser anexado

Retornar

ListItem: o item da lista anexado.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendListItem(text)

Cria e anexa um novo ListItem.

Parâmetros

NomeTipoDescrição
textStringo conteúdo do texto

Retornar

ListItem: o novo item da lista.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendParagraph(paragraph)

Anexa o Paragraph fornecido.

Parâmetros

NomeTipoDescrição
paragraphParagrapho parágrafo a ser anexado

Retornar

Paragraph: o parágrafo anexado.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendParagraph(text)

Cria e anexa um novo Paragraph.

Parâmetros

NomeTipoDescrição
textStringo conteúdo do texto

Retornar

Paragraph: o novo parágrafo

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendTable()

Cria e anexa um novo Table.

Retornar

Table: a nova tabela.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendTable(cells)

Anexa um novo Table contendo as células especificadas.

Parâmetros

NomeTipoDescrição
cellsString[][]o conteúdo de texto das células da tabela para adicionar à nova tabela

Retornar

Table: a tabela anexada.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendTable(table)

Anexa o Table fornecido.

Parâmetros

NomeTipoDescrição
tableTablena tabela a ser anexada

Retornar

Table: a tabela anexada.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

clear()

Limpa o conteúdo do elemento.

Retornar

TableCell: o elemento atual.


copy()

Retorna uma cópia detalhada e removida do elemento atual.

Todos os elementos filhos presentes no elemento também são copiados. O novo elemento não tem pai

Retornar

TableCell: a nova cópia.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

editAsText()

Recebe uma versão Text do elemento atual para edição.

Use editAsText para manipular o conteúdo dos elementos como rich text. O modo editAsText ignora elementos não textuais (como InlineImage e HorizontalRule).

Elementos filho totalmente contidos em um intervalo de texto excluído são removidos do elemento.

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Insert two paragraphs separated by a paragraph containing an
// horizontal rule.
body.insertParagraph(0, "An editAsText sample.");
body.insertHorizontalRule(0);
body.insertParagraph(0, "An example.");

// Delete " sample.\n\n An" removing the horizontal rule in the process.
body.editAsText().deleteText(14, 25);

Retornar

Text: uma versão em texto do elemento atual.


findElement(elementType)

Pesquisa o conteúdo do elemento em busca de um descendente do tipo especificado.

Parâmetros

NomeTipoDescrição
elementTypeElementTypeO tipo de elemento a ser pesquisado.

Retornar

RangeElement: um resultado da pesquisa que indica a posição do elemento de pesquisa.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

findElement(elementType, from)

Pesquisa o conteúdo do elemento em busca de um descendente do tipo especificado, começando pelo RangeElement especificado.

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Define the search parameters.
var searchType = DocumentApp.ElementType.PARAGRAPH;
var searchHeading = DocumentApp.ParagraphHeading.HEADING1;
var searchResult = null;

// Search until the paragraph is found.
while (searchResult = body.findElement(searchType, searchResult)) {
  var par = searchResult.getElement().asParagraph();
  if (par.getHeading() == searchHeading) {
    // Found one, update and stop.
    par.setText('This is the first header.');
    return;
  }
}

Parâmetros

NomeTipoDescrição
elementTypeElementTypeO tipo de elemento a ser pesquisado.
fromRangeElementO resultado da pesquisa a partir do qual pesquisar.

Retornar

RangeElement: um resultado da pesquisa que indica a próxima posição do elemento de pesquisa.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

findText(searchPattern)

Pesquisa o conteúdo do elemento para o padrão de texto especificado usando expressões regulares.

Um subconjunto dos recursos de expressão regular JavaScript não tem suporte total, como grupos de captura e modificadores de modo.

O padrão de expressão regular fornecido corresponde independentemente a cada bloco de texto no elemento atual.

Parâmetros

NomeTipoDescrição
searchPatternStringo padrão a ser pesquisado

Retornar

RangeElement: um resultado da pesquisa que indica a posição do texto da pesquisa, ou nulo se não houver correspondem

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

findText(searchPattern, from)

Pesquisa o conteúdo do elemento em busca do padrão de texto especificado, começando por um resultado da pesquisa.

Um subconjunto dos recursos de expressão regular JavaScript não tem suporte total, como grupos de captura e modificadores de modo.

O padrão de expressão regular fornecido corresponde independentemente a cada bloco de texto no elemento atual.

Parâmetros

NomeTipoDescrição
searchPatternStringo padrão a ser pesquisado
fromRangeElemento resultado da pesquisa a ser pesquisado

Retornar

RangeElement: um resultado da pesquisa que indica a próxima posição do texto da pesquisa, ou nulo se não houver correspondem

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getAttributes()

Recupera os atributos do elemento.

O resultado é um objeto que contém uma propriedade para cada atributo de elemento válido, em que cada nome da propriedade corresponde a um item na enumeração DocumentApp.Attribute.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Append a styled paragraph.
var par = body.appendParagraph('A bold, italicized paragraph.');
par.setBold(true);
par.setItalic(true);

// Retrieve the paragraph's attributes.
var atts = par.getAttributes();

// Log the paragraph attributes.
for (var att in atts) {
  Logger.log(att + ":" + atts[att]);
}

Retornar

Object: os atributos do elemento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getBackgroundColor()

Recupera a cor do plano de fundo.

Retornar

String: a cor do plano de fundo, formatada em notação CSS (como '#ffffff')

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getChild(childIndex)

Recupera o elemento filho no índice filho especificado.

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Obtain the first element in the tab.
var firstChild = body.getChild(0);

// If it's a paragraph, set its contents.
if (firstChild.getType() == DocumentApp.ElementType.PARAGRAPH) {
  firstChild.asParagraph().setText("This is the first paragraph.");
}

Parâmetros

NomeTipoDescrição
childIndexIntegerO índice do elemento filho a ser recuperado.

Retornar

Element: o elemento filho no índice especificado.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getChildIndex(child)

Recupera o índice filho para o elemento filho especificado.

Parâmetros

NomeTipoDescrição
childElementO elemento filho para o qual o índice será recuperado.

Retornar

Integer: o índice filho.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getColSpan()

Recupera o período da coluna, que é o número de colunas das células da tabela que essa célula abrange. As células não mescladas têm um período de coluna de 1.

Retornar

Integer: o período da coluna ou 0 para uma célula que foi mesclada por outra célula

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getLinkUrl()

Recupera o URL do link.

Retornar

String: o URL do link ou nulo se o elemento tiver vários valores para o atributo

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getNextSibling()

Recupera o próximo elemento irmão do elemento.

O próximo irmão tem o mesmo pai e segue o elemento atual.

Retornar

Element: o próximo elemento irmão.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getNumChildren()

Recupera o número de filhos.

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Log the number of elements in the tab.
Logger.log("There are " + body.getNumChildren() +
    " elements in the tab's body.");

Retornar

Integer: o número de filhos.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getPaddingBottom()

Recupera o padding da parte de baixo, em pontos.

Retornar

Number: o padding da parte de baixo, em pontos.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getPaddingLeft()

Recupera o padding esquerdo, em pontos.

Retornar

Number: o padding esquerdo, em pontos.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getPaddingRight()

Recupera o padding correto, em pontos.

Retornar

Number: o padding direito, em pontos.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getPaddingTop()

Recupera o padding superior, em pontos.

Retornar

Number: o padding superior, em pontos.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getParent()

Recupera o elemento pai do elemento.

O elemento pai contém o elemento atual.

Retornar

ContainerElement: o elemento pai.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getParentRow()

Recupera o TableRow que contém o TableCell atual.

Retornar

TableRow: a linha da tabela que contém a célula atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getParentTable()

Recupera o Table que contém o TableCell atual.

Retornar

Table: a tabela que contém a célula atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getPreviousSibling()

Recupera o elemento irmão anterior do elemento.

O irmão anterior tem o mesmo pai e precede o elemento atual.

Retornar

Element: o elemento irmão anterior.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getRowSpan()

Recupera o período da linha, que é o número de linhas de células da tabela que essa célula abrange. Não mesclado as células têm um intervalo de linha de 1.

Retornar

Integer: o período da linha ou 0 de uma célula mesclada por outra célula

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getText()

Recupera o conteúdo do elemento como uma string de texto.

Retornar

String: o conteúdo do elemento como uma string de texto

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getTextAlignment()

Extrai o alinhamento do texto. Os tipos de alinhamento disponíveis são DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT e DocumentApp.TextAlignment.SUPERSCRIPT.

Retornar

TextAlignment: o tipo de alinhamento do texto ou null se o texto contiver vários tipos de texto alinhamentos ou se o alinhamento do texto nunca foi definido

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getType()

Recupera o ElementType do elemento.

Use getType() para determinar o tipo exato de um determinado elemento.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Obtain the first element in the active tab's body.

var firstChild = body.getChild(0);

// Use getType() to determine the element's type.
if (firstChild.getType() == DocumentApp.ElementType.PARAGRAPH) {
  Logger.log('The first element is a paragraph.');
} else {
  Logger.log('The first element is not a paragraph.');
}

Retornar

ElementType: o tipo de elemento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getVerticalAlignment()

Recupera o VerticalAlignment.

Retornar

VerticalAlignment: o alinhamento vertical

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getWidth()

Recupera a largura da coluna que contém a célula, em pontos.

Retornar

Number: a largura da coluna, em pontos.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertHorizontalRule(childIndex)

Cria e insere um novo HorizontalRule no índice especificado.

A regra horizontal será contida em um novo Paragraph.

Parâmetros

NomeTipoDescrição
childIndexIntegero índice no qual o elemento será inserido

Retornar

HorizontalRule: a nova regra horizontal

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertImage(childIndex, image)

Cria e insere um InlineImage do blob de imagem especificado, no índice.

A imagem será contida em um novo Paragraph.

Parâmetros

NomeTipoDescrição
childIndexIntegero índice no qual o elemento será inserido
imageBlobSourceos dados da imagem

Retornar

InlineImage: a imagem inline inserida.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertImage(childIndex, image)

Insere o InlineImage fornecido no índice especificado.

A imagem será contida em um novo Paragraph.

Parâmetros

NomeTipoDescrição
childIndexIntegero índice no qual o elemento será inserido
imageInlineImagea imagem a ser inserida

Retornar

InlineImage: a imagem inline inserida.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertListItem(childIndex, listItem)

Insere o ListItem fornecido no índice especificado.

Parâmetros

NomeTipoDescrição
childIndexIntegero índice no qual o elemento será inserido
listItemListItemo item da lista a ser inserido

Retornar

ListItem: novo item inserido na lista

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertListItem(childIndex, text)

Cria e insere um novo ListItem no índice especificado.

Parâmetros

NomeTipoDescrição
childIndexIntegero índice no qual o elemento será inserido
textStringo conteúdo do texto

Retornar

ListItem: o novo item da lista.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertParagraph(childIndex, paragraph)

Insere o Paragraph fornecido no índice especificado.

Parâmetros

NomeTipoDescrição
childIndexIntegero índice no qual o elemento será inserido
paragraphParagrapho parágrafo a ser inserido

Retornar

Paragraph: o parágrafo inserido

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertParagraph(childIndex, text)

Cria e insere um novo Paragraph no índice especificado.

Parâmetros

NomeTipoDescrição
childIndexIntegero índice no qual o elemento será inserido
textStringo conteúdo do texto

Retornar

Paragraph: o novo parágrafo

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertTable(childIndex)

Cria e insere um novo Table no índice especificado.

Parâmetros

NomeTipoDescrição
childIndexIntegero índice no qual o elemento será inserido

Retornar

Table: a nova tabela.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertTable(childIndex, cells)

Cria e insere um novo Table contendo as células especificadas no índice especificado.

Parâmetros

NomeTipoDescrição
childIndexIntegero índice no qual inserir
cellsString[][]o conteúdo de texto das células da tabela para adicionar à nova tabela

Retornar

Table: a nova tabela.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

insertTable(childIndex, table)

Insere o Table fornecido no índice especificado.

Parâmetros

NomeTipoDescrição
childIndexIntegero índice no qual o elemento será inserido
tableTablena tabela a ser inserida

Retornar

Table: a tabela inserida.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

isAtDocumentEnd()

Determina se o elemento está no final do Document.

Retornar

Boolean: se o elemento está no final da guia.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

merge()

Mescla o elemento com o irmão anterior do mesmo tipo.

Somente elementos do mesmo ElementType podem ser mesclados. Todos os elementos filhos contidos o elemento atual são movidos para o elemento irmão anterior.

O elemento atual é removido do documento.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Example 1: Merge paragraphs
// Append two paragraphs to the document's active tab.
var par1 = body.appendParagraph('Paragraph 1.');
var par2 = body.appendParagraph('Paragraph 2.');
// Merge the newly added paragraphs into a single paragraph.
par2.merge();

// Example 2: Merge table cells
// Create a two-dimensional array containing the table's cell contents.
var cells = [
['Row 1, Cell 1', 'Row 1, Cell 2'],
['Row 2, Cell 1', 'Row 2, Cell 2']
];
// Build a table from the array.
var table = body.appendTable(cells);
// Get the first row in the table.
 var row = table.getRow(0);
// Get the two cells in this row.
var cell1 = row.getCell(0);
var cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
var merged = cell2.merge();

Retornar

TableCell: o elemento mesclado.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

removeChild(child)

Remove o elemento filho especificado.

Parâmetros

NomeTipoDescrição
childElemento elemento filho a ser removido

Retornar

TableCell: o elemento atual

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

removeFromParent()

Remove o elemento do pai.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab()
var body = documentTab.getBody();

// Remove all images in the active tab's body.
var imgs = body.getImages();
for (var i = 0; i < imgs.length; i++) {
  imgs[i].removeFromParent();
}

Retornar

TableCell: o elemento removido.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

replaceText(searchPattern, replacement)

Substitui todas as ocorrências de um determinado padrão de texto por uma string de substituição específica, usando valores expressões idiomáticas.

O padrão de pesquisa é transmitido como uma string, não um objeto de expressão regular JavaScript. Por isso, você precisará fazer o escape de todas as barras invertidas do padrão.

Esse método usa a linguagem RE2 padrão do Google, de expressão, o que limita a sintaxe suportada.

O padrão de expressão regular fornecido corresponde independentemente a cada bloco de texto no elemento atual.

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Clear the text surrounding "Apps Script", with or without text.
body.replaceText("^.*Apps ?Script.*$", "Apps Script");

Parâmetros

NomeTipoDescrição
searchPatternStringo padrão de regex a ser pesquisado
replacementStringo texto a ser usado como substituto

Retornar

Element: o elemento atual

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setAttributes(attributes)

Define os atributos do elemento.

O parâmetro de atributos especificado precisa ser um objeto em que cada nome de propriedade é um item a enumeração DocumentApp.Attribute e cada valor de propriedade é o novo valor a ser aplicada.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Define a custom paragraph style.
var style = {};
style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] =
    DocumentApp.HorizontalAlignment.RIGHT;
style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri';
style[DocumentApp.Attribute.FONT_SIZE] = 18;
style[DocumentApp.Attribute.BOLD] = true;

// Append a plain paragraph.
var par = body.appendParagraph('A paragraph with custom style.');

// Apply the custom style.
par.setAttributes(style);

Parâmetros

NomeTipoDescrição
attributesObjectOs atributos do elemento.

Retornar

TableCell: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setBackgroundColor(color)

Define a cor do plano de fundo.

Parâmetros

NomeTipoDescrição
colorStringa cor do plano de fundo, formatada em notação CSS (como '#ffffff').

Retornar

TableCell: o elemento atual

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setLinkUrl(url)

Define o URL do link.

Parâmetros

NomeTipoDescrição
urlStringo URL do link

Retornar

TableCell: o elemento atual

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setPaddingBottom(paddingBottom)

Define o padding da parte de baixo, em pontos.

Parâmetros

NomeTipoDescrição
paddingBottomNumbero padding da parte de baixo, em pontos

Retornar

TableCell: o elemento atual

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setPaddingLeft(paddingLeft)

Define o padding esquerdo, em pontos.

Parâmetros

NomeTipoDescrição
paddingLeftNumbero padding esquerdo, em pontos;

Retornar

TableCell: o elemento atual

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setPaddingRight(paddingRight)

Define o padding direito, em pontos.

Parâmetros

NomeTipoDescrição
paddingRightNumberO padding direito, em pontos.

Retornar

TableCell: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setPaddingTop(paddingTop)

Define o padding superior, em pontos.

Parâmetros

NomeTipoDescrição
paddingTopNumbero padding superior, em pontos

Retornar

TableCell: o elemento atual

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setText(text)

Define o conteúdo como texto simples.

Observação: o conteúdo existente é apagado.

Parâmetros

NomeTipoDescrição
textStringo novo conteúdo de texto

Retornar

TableCell: o elemento atual

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setTextAlignment(textAlignment)

Define o alinhamento do texto. Os tipos de alinhamento disponíveis são DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT e DocumentApp.TextAlignment.SUPERSCRIPT.

// Make the entire first paragraph in the active tab be superscript.
var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
var text = documentTab.getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);

Parâmetros

NomeTipoDescrição
textAlignmentTextAlignmento tipo de alinhamento de texto a ser aplicado

Retornar

TableCell: o elemento atual

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setVerticalAlignment(alignment)

Define o alinhamento vertical.

Parâmetros

NomeTipoDescrição
alignmentVerticalAlignmento alinhamento vertical

Retornar

TableCell: o elemento atual

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setWidth(width)

Define a largura, em pontos, da coluna que contém a célula atual.

Parâmetros

NomeTipoDescrição
widthNumbera largura da coluna, em pontos

Retornar

TableCell: o elemento atual

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents