Questa pagina è stata tradotta dall'API Cloud Translation.

Class TableCell

Un elemento che rappresenta una cella di tabella. Un elemento TableCell è sempre contenuto all'interno di un elemento TableRow e può contenere elementi ListItem, Paragraph o Table. Per ulteriori informazioni sulla struttura dei documenti, 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 di immagine specificato.
`appendImage(image)`	`InlineImage`	Accoda il valore `InlineImage` specificato.
`appendListItem(listItem)`	`ListItem`	Accoda il valore `ListItem` specificato.
`appendListItem(text)`	`ListItem`	Crea e aggiunge un nuovo `ListItem`.
`appendParagraph(paragraph)`	`Paragraph`	Accoda il valore `Paragraph` specificato.
`appendParagraph(text)`	`Paragraph`	Crea e aggiunge un nuovo `Paragraph`.
`appendTable()`	`Table`	Crea e aggiunge un nuovo `Table`.
`appendTable(cells)`	`Table`	Accoda un nuovo valore `Table` contenente le celle specificate.
`appendTable(table)`	`Table`	Accoda il valore `Table` specificato.
`clear()`	`TableCell`	Consente di cancellare i contenuti dell'elemento.
`copy()`	`TableCell`	Restituisce una copia separata e approfondita dell'elemento corrente.
`editAsText()`	`Text`	Consente di ottenere una versione `Text` dell'elemento corrente, per la modifica.
`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 valore `RangeElement` specificato.
`findText(searchPattern)`	`RangeElement`	Cerca nei contenuti dell'elemento il pattern di testo specificato utilizzando espressioni regolari.
`findText(searchPattern, from)`	`RangeElement`	Cerca nei contenuti dell'elemento il pattern di testo specificato, 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 secondario nell'indice figlio specificato.
`getChildIndex(child)`	`Integer`	Recupera l'indice figlio per l'elemento secondario specificato.
`getColSpan()`	`Integer`	Recupera l'intervallo di colonne, ovvero il numero di colonne di celle di una tabella distribuite da questa cella.
`getLinkUrl()`	`String`	Recupera l'URL del link.
`getNextSibling()`	`Element`	Recupera l'elemento di pari livello successivo dell'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 corretta, in punti.
`getPaddingTop()`	`Number`	Recupera la spaziatura interna superiore, in punti.
`getParent()`	`ContainerElement`	Recupera l'elemento principale dell'elemento.
`getParentRow()`	`TableRow`	Recupera l'elemento `TableRow` contenente l'elemento `TableCell` corrente.
`getParentTable()`	`Table`	Recupera l'elemento `Table` contenente l'elemento `TableCell` corrente.
`getPreviousSibling()`	`Element`	Recupera l'elemento di pari livello precedente dell'elemento.
`getRowSpan()`	`Integer`	Recupera l'intervallo di righe, ovvero il numero di righe di celle di una tabella distribuite da questa cella.
`getText()`	`String`	Recupera i contenuti dell'elemento come stringa di testo.
`getTextAlignment()`	`TextAlignment`	Consente di acquisire l'allineamento del testo.
`getType()`	`ElementType`	Recupera l'elemento `ElementType` dell'elemento.
`getVerticalAlignment()`	`VerticalAlignment`	Recupera il file `VerticalAlignment`.
`getWidth()`	`Number`	Recupera la larghezza in punti della colonna contenente la cella.
`insertHorizontalRule(childIndex)`	`HorizontalRule`	Crea e inserisce un nuovo valore `HorizontalRule` nell'indice specificato.
`insertImage(childIndex, image)`	`InlineImage`	Crea e inserisce un `InlineImage` dal blob di 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 valore `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 valore `Paragraph` nell'indice specificato.
`insertTable(childIndex)`	`Table`	Crea e inserisce un nuovo valore `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 si trova alla fine di `Document`.
`merge()`	`TableCell`	Unisce l'elemento con l'elemento di pari livello precedente dello stesso tipo.
`removeChild(child)`	`TableCell`	Rimuove l'elemento secondario 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 sostitutiva, utilizzando le espressioni regolari.
`setAttributes(attributes)`	`TableCell`	Imposta gli attributi dell'elemento.
`setBackgroundColor(color)`	`TableCell`	Imposta il colore dello 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 corretta, 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 in punti della colonna contenente la cella corrente.

Documentazione dettagliata

`appendHorizontalRule()`

Crea e aggiunge un nuovo HorizontalRule.

Il HorizontalRule verrà contenuto in un nuovo Paragraph.

Ritorni

HorizontalRule: la nuova riga 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 di immagine specificato.

Il InlineImage verrà contenuto in un nuovo Paragraph.

Parametri

Nome	Tipo	Descrizione
`image`	`BlobSource`	i dati dell'immagine

Ritorni

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)`

