Class TableCell

TableCell

Un elemento che rappresenta una cella di tabella. Un elemento TableCell è sempre contenuto in un elemento TableRow e può contenere elementi ListItem, Paragraph o Table. Per maggiori informazioni sulla struttura del documento, consulta la guida all'estensione di Documenti Google.

Metodi

Metodo	Tipo restituito	Breve descrizione
appendHorizontalRule()	HorizontalRule	Crea e aggiunge un nuovo HorizontalRule.
appendImage(image)	InlineImage	Crea e aggiunge un nuovo InlineImage dal blob immagine specificato.
appendImage(image)	InlineImage	Aggiunge il InlineImage specificato.
appendListItem(listItem)	ListItem	Aggiunge il ListItem specificato.
appendListItem(text)	ListItem	Crea e aggiunge un nuovo ListItem.
appendParagraph(paragraph)	Paragraph	Aggiunge il Paragraph specificato.
appendParagraph(text)	Paragraph	Crea e aggiunge un nuovo Paragraph.
appendTable()	Table	Crea e aggiunge un nuovo Table.
appendTable(cells)	Table	Aggiunge un nuovo Table contenente le celle specificate.
appendTable(table)	Table	Aggiunge il Table specificato.
clear()	TableCell	Cancella i contenuti dell'elemento.
copy()	TableCell	Restituisce una copia approfondita e scollegata dell'elemento corrente.
editAsText()	Text	Consente di ottenere una versione Text dell'elemento corrente da modificare.
findElement(elementType)	RangeElement	Cerca nei contenuti dell'elemento un discendente del tipo specificato.
findElement(elementType, from)	RangeElement	Cerca nei contenuti dell'elemento un discendente del tipo specificato, a partire dal RangeElement specificato.
findText(searchPattern)	RangeElement	Cerca, nei contenuti dell'elemento, il pattern di testo specificato utilizzando le espressioni regolari.
findText(searchPattern, from)	RangeElement	Cerca il pattern di testo specificato nei contenuti dell'elemento, a partire da un determinato risultato di ricerca.
getAttributes()	Object	Recupera gli attributi dell'elemento.
getBackgroundColor()	String	Recupera il colore di sfondo.
getChild(childIndex)	Element	Recupera l'elemento figlio all'indice figlio specificato.
getChildIndex(child)	Integer	Recupera l'indice dell'elemento secondario per l'elemento secondario specificato.
getColSpan()	Integer	Recupera l'intervallo di colonne, ovvero il numero di colonne di celle di tabella che questa cella occupa.
getLinkUrl()	String	Recupera l'URL del link.
getNextSibling()	Element	Recupera l'elemento successivo associato all'elemento.
getNumChildren()	Integer	Recupera il numero di bambini.
getPaddingBottom()	Number	Recupera la spaziatura interna inferiore in punti.
getPaddingLeft()	Number	Recupera la spaziatura interna sinistra in punti.
getPaddingRight()	Number	Recupera la spaziatura interna destra in punti.
getPaddingTop()	Number	Recupera la spaziatura interna superiore in punti.
getParent()	ContainerElement	Recupera l'elemento principale dell'elemento.
getParentRow()	TableRow	Recupera il TableRow contenente il TableCell corrente.
getParentTable()	Table	Recupera il Table contenente il TableCell corrente.
getPreviousSibling()	Element	Recupera l'elemento precedente associato all'elemento.
getRowSpan()	Integer	Recupera l'intervallo di righe, ovvero il numero di righe di celle di tabella che questa cella occupa.
getText()	String	Recupera i contenuti dell'elemento come stringa di testo.
getTextAlignment()	TextAlignment	Restituisce l'allineamento del testo.
getType()	ElementType	Recupera il ElementType dell'elemento.
getVerticalAlignment()	VerticalAlignment	Recupera il VerticalAlignment.
getWidth()	Number	Recupera la larghezza della colonna contenente la cella, in punti.
insertHorizontalRule(childIndex)	HorizontalRule	Crea e inserisce un nuovo HorizontalRule nell'indice specificato.
insertImage(childIndex, image)	InlineImage	Crea e inserisce un InlineImage dal blob immagine specificato nell'indice specificato.
insertImage(childIndex, image)	InlineImage	Inserisce il valore InlineImage specificato nell'indice specificato.
insertListItem(childIndex, listItem)	ListItem	Inserisce il valore ListItem specificato nell'indice specificato.
insertListItem(childIndex, text)	ListItem	Crea e inserisce un nuovo ListItem nell'indice specificato.
insertParagraph(childIndex, paragraph)	Paragraph	Inserisce il valore Paragraph specificato nell'indice specificato.
insertParagraph(childIndex, text)	Paragraph	Crea e inserisce un nuovo Paragraph nell'indice specificato.
insertTable(childIndex)	Table	Crea e inserisce un nuovo Table nell'indice specificato.
insertTable(childIndex, cells)	Table	Crea e inserisce un nuovo Table contenente le celle specificate nell'indice specificato.
insertTable(childIndex, table)	Table	Inserisce il valore Table specificato nell'indice specificato.
isAtDocumentEnd()	Boolean	Determina se l'elemento è alla fine del Document.
merge()	TableCell	Unisce l'elemento all'elemento precedente dello stesso tipo.
removeChild(child)	TableCell	Rimuove l'elemento figlio specificato.
removeFromParent()	TableCell	Rimuove l'elemento dal relativo elemento principale.
replaceText(searchPattern, replacement)	Element	Sostituisce tutte le occorrenze di un determinato pattern di testo con una determinata stringa di sostituzione, utilizzando espressioni regolari.
setAttributes(attributes)	TableCell	Imposta gli attributi dell'elemento.
setBackgroundColor(color)	TableCell	Imposta il colore di sfondo.
setLinkUrl(url)	TableCell	Imposta l'URL del link.
setPaddingBottom(paddingBottom)	TableCell	Imposta la spaziatura interna inferiore in punti.
setPaddingLeft(paddingLeft)	TableCell	Imposta la spaziatura interna sinistra in punti.
setPaddingRight(paddingRight)	TableCell	Imposta la spaziatura interna destra in punti.
setPaddingTop(paddingTop)	TableCell	Imposta la spaziatura interna superiore in punti.
setText(text)	TableCell	Imposta i contenuti come testo normale.
setTextAlignment(textAlignment)	TableCell	Imposta l'allineamento del testo.
setVerticalAlignment(alignment)	TableCell	Imposta l'allineamento verticale.
setWidth(width)	TableCell	Imposta la larghezza della colonna contenente la cella corrente in punti.

