Un elemento che rappresenta una cella della tabella. Un elemento Table è sempre contenuto in un elemento Table e può contenere elementi List, Paragraph o Table. Per
ulteriori informazioni sulla struttura del documento, consulta la guida all'estensione di Google Docs.
Metodi
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
append | Horizontal | Crea e aggiunge un nuovo Horizontal. |
append | Inline | Crea e aggiunge un nuovo Inline dal blob dell'immagine specificato. |
append | Inline | Aggiunge l'elemento Inline specificato. |
append | List | Aggiunge l'elemento List specificato. |
append | List | Crea e aggiunge un nuovo List. |
append | Paragraph | Aggiunge l'elemento Paragraph specificato. |
append | Paragraph | Crea e aggiunge un nuovo Paragraph. |
append | Table | Crea e aggiunge un nuovo Table. |
append | Table | Aggiunge un nuovo Table contenente le celle specificate. |
append | Table | Aggiunge l'elemento Table specificato. |
clear() | Table | Cancella i contenuti dell'elemento. |
copy() | Table | Restituisce una copia indipendente e completa dell'elemento corrente. |
edit | Text | Ottiene una versione Text dell'elemento corrente per la modifica. |
find | Range | Cerca nei contenuti dell'elemento un discendente del tipo specificato. |
find | Range | Cerca nei contenuti dell'elemento un discendente del tipo specificato, a partire dal
Range specificato. |
find | Range | Cerca nei contenuti dell'elemento il pattern di testo specificato utilizzando le espressioni regolari. |
find | Range | Cerca nel contenuto dell'elemento il pattern di testo specificato, a partire da un determinato risultato di ricerca. |
get | Object | Recupera gli attributi dell'elemento. |
get | String|null | Recupera il colore di sfondo. |
get | Element | Recupera l'elemento secondario all'indice secondario specificato. |
get | Integer | Recupera l'indice figlio per l'elemento figlio specificato. |
get | Integer | Recupera l'intervallo di colonne, ovvero il numero di colonne delle celle della tabella a cui si estende questa cella. |
get | String|null | Recupera l'URL del link. |
get | Element|null | Recupera l'elemento successivo associato all'elemento. |
get | Integer | Recupera il numero di figli. |
get | Number|null | Recupera la spaziatura interna inferiore, in punti. |
get | Number|null | Recupera la spaziatura interna sinistra, in punti. |
get | Number|null | Recupera la spaziatura interna destra, in punti. |
get | Number|null | Recupera la spaziatura interna superiore, in punti. |
get | Container | Recupera l'elemento principale dell'elemento. |
get | Table | Recupera il Table contenente l'Table corrente. |
get | Table|null | Recupera il Table contenente l'Table corrente. |
get | Element|null | Recupera l'elemento precedente associato all'elemento. |
get | Integer | Recupera l'intervallo di righe, ovvero il numero di righe delle celle della tabella che questa cella occupa. |
get | String | Recupera i contenuti dell'elemento come stringa di testo. |
get | Text | Ottiene l'allineamento del testo. |
get | Element | Recupera Element dell'elemento. |
get | Vertical | Recupera Vertical. |
get | Number|null | Recupera la larghezza della colonna contenente la cella, in punti. |
insert | Horizontal | Crea e inserisce un nuovo Horizontal all'indice specificato. |
insert | Inline | Crea e inserisce un Inline dal blob dell'immagine specificato, all'indice specificato. |
insert | Inline | Inserisce il Inline specificato all'indice indicato. |
insert | List | Inserisce il List specificato all'indice indicato. |
insert | List | Crea e inserisce un nuovo List all'indice specificato. |
insert | Paragraph | Inserisce il Paragraph specificato all'indice indicato. |
insert | Paragraph | Crea e inserisce un nuovo Paragraph all'indice specificato. |
insert | Table | Crea e inserisce un nuovo Table all'indice specificato. |
insert | Table | Crea e inserisce un nuovo Table contenente le celle specificate, all'indice specificato. |
insert | Table | Inserisce il Table specificato all'indice indicato. |
is | Boolean | Determina se l'elemento si trova alla fine di Document. |
merge() | Table | Unisce l'elemento al fratello precedente dello stesso tipo. |
remove | Table | Rimuove l'elemento figlio specificato. |
remove | Table | Rimuove l'elemento dal relativo elemento principale. |
replace | Element | Sostituisce tutte le occorrenze di un determinato pattern di testo con una determinata stringa di sostituzione, utilizzando espressioni regolari. |
set | Table | Imposta gli attributi dell'elemento. |
set | Table | Imposta il colore di sfondo. |
set | Table | Imposta l'URL del link. |
set | Table | Imposta la spaziatura interna inferiore, in punti. |
set | Table | Imposta la spaziatura interna sinistra, in punti. |
set | Table | Imposta la spaziatura interna destra, in punti. |
set | Table | Imposta la spaziatura interna superiore, in punti. |
set | Table | Imposta i contenuti come testo normale. |
set | Table | Imposta l'allineamento del testo. |
set | Table | Imposta l'allineamento verticale. |
set | Table | Imposta la larghezza della colonna contenente la cella corrente, in punti. |
Documentazione dettagliata
append Horizontal Rule()
Crea e aggiunge un nuovo Horizontal.
Il Horizontal sarà contenuto in un nuovo Paragraph.
Indietro
Horizontal: la nuova regola 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
append Image(image)
Crea e aggiunge un nuovo Inline dal blob dell'immagine specificato.
Il Inline sarà contenuto in un nuovo Paragraph.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
image | Blob | i dati dell'immagine |
Indietro
Inline: 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
append Image(image)
Aggiunge l'elemento Inline specificato.
Il Inline sarà contenuto in un nuovo Paragraph.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
image | Inline | i dati dell'immagine |
Indietro
Inline: 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
append List Item(listItem)
Aggiunge l'elemento List specificato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
list | List | la voce di elenco da aggiungere |
Indietro
List: la voce di 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
append List Item(text)
Crea e aggiunge un nuovo List.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
text | String | i contenuti testuali |
Indietro
List: 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
append Paragraph(paragraph)
Aggiunge l'elemento Paragraph specificato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
paragraph | Paragraph | il paragrafo da aggiungere |
Indietro
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
append Paragraph(text)
Crea e aggiunge un nuovo Paragraph.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
text | String | i contenuti testuali |
Indietro
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
append Table()
append Table(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 |
Indietro
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
append Table(table)
Aggiunge l'elemento Table specificato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
table | Table | la tabella da aggiungere |
Indietro
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()
copy()
Restituisce una copia indipendente e completa dell'elemento corrente.
Vengono copiati anche gli eventuali elementi secondari presenti nell'elemento. Il nuovo elemento non ha un elemento principale.
Indietro
Table: 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
edit As Text()
Ottiene una versione Text dell'elemento corrente per la modifica.
Utilizza edit per manipolare i contenuti degli elementi come testo RTF. La modalità edit ignora gli elementi non di testo (come Inline e Horizontal).
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);
Indietro
Text: una versione di testo dell'elemento corrente
find Element(elementType)
Cerca nei contenuti dell'elemento un discendente del tipo specificato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
element | Element | Il tipo di elemento da cercare. |
Indietro
Range: 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
find Element(elementType, from)
Cerca nei contenuti dell'elemento un discendente del tipo specificato, a partire dal
Range 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 |
|---|---|---|
element | Element | Il tipo di elemento da cercare. |
from | Range | Il risultato di ricerca da cui effettuare la ricerca. |
Indietro
Range: 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
find Text(searchPattern)
Cerca nei contenuti dell'elemento il pattern di testo specificato utilizzando le espressioni regolari.
Un sottoinsieme delle funzionalità delle espressioni regolari JavaScript non è completamente supportato, ad esempio gruppi di acquisizione e modificatori di modalità.
Il pattern di espressione regolare fornito viene confrontato in modo indipendente con ogni blocco di testo contenuto nell'elemento corrente.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
search | String | il pattern da cercare |
Indietro
Range: un risultato di ricerca che indica la posizione del testo di ricerca o null se non
corrisponde
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
find Text(searchPattern, from)
Cerca nel contenuto dell'elemento il pattern di testo specificato, a partire da un determinato risultato di ricerca.
Un sottoinsieme delle funzionalità delle espressioni regolari JavaScript non è completamente supportato, ad esempio gruppi di acquisizione e modificatori di modalità.
Il pattern di espressione regolare fornito viene confrontato in modo indipendente con ogni blocco di testo contenuto nell'elemento corrente.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
search | String | il pattern da cercare |
from | Range | il risultato di ricerca da cui effettuare la ricerca |
Indietro
Range: un risultato di ricerca che indica la posizione successiva del testo di ricerca o null se non è presente
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
get Attributes()
Recupera gli attributi dell'elemento.
Il risultato è un oggetto contenente una proprietà per ogni attributo dell'elemento valido, in cui ogni nome di proprietà corrisponde a un elemento dell'enumerazione Document.
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]}`); }
Indietro
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
get Background Color()
Recupera il colore di sfondo.
Indietro
String|null: il colore di sfondo, formattato nella 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
get Child(childIndex)
Recupera l'elemento secondario all'indice secondario 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 |
|---|---|---|
child | Integer | L'indice dell'elemento secondario da recuperare. |
Indietro
Element: l'elemento secondario all'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
get Child Index(child)
Recupera l'indice figlio per l'elemento figlio specificato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
child | Element | L'elemento secondario per cui recuperare l'indice. |
Indietro
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
get Col Span()
Recupera l'intervallo di colonne, ovvero il numero di colonne delle celle della tabella a cui si estende questa cella. Le celle non unite hanno un valore di col span pari a 1.
Indietro
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
get Link Url()
Recupera l'URL del link.
Indietro
String|null: 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
get Next Sibling()
Recupera l'elemento successivo associato all'elemento.
L'elemento successivo ha lo stesso elemento principale e segue l'elemento corrente.
Indietro
Element|null: l'elemento associato 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
get Num Children()
Recupera il numero di figli.
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.`);
Indietro
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
get Padding Bottom()
Recupera la spaziatura interna inferiore, in punti.
Indietro
Number|null: 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
get Padding Left()
Recupera la spaziatura interna sinistra, in punti.
Indietro
Number|null: la 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
get Padding Right()
Recupera la spaziatura interna destra, in punti.
Indietro
Number|null: 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
get Padding Top()
Recupera la spaziatura interna superiore, in punti.
Indietro
Number|null: la 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
get Parent()
Recupera l'elemento principale dell'elemento.
L'elemento principale contiene l'elemento corrente.
Indietro
Container: 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
get Parent Row()
Recupera il Table contenente l'Table corrente.
Indietro
Table: 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
get Parent Table()
Recupera il Table contenente l'Table corrente.
Indietro
Table|null: 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
get Previous Sibling()
Recupera l'elemento precedente associato all'elemento.
L'elemento associato precedente ha lo stesso elemento principale e precede l'elemento corrente.
Indietro
Element|null: l'elemento associato 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
get Row Span()
Recupera l'intervallo di righe, ovvero il numero di righe delle celle della tabella che questa cella occupa. Le celle non unite hanno un'estensione di riga pari a 1.
Indietro
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
get Text()
Recupera i contenuti dell'elemento come stringa di testo.
Indietro
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
get Text Alignment()
Ottiene l'allineamento del testo. I tipi di allineamento disponibili sono Document, Document e Document.
Indietro
Text: il tipo di allineamento del testo o 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
get Type()
Recupera Element dell'elemento.
Utilizza get 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.'); }
Indietro
Element: 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
get Vertical Alignment()
Recupera Vertical.
Indietro
Vertical: 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
get Width()
Recupera la larghezza della colonna contenente la cella, in punti.
Indietro
Number|null: 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
insert Horizontal Rule(childIndex)
Crea e inserisce un nuovo Horizontal all'indice specificato.
La regola orizzontale sarà contenuta in un nuovo Paragraph.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
child | Integer | l'indice in cui inserire l'elemento |
Indietro
Horizontal: la nuova regola 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
insert Image(childIndex, image)
Crea e inserisce un Inline dal blob dell'immagine specificato, all'indice specificato.
L'immagine sarà contenuta in un nuovo Paragraph.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
child | Integer | l'indice in cui inserire l'elemento |
image | Blob | i dati dell'immagine |
Indietro
Inline: 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
insert Image(childIndex, image)
Inserisce il Inline specificato all'indice indicato.
L'immagine sarà contenuta in un nuovo Paragraph.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
child | Integer | l'indice in cui inserire l'elemento |
image | Inline | l'immagine da inserire |
Indietro
Inline: 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
insert List Item(childIndex, listItem)
Inserisce il List specificato all'indice indicato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
child | Integer | l'indice in cui inserire l'elemento |
list | List | la voce di elenco da inserire |
Indietro
List: è stata inserita una 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
insert List Item(childIndex, text)
Crea e inserisce un nuovo List all'indice specificato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
child | Integer | l'indice in cui inserire l'elemento |
text | String | i contenuti testuali |
Indietro
List: 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
insert Paragraph(childIndex, paragraph)
Inserisce il Paragraph specificato all'indice indicato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
child | Integer | l'indice in cui inserire l'elemento |
paragraph | Paragraph | il paragrafo da inserire |
Indietro
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
insert Paragraph(childIndex, text)
Crea e inserisce un nuovo Paragraph all'indice specificato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
child | Integer | l'indice in cui inserire l'elemento |
text | String | i contenuti testuali |
Indietro
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
insert Table(childIndex)
Crea e inserisce un nuovo Table all'indice specificato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
child | Integer | l'indice in cui inserire l'elemento |
Indietro
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
insert Table(childIndex, cells)
Crea e inserisce un nuovo Table contenente le celle specificate, all'indice specificato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
child | Integer | l'indice in cui inserire |
cells | String[][] | i contenuti di testo delle celle della tabella da aggiungere alla nuova tabella |
Indietro
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
insert Table(childIndex, table)
Inserisce il Table specificato all'indice indicato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
child | Integer | l'indice in cui inserire l'elemento |
table | Table | la tabella da inserire |
Indietro
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
is At Document End()
Determina se l'elemento si trova alla fine di Document.
Indietro
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 al fratello precedente dello stesso tipo.
È possibile unire solo elementi dello stesso Element. Tutti gli elementi secondari contenuti
nell'elemento corrente vengono spostati nell'elemento precedente.
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();
Indietro
Table: 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
remove Child(child)
Rimuove l'elemento figlio specificato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
child | Element | l'elemento secondario da rimuovere |
Indietro
Table: 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
remove From Parent()
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(); }
Indietro
Table: 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
replace Text(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 tutte le barre rovesciate nel pattern.
Questi metodi utilizzano la libreria di espressioni regolari RE2 di Google, che limita la sintassi supportata.
Il pattern di espressione regolare fornito viene confrontato in modo indipendente con 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 |
|---|---|---|
search | String | il pattern dell'espressione regolare da cercare |
replacement | String | il testo da utilizzare come sostituzione |
Indietro
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
set Attributes(attributes)
Imposta gli attributi dell'elemento.
Il parametro degli attributi specificato deve essere un oggetto in cui ogni nome di proprietà è un elemento dell'enumerazione Document e ogni valore di 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. |
Indietro
Table: 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
set Background Color(color)
Imposta il colore di sfondo.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
color | String | il colore di sfondo, formattato nella notazione CSS (ad esempio '#ffffff') |
Indietro
Table: 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
set Link Url(url)
Imposta l'URL del link.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
url | String | l'URL del link |
Indietro
Table: 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
set Padding Bottom(paddingBottom)
Imposta la spaziatura interna inferiore, in punti.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
padding | Number | la spaziatura interna inferiore, in punti |
Indietro
Table: 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
set Padding Left(paddingLeft)
Imposta la spaziatura interna sinistra, in punti.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
padding | Number | la spaziatura interna sinistra, in punti |
Indietro
Table: 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
set Padding Right(paddingRight)
Imposta la spaziatura interna destra, in punti.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
padding | Number | La spaziatura interna destra, in punti. |
Indietro
Table: 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
set Padding Top(paddingTop)
Imposta la spaziatura interna superiore, in punti.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
padding | Number | la spaziatura interna superiore, in punti |
Indietro
Table: 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
set Text(text)
Imposta i contenuti come testo normale.
Nota: i contenuti esistenti vengono cancellati.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
text | String | i nuovi contenuti di testo |
Indietro
Table: 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
set Text Alignment(textAlignment)
Imposta l'allineamento del testo. I tipi di allineamento disponibili sono Document, Document e Document.
// 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 |
|---|---|---|
text | Text | il tipo di allineamento del testo da applicare |
Indietro
Table: 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
set Vertical Alignment(alignment)
Imposta l'allineamento verticale.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
alignment | Vertical | l'allineamento verticale |
Indietro
Table: 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
set Width(width)
Imposta la larghezza della colonna contenente la cella corrente, in punti.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
width | Number | la larghezza della colonna, in punti |
Indietro
Table: 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