Accoda il valore InlineImage specificato.

Il InlineImage verrà contenuto in un nuovo Paragraph.

Parametri

Nome	Tipo	Descrizione
`image`	`InlineImage`	i dati dell'immagine

Ritorni

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)`

Accoda il valore ListItem specificato.

Parametri

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

Ritorni

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 testuali

Ritorni

ListItem: la nuova voce dell'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)`

Accoda il valore Paragraph specificato.

Parametri

Nome	Tipo	Descrizione
`paragraph`	`Paragraph`	il paragrafo da aggiungere

Ritorni

Paragraph: 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 testuali

Ritorni

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.

Ritorni

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)`

Accoda un nuovo valore Table contenente le celle specificate.

Parametri

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

Ritorni

Table: 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)`

Accoda il valore Table specificato.

Parametri

Nome	Tipo	Descrizione
`table`	`Table`	la tabella da aggiungere

Ritorni

Table: 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()`

Consente di cancellare i contenuti dell'elemento.

Ritorni

TableCell: l'elemento corrente

`copy()`

Restituisce una copia separata e approfondita dell'elemento corrente.

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

Ritorni

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, per la modifica.

Utilizza editAsText per manipolare i contenuti degli elementi in formato RTF. La modalità editAsText ignora gli elementi non testuali (come InlineImage e HorizontalRule).

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

var body = DocumentApp.getActiveDocument().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);

Ritorni

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

Ritorni

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 valore RangeElement specificato.

// Get the body section of the active document.
var body = DocumentApp.getActiveDocument().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;
  }
}

Parametri

Nome	Tipo	Descrizione
`elementType`	`ElementType`	il tipo di elemento da cercare
`from`	`RangeElement`	il risultato di ricerca da cui eseguire la ricerca

Ritorni

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 espressioni regolari.

Un sottoinsieme delle funzionalità di espressione regolare JavaScript non è completamente supportato, ad esempio gruppi di acquisizione e modificatori di modalità.

Il modello di espressione regolare fornito viene confrontato in modo indipendente con ciascun blocco di testo contenuto nell'elemento corrente.

Parametri

Nome	Tipo	Descrizione
`searchPattern`	`String`	lo schema da cercare

Ritorni

RangeElement: un risultato di ricerca che indica la posizione del testo di ricerca o un valore nullo in assenza di 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 nei contenuti dell'elemento il pattern di testo specificato, a partire da un determinato risultato di ricerca.

Un sottoinsieme delle funzionalità di espressione regolare JavaScript non è completamente supportato, ad esempio gruppi di acquisizione e modificatori di modalità.

Il modello di espressione regolare fornito viene confrontato in modo indipendente con ciascun 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 eseguire la ricerca

Ritorni

RangeElement: un risultato di ricerca che indica la posizione successiva del testo di ricerca o un valore nullo in assenza di 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 valido dell'elemento in cui ogni nome della proprietà corrisponde a un elemento nell'enumerazione DocumentApp.Attribute.

var body = DocumentApp.getActiveDocument().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]);
}

Ritorni

Object: 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.

Ritorni

String: il colore di sfondo, formattato in notazione CSS (ad esempio '#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 secondario nell'indice figlio specificato.

// Get the body section of the active document.
var body = DocumentApp.getActiveDocument().getBody();

// Obtain the first element in the document.
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.");
}

Parametri

Nome	Tipo	Descrizione
`childIndex`	`Integer`	l'indice dell'elemento figlio da recuperare

Ritorni

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 figlio per l'elemento secondario specificato.

Parametri

Nome	Tipo	Descrizione
`child`	`Element`	l'elemento figlio per il quale recuperare l'indice

Ritorni

Integer: l'indice figlio

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 una tabella distribuite da questa cella. Le celle non unite hanno un intervallo col di 1.

Ritorni

Integer: l'intervallo di colonna o 0 per una cella unita da 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.

Ritorni

String: URL del link oppure 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 di pari livello successivo dell'elemento.

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

Ritorni

Element: l'elemento di pari livello successivo.

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.

// Get the body section of the active document.
var body = DocumentApp.getActiveDocument().getBody();

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

Ritorni

Integer: il numero di figli

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.

Ritorni

Number: 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.

Ritorni

Number: spaziatura interna 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 corretta, in punti.

Ritorni

Number: spaziatura interna corretta, 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.

Ritorni

Number: spaziatura interna 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.

Ritorni

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 l'elemento TableRow contenente l'elemento TableCell corrente.

Ritorni

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 l'elemento Table contenente l'elemento TableCell corrente.

Ritorni

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 di pari livello precedente dell'elemento.

L'elemento di pari livello precedente ha lo stesso elemento principale e precede l'elemento corrente.

Ritorni

Element: l'elemento di pari livello precedente.

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 una tabella distribuite da questa cella. Le celle non unite hanno un intervallo di righe pari a 1.

Ritorni

Integer: l'intervallo di riga o 0 per una cella unita da 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.

Ritorni

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

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

Ritorni

TextAlignment: il tipo di allineamento del testo oppure null se il testo contiene più tipi di allineamenti 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 l'elemento ElementType dell'elemento.

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

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

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

Ritorni

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 file VerticalAlignment.

Ritorni

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 in punti della colonna contenente la cella.

Ritorni

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 valore HorizontalRule nell'indice specificato.

La regola orizzontale verrà contenuta in un nuovo Paragraph.

Parametri

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

Ritorni

HorizontalRule: la nuova riga 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 di immagine specificato, nell'indice specificato.

L'immagine verrà contenuta in un nuovo file Paragraph.

Parametri

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

Ritorni

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 verrà contenuta in un nuovo file Paragraph.

Parametri

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

Ritorni

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`	l'elemento dell'elenco da inserire