Documentazione dettagliata

appendHorizontalRule()

Crea e aggiunge un nuovo HorizontalRule.

Il HorizontalRule sarà contenuto in un nuovo Paragraph.

Invio

HorizontalRule: il nuovo righello orizzontale

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

appendImage(image)

Crea e aggiunge un nuovo InlineImage dal blob immagine specificato.

Il InlineImage sarà contenuto in un nuovo Paragraph.

Parametri

Nome	Tipo	Descrizione
image	BlobSource	i dati immagine

Invio

InlineImage: la nuova immagine

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

appendImage(image)

Aggiunge il InlineImage specificato.

Il InlineImage sarà contenuto in un nuovo Paragraph.

Parametri

Nome	Tipo	Descrizione
image	InlineImage	i dati immagine

Invio

InlineImage: l'immagine aggiunta

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

appendListItem(listItem)

Aggiunge il ListItem specificato.

Parametri

Nome	Tipo	Descrizione
listItem	ListItem	l'elemento dell'elenco da aggiungere

Invio

ListItem: la voce dell'elenco aggiunta

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

appendListItem(text)

Crea e aggiunge un nuovo ListItem.

Parametri

Nome	Tipo	Descrizione
text	String	i contenuti del testo

Invio

ListItem: la nuova voce di elenco

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

appendParagraph(paragraph)

Aggiunge il Paragraph specificato.

Parametri

Nome	Tipo	Descrizione
paragraph	Paragraph	il paragrafo da aggiungere

Invio

Paragraph: il paragrafo aggiunto

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

appendParagraph(text)

Crea e aggiunge un nuovo Paragraph.

Parametri

Nome	Tipo	Descrizione
text	String	i contenuti del testo

Invio

Paragraph: il nuovo paragrafo

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

appendTable()

Crea e aggiunge un nuovo Table.

Invio

Table: la nuova tabella

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

appendTable(cells)

Aggiunge un nuovo Table contenente le celle specificate.

Parametri

Nome	Tipo	Descrizione
cells	String[][]	i contenuti di testo delle celle della tabella da aggiungere alla nuova tabella

Invio

Table: la tabella aggiunta

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

appendTable(table)

Aggiunge il Table specificato.

Parametri

Nome	Tipo	Descrizione
table	Table	la tabella da accodare

Invio

Table: la tabella aggiunta

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

clear()

Cancella i contenuti dell'elemento.

Invio

TableCell: l'elemento corrente.

---

copy()

Restituisce una copia approfondita e scollegata dell'elemento corrente.

Vengono copiati anche gli eventuali elementi secondari presenti nell'elemento. Il nuovo elemento non ha un elemento primario.

Invio

TableCell: la nuova copia.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

editAsText()

Consente di ottenere una versione Text dell'elemento corrente da modificare.

Utilizza editAsText per manipolare i contenuti degli elementi come testo avanzato. La modalità editAsText ignora gli elementi non di testo (come InlineImage e HorizontalRule).

Gli elementi secondari completamente contenuti in un intervallo di testo eliminato vengono rimossi dall'elemento.

const 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);

Invio

Text: una versione di testo dell'elemento corrente

---

findElement(elementType)

Cerca nei contenuti dell'elemento un discendente del tipo specificato.

Parametri

Nome	Tipo	Descrizione
elementType	ElementType	Il tipo di elemento da cercare.

Invio

RangeElement: un risultato di ricerca che indica la posizione dell'elemento di ricerca.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

findElement(elementType, from)

Cerca nei contenuti dell'elemento un discendente del tipo specificato, a partire dal RangeElement specificato.

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

// Define the search parameters.

let searchResult = null;

// Search until the paragraph is found.
while (
    (searchResult = body.findElement(
         DocumentApp.ElementType.PARAGRAPH,
         searchResult,
         ))) {
  const par = searchResult.getElement().asParagraph();
  if (par.getHeading() === DocumentApp.ParagraphHeading.HEADING1) {
    // Found one, update and stop.
    par.setText('This is the first header.');
    break;
  }
}

Parametri

Nome	Tipo	Descrizione
elementType	ElementType	Il tipo di elemento da cercare.
from	RangeElement	Il risultato di ricerca da cui effettuare la ricerca.

Invio

RangeElement: un risultato di ricerca che indica la posizione successiva dell'elemento di ricerca.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

findText(searchPattern)

Cerca, nei contenuti dell'elemento, il pattern di testo specificato utilizzando le espressioni regolari.

Un sottoinsieme delle funzionalità delle espressioni regolari di JavaScript non è completamente supportato, ad esempio i gruppi di cattura e i modificatori di modalità.

Il pattern di espressione regolare fornito viene abbinato in modo indipendente a ogni blocco di testo contenuto nell'elemento corrente.

Parametri

Nome	Tipo	Descrizione
searchPattern	String	lo schema da cercare

Invio

RangeElement: un risultato di ricerca che indica la posizione del testo di ricerca oppure null se non esiste alcuna corrispondenza

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

findText(searchPattern, from)

Cerca il pattern di testo specificato nei contenuti dell'elemento, a partire da un determinato risultato di ricerca.

Un sottoinsieme delle funzionalità delle espressioni regolari di JavaScript non è completamente supportato, ad esempio i gruppi di cattura e i modificatori di modalità.

Il pattern di espressione regolare fornito viene abbinato in modo indipendente a ogni blocco di testo contenuto nell'elemento corrente.

Parametri

Nome	Tipo	Descrizione
searchPattern	String	lo schema da cercare
from	RangeElement	il risultato di ricerca da cui effettuare la ricerca

Invio

RangeElement: un risultato di ricerca che indica la posizione successiva del testo di ricerca oppure null se non esiste alcuna corrispondenza

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getAttributes()

Recupera gli attributi dell'elemento.

Il risultato è un oggetto contenente una proprietà per ogni attributo elemento valido, in cui ogni nome della proprietà corrisponde a un elemento dell'enumerazione DocumentApp.Attribute.

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

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

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