Ritorni

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 valore ListItem nell'indice specificato.

Parametri

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

Ritorni

ListItem: la nuova voce dell'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

Ritorni

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 valore Paragraph nell'indice specificato.

Parametri

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

Ritorni

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 valore Table nell'indice specificato.

Parametri

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

Ritorni

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 testuali delle celle della tabella da aggiungere alla nuova tabella

Ritorni

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

Ritorni

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 si trova alla fine di Document.

Ritorni

Boolean: indica se l'elemento si trova alla fine del documento.

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 con l'elemento di pari livello precedente dello stesso tipo.

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

L'elemento corrente viene rimosso dal documento.

var body = DocumentApp.getActiveDocument().getBody();
// Example 1: Merge paragraphs
// Append two paragraphs to the document.
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();

Ritorni

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 secondario specificato.

Parametri

Nome	Tipo	Descrizione
`child`	`Element`	l'elemento secondario da rimuovere

Ritorni

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.

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

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

Ritorni

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 sostitutiva, utilizzando le espressioni regolari.

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

Questo metodo utilizza la libreria di espressioni regolari RE2 di Google, che limita la sintassi supportata.

Il modello di espressione regolare fornito viene confrontato in modo indipendente con ciascun blocco di testo contenuto nell'elemento corrente.

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

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

Parametri

Nome	Tipo	Descrizione
`searchPattern`	`String`	il pattern regex per cercare
`replacement`	`String`	il testo da utilizzare come sostituzione

Ritorni

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 proprietà è un elemento nell'enumerazione DocumentApp.Attribute e ogni valore di proprietà è il nuovo valore da applicare.

var body = DocumentApp.getActiveDocument().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);

Parametri

Nome	Tipo	Descrizione
`attributes`	`Object`	Gli attributi dell'elemento.

Ritorni

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 dello sfondo.

Parametri

Nome	Tipo	Descrizione
`color`	`String`	Il colore di sfondo, formattato in notazione CSS (come `'#ffffff'`)

Ritorni

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`	URL del link

Ritorni

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`	spaziatura interna inferiore, in punti

Ritorni

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

Ritorni

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 corretta, in punti.

Parametri

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

Ritorni

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`	spaziatura interna superiore, in punti

Ritorni

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 testuali

Ritorni

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 be superscript.
var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);

Parametri

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

Ritorni

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

Ritorni

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 in punti della colonna contenente la cella corrente.

Parametri

Nome	Tipo	Descrizione
`width`	`Number`	La larghezza della colonna, in punti

Ritorni

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