// Log the paragraph attributes.
for (const att in atts) {
  Logger.log(`${att}:${atts[att]}`);
}

Invio

Object: gli attributi dell'elemento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getBackgroundColor()

Recupera il colore di sfondo.

Invio

String: il colore di sfondo, formattato in notazione CSS (ad es. '#ffffff')

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getChild(childIndex)

Recupera l'elemento figlio all'indice figlio specificato.

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

// Obtain the first element in the tab.
const 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.');
}

Parametri

Nome	Tipo	Descrizione
childIndex	Integer	L'indice dell'elemento secondario da recuperare.

Invio

Element: l'elemento secondario nell'indice specificato.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getChildIndex(child)

Recupera l'indice dell'elemento secondario per l'elemento secondario specificato.

Parametri

Nome	Tipo	Descrizione
child	Element	L'elemento secondario per cui recuperare l'indice.

Invio

Integer: l'indice secondario.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getColSpan()

Recupera l'intervallo di colonne, ovvero il numero di colonne di celle di tabella che questa cella occupa. Le celle non unite hanno un intervallo di colonne pari a 1.

Invio

Integer: l'intervallo di colonne o 0 per una cella unita a un'altra cella

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getLinkUrl()

Recupera l'URL del link.

Invio

String: l'URL del link o null se l'elemento contiene più valori per questo attributo

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getNextSibling()

Recupera l'elemento successivo associato all'elemento.

L'elemento successivo ha lo stesso elemento principale e segue l'elemento corrente.

Invio

Element: l'elemento successivo associato.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getNumChildren()

Recupera il numero di bambini.

const 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.`);

Invio

Integer: il numero di bambini.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getPaddingBottom()

Recupera la spaziatura interna inferiore in punti.

Invio

Number: la spaziatura interna inferiore in punti

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getPaddingLeft()

Recupera la spaziatura interna sinistra in punti.

Invio

Number: la spaziatura interna a sinistra, in punti

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getPaddingRight()

Recupera la spaziatura interna destra in punti.

Invio

Number: la spaziatura interna destra in punti

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getPaddingTop()

Recupera la spaziatura interna superiore in punti.

Invio

Number: il padding superiore in punti

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getParent()

Recupera l'elemento principale dell'elemento.

L'elemento principale contiene l'elemento corrente.

Invio

ContainerElement: l'elemento principale.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getParentRow()

Recupera il TableRow contenente il TableCell corrente.

Invio

TableRow: la riga della tabella contenente la cella corrente

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getParentTable()

Recupera il Table contenente il TableCell corrente.

Invio

Table: la tabella contenente la cella corrente

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getPreviousSibling()

Recupera l'elemento precedente associato all'elemento.

L'elemento precedente associato ha lo stesso elemento principale e precede l'elemento corrente.

Invio

Element: l'elemento precedente associato.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getRowSpan()

Recupera l'intervallo di righe, ovvero il numero di righe di celle di tabella che questa cella occupa. Le celle non unite hanno un intervallo di righe pari a 1.

Invio

Integer: l'intervallo di righe o 0 per una cella unita a un'altra cella

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getText()

Recupera i contenuti dell'elemento come stringa di testo.

Invio

String: i contenuti dell'elemento come stringa di testo

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getTextAlignment()

Restituisce l'allineamento del testo. I tipi di allineamento disponibili sono DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT e DocumentApp.TextAlignment.SUPERSCRIPT.

Invio

TextAlignment: il tipo di allineamento del testo oppure null se il testo contiene più tipi di allineamento del testo o se l'allineamento del testo non è mai stato impostato

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getType()

Recupera il ElementType dell'elemento.

Utilizza getType() per determinare il tipo esatto di un determinato elemento.

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

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

const 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.');
}

Invio

ElementType: il tipo di elemento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getVerticalAlignment()

Recupera il VerticalAlignment.

Invio

VerticalAlignment: l'allineamento verticale

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getWidth()

Recupera la larghezza della colonna contenente la cella, in punti.

Invio

Number: la larghezza della colonna, in punti

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertHorizontalRule(childIndex)

Crea e inserisce un nuovo HorizontalRule nell'indice specificato.

La linea orizzontale sarà contenuta in un nuovo Paragraph.

Parametri

Nome	Tipo	Descrizione
childIndex	Integer	l'indice in cui inserire l'elemento

Invio

HorizontalRule: il nuovo righello orizzontale

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertImage(childIndex, image)

Crea e inserisce un InlineImage dal blob immagine specificato nell'indice specificato.

L'immagine sarà contenuta in un nuovo Paragraph.

Parametri

Nome	Tipo	Descrizione
childIndex	Integer	l'indice in cui inserire l'elemento
image	BlobSource	i dati immagine

Invio

InlineImage: l'immagine in linea inserita

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertImage(childIndex, image)

Inserisce il valore InlineImage specificato nell'indice specificato.

L'immagine sarà contenuta in un nuovo Paragraph.

Parametri

Nome	Tipo	Descrizione
childIndex	Integer	l'indice in cui inserire l'elemento
image	InlineImage	l'immagine da inserire

Invio

InlineImage: l'immagine in linea inserita

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertListItem(childIndex, listItem)

Inserisce il valore ListItem specificato nell'indice specificato.

Parametri

Nome	Tipo	Descrizione
childIndex	Integer	l'indice in cui inserire l'elemento
listItem	ListItem	la voce dell'elenco da inserire

Invio

ListItem: nuova voce di elenco inserita

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertListItem(childIndex, text)

Crea e inserisce un nuovo ListItem nell'indice specificato.

Parametri

Nome	Tipo	Descrizione
childIndex	Integer	l'indice in cui inserire l'elemento
text	String	i contenuti del testo

Invio

ListItem: la nuova voce di elenco

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertParagraph(childIndex, paragraph)

Inserisce il valore Paragraph specificato nell'indice specificato.

Parametri

Nome	Tipo	Descrizione
childIndex	Integer	l'indice in cui inserire l'elemento
paragraph	Paragraph	il paragrafo da inserire

Invio

Paragraph: il paragrafo inserito

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertParagraph(childIndex, text)

Crea e inserisce un nuovo Paragraph nell'indice specificato.

Parametri

Nome	Tipo	Descrizione
childIndex	Integer	l'indice in cui inserire l'elemento
text	String	i contenuti del testo

Invio

Paragraph: il nuovo paragrafo

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertTable(childIndex)

Crea e inserisce un nuovo Table nell'indice specificato.

Parametri

Nome	Tipo	Descrizione
childIndex	Integer	l'indice in cui inserire l'elemento

Invio

Table: la nuova tabella

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertTable(childIndex, cells)

Crea e inserisce un nuovo Table contenente le celle specificate nell'indice specificato.

Parametri

Nome	Tipo	Descrizione
childIndex	Integer	l'indice in cui inserire
cells	String[][]	i contenuti di testo delle celle della tabella da aggiungere alla nuova tabella

Invio

Table: la nuova tabella

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertTable(childIndex, table)

Inserisce il valore Table specificato nell'indice specificato.

Parametri

Nome	Tipo	Descrizione
childIndex	Integer	l'indice in cui inserire l'elemento
table	Table	la tabella da inserire

Invio

Table: la tabella inserita

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

isAtDocumentEnd()

Determina se l'elemento è alla fine del Document.

Invio

Boolean: indica se l'elemento si trova alla fine della scheda.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

merge()

Unisce l'elemento all'elemento precedente dello stesso tipo.

È possibile unire solo elementi dello stesso ElementType. Tutti gli elementi secondari contenuti nell'elemento corrente vengono spostati nell'elemento precedente associato.

L'elemento corrente viene rimosso dal documento.

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

// Example 1: Merge paragraphs
// Append two paragraphs to the document's active tab.
const par1 = body.appendParagraph('Paragraph 1.');
const 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.
const cells = [
  ['Row 1, Cell 1', 'Row 1, Cell 2'],
  ['Row 2, Cell 1', 'Row 2, Cell 2'],
];
// Build a table from the array.
const table = body.appendTable(cells);
// Get the first row in the table.
const row = table.getRow(0);
// Get the two cells in this row.
const cell1 = row.getCell(0);
const cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
const merged = cell2.merge();

Invio

TableCell: l'elemento unito.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

removeChild(child)

Rimuove l'elemento figlio specificato.

Parametri

Nome	Tipo	Descrizione
child	Element	l'elemento secondario da rimuovere

Invio

TableCell: l'elemento corrente

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

removeFromParent()

Rimuove l'elemento dal relativo elemento principale.

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

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

Invio

TableCell: l'elemento rimosso.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

replaceText(searchPattern, replacement)

Sostituisce tutte le occorrenze di un determinato pattern di testo con una determinata stringa di sostituzione, utilizzando espressioni regolari.

Il pattern di ricerca viene passato come stringa, non come oggetto espressione regolare JavaScript. Per questo motivo, dovrai eseguire l'escape di eventuali barre rovesciate nello schema.

Questi metodi utilizzano la libreria di espressioni regolari RE2 di Google, che limita la sintassi supportata.

Il pattern di espressione regolare fornito viene abbinato in modo indipendente a ogni blocco di testo contenuto nell'elemento corrente.

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

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

Parametri

Nome	Tipo	Descrizione
searchPattern	String	lo schema regex da cercare
replacement	String	Il testo da utilizzare come sostituto

Invio

Element: l'elemento corrente

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

setAttributes(attributes)

Imposta gli attributi dell'elemento.

Il parametro degli attributi specificato deve essere un oggetto in cui ogni nome della proprietà è un elemento dell'enumerazione DocumentApp.Attribute e ogni valore della proprietà è il nuovo valore da applicare.

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

// Define a custom paragraph style.
const 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.
const par = body.appendParagraph('A paragraph with custom style.');

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

Parametri

Nome	Tipo	Descrizione
attributes	Object	Gli attributi dell'elemento.

Invio

TableCell: l'elemento corrente.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

setBackgroundColor(color)

Imposta il colore di sfondo.

Parametri

Nome	Tipo	Descrizione
color	String	il colore di sfondo, formattato in notazione CSS (ad es. '#ffffff')

Invio

TableCell: l'elemento corrente

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

setLinkUrl(url)

Imposta l'URL del link.

Parametri

Nome	Tipo	Descrizione
url	String	l'URL del link

Invio

TableCell: l'elemento corrente

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

setPaddingBottom(paddingBottom)

Imposta la spaziatura interna inferiore in punti.

Parametri

Nome	Tipo	Descrizione
paddingBottom	Number	la spaziatura interna inferiore, in punti

Invio

TableCell: l'elemento corrente

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

setPaddingLeft(paddingLeft)

Imposta la spaziatura interna sinistra in punti.

Parametri

Nome	Tipo	Descrizione
paddingLeft	Number	la spaziatura interna sinistra, in punti

Invio

TableCell: l'elemento corrente

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

setPaddingRight(paddingRight)

Imposta la spaziatura interna destra in punti.

Parametri

Nome	Tipo	Descrizione
paddingRight	Number	La spaziatura interna destra, in punti.

Invio

TableCell: l'elemento corrente.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

setPaddingTop(paddingTop)

Imposta la spaziatura interna superiore in punti.

Parametri

Nome	Tipo	Descrizione
paddingTop	Number	il padding superiore, in punti

Invio

TableCell: l'elemento corrente

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

setText(text)

Imposta i contenuti come testo normale.

Nota: i contenuti esistenti vengono cancellati.

Parametri

Nome	Tipo	Descrizione
text	String	i nuovi contenuti del testo

Invio

TableCell: l'elemento corrente

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

setTextAlignment(textAlignment)

Imposta l'allineamento del testo. I tipi di allineamento disponibili sono DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT e DocumentApp.TextAlignment.SUPERSCRIPT.

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

Parametri

Nome	Tipo	Descrizione
textAlignment	TextAlignment	il tipo di allineamento del testo da applicare

Invio

TableCell: l'elemento corrente

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

setVerticalAlignment(alignment)

Imposta l'allineamento verticale.

Parametri

Nome	Tipo	Descrizione
alignment	VerticalAlignment	l'allineamento verticale

Invio

TableCell: l'elemento corrente

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

setWidth(width)

Imposta la larghezza della colonna contenente la cella corrente in punti.

Parametri

Nome	Tipo	Descrizione
width	Number	la larghezza della colonna, in punti

Invio

TableCell: l'elemento corrente

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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