Un elemento che rappresenta un paragrafo. Un Paragraph può contenere gli elementi Equation, Footnote, Horizontal, Inline, Inline, Page
e Text. Per saperne di più sulla struttura dei documenti, consulta la guida all'estensione di Google Docs.
Paragraphs non può contenere caratteri di nuova riga. I caratteri di nuova riga ("\n") vengono
convertiti in caratteri di interruzione di riga ("\r").
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Append a tab header paragraph. const header = body.appendParagraph('A Document'); header.setHeading(DocumentApp.ParagraphHeading.HEADING1); // Append a section header paragraph. const section = body.appendParagraph('Section 1'); section.setHeading(DocumentApp.ParagraphHeading.HEADING2); // Append a regular paragraph. body.appendParagraph('This is a typical paragraph.');
Metodi
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
add | Positioned | Crea e inserisce un nuovo Positioned dal blob dell'immagine specificato. |
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 | Page | Crea e aggiunge un nuovo Page. |
append | Page | Aggiunge l'elemento Page specificato. |
append | Text | Crea e aggiunge un nuovo elemento Text con i contenuti specificati. |
append | Text | Aggiunge l'elemento Text specificato. |
clear() | Paragraph | Cancella i contenuti dell'elemento. |
copy() | Paragraph | 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 | Horizontal | Recupera Horizontal. |
get | Object | Recupera gli attributi dell'elemento. |
get | Element | Recupera l'elemento secondario all'indice secondario specificato. |
get | Integer | Recupera l'indice figlio per l'elemento figlio specificato. |
get | Paragraph | Recupera Paragraph. |
get | Number|null | Recupera il rientro finale, in punti. |
get | Number|null | Recupera il rientro della prima riga, in punti. |
get | Number|null | Recupera il rientro iniziale. |
get | Number|null | Recupera l'interlinea, in punti. |
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 | Container | Recupera l'elemento principale dell'elemento. |
get | Positioned | Recupera un Positioned in base all'ID dell'immagine. |
get | Positioned | Recupera tutti gli oggetti Positioned ancorati al paragrafo. |
get | Element|null | Recupera l'elemento precedente associato all'elemento. |
get | Number|null | Recupera la spaziatura dopo l'elemento, in punti. |
get | Number|null | Recupera la spaziatura prima dell'elemento, in punti. |
get | String | Recupera i contenuti dell'elemento come stringa di testo. |
get | Text | Ottiene l'allineamento del testo. |
get | Element | Recupera Element dell'elemento. |
insert | Horizontal | Crea e inserisce un Horizontal nell'indice specificato. |
insert | Inline | Crea e inserisce un nuovo Inline dal blob immagine specificato, all'indice specificato. |
insert | Inline | Inserisce il Inline specificato all'indice indicato. |
insert | Page | Crea e inserisce un nuovo Page all'indice specificato. |
insert | Page | Inserisce il Page specificato all'indice indicato. |
insert | Text | Crea e inserisce un nuovo elemento di testo nell'indice specificato. |
insert | Text | Inserisce l'elemento Text specificato nell'indice specificato, con i contenuti di testo specificati. |
is | Boolean | Determina se l'elemento si trova alla fine di Document. |
is | Boolean|null | Recupera l'impostazione da sinistra a destra. |
merge() | Paragraph|null | Unisce l'elemento al fratello precedente dello stesso tipo. |
remove | Paragraph | Rimuove l'elemento figlio specificato. |
remove | Paragraph|null | Rimuove l'elemento dal relativo elemento principale. |
remove | Boolean | Rimuove un Positioned in base all'ID dell'immagine. |
replace | Element | Sostituisce tutte le occorrenze di un determinato pattern di testo con una determinata stringa di sostituzione, utilizzando espressioni regolari. |
set | Paragraph | Imposta Horizontal. |
set | Paragraph | Imposta gli attributi dell'elemento. |
set | Paragraph | Imposta Paragraph. |
set | Paragraph | Imposta il rientro finale, in punti. |
set | Paragraph | Imposta il rientro della prima riga, in punti. |
set | Paragraph | Imposta il rientro iniziale, in punti. |
set | Paragraph | Imposta l'impostazione da sinistra a destra. |
set | Paragraph | Imposta l'interlinea come quantità che indica il numero di righe da utilizzare per la spaziatura. |
set | Paragraph | Imposta l'URL del link. |
set | Paragraph | Imposta la spaziatura dopo l'elemento, in punti. |
set | Paragraph | Imposta la spaziatura prima dell'elemento, in punti. |
set | void | Imposta i contenuti del paragrafo come testo. |
set | Paragraph | Imposta l'allineamento del testo. |
Documentazione dettagliata
add Positioned Image(image)
Crea e inserisce un nuovo Positioned dal blob dell'immagine specificato.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Fetches the specified image URL. const image = UrlFetchApp.fetch( 'https://fonts.gstatic.com/s/i/productlogos/apps_script/v10/web-24dp/logo_apps_script_color_1x_web_24dp.png', ); // Adds the image to the tab, anchored to the first paragraph. paragraph.addPositionedImage(image);
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
image | Blob | I dati immagine. |
Indietro
Positioned: la nuova immagine posizionata.
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 Horizontal Rule()
Crea e aggiunge un nuovo Horizontal.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Adds a horizontal line under the first paragraph. paragraph.appendHorizontalRule();
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 Inline Image(image)
Crea e aggiunge un nuovo Inline dal blob dell'immagine specificato.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Fetches the image from the specified image URL. const image = UrlFetchApp.fetch( 'https://fonts.gstatic.com/s/i/productlogos/apps_script/v10/web-96dp/logo_apps_script_color_1x_web_96dp.png', ); // Adds the image to the first paragraph. paragraph.appendInlineImage(image);
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
image | Blob | I dati 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 Inline Image(image)
Aggiunge l'elemento Inline specificato.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Makes a copy of the first image in the body. const image = body.getImages()[0].copy(); // Adds the image to the first paragraph. paragraph.appendInlineImage(image);
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
image | Inline | I dati 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 Page Break()
Crea e aggiunge un nuovo Page.
Nota: Page potrebbe non essere contenuto in Table.
Se l'elemento corrente è contenuto in una cella di una tabella, verrà generata un'eccezione.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Adds a page break after the first paragraph. paragraph.appendPageBreak();
Indietro
Page: il nuovo elemento di interruzione di pagina.
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 Page Break(pageBreak)
Aggiunge l'elemento Page specificato.
Nota: Page non può essere contenuto all'interno di Table.
Se l'elemento corrente esiste in una cella di una tabella, lo script genera un'eccezione.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Adds a page break after the first paragraph. const pageBreak = paragraph.appendPageBreak(); // Makes a copy of the page break. const newPageBreak = pageBreak.copy(); // Adds the copied page break to the paragraph. paragraph.appendPageBreak(newPageBreak);
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
page | Page | L'interruzione di pagina da aggiungere. |
Indietro
Page: l'elemento di interruzione di pagina 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 Text(text)
Crea e aggiunge un nuovo elemento Text con i contenuti specificati.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Adds a string to the paragraph. paragraph.appendText('This is a new sentence.');
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
text | String | I contenuti testuali. |
Indietro
Text: il nuovo elemento 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
append Text(text)
Aggiunge l'elemento Text specificato.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Gets the text from the first paragraph in the body. const paragraph1 = body.getParagraphs()[0]; const text = paragraph1.getText(); // Gets the third paragraph in the body. const paragraph3 = body.getParagraphs()[2]; // Adds the text from the first paragraph to the third paragraph. paragraph3.appendText(text);
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
text | Text | L'elemento di testo da accodare. |
Indietro
Text: l'elemento di testo 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
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
Paragraph: 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 Alignment()
Recupera Horizontal.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Sets the horizontal alignment to left for the first paragraph. paragraph.setAlignment(DocumentApp.HorizontalAlignment.LEFT); // Gets the horizontal alignment of the first paragraph and logs it to the // console. console.log(paragraph.getAlignment().toString());
Indietro
Horizontal: l'allineamento.
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 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 Heading()
Recupera Paragraph.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Adds a paragraph to the body. const paragraph = body.appendParagraph('Title heading'); // Sets the paragraph heading style to 'Title.' paragraph.setHeading(DocumentApp.ParagraphHeading.TITLE); // Gets the heading style and logs it to the console. console.log(paragraph.getHeading().toString());
Indietro
Paragraph: l'intestazione.
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 Indent End()
Recupera il rientro finale, in punti.
Indietro
Number|null: il rientro finale, 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 Indent First Line()
Recupera il rientro della prima riga, in punti.
Indietro
Number|null: il rientro della prima riga, 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 Indent Start()
Recupera il rientro iniziale.
Indietro
Number|null: il rientro iniziale
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 Line Spacing()
Recupera l'interlinea, in punti.
Indietro
Number|null: l'interlinea, 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 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 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 Positioned Image(id)
Recupera un Positioned in base all'ID dell'immagine.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
id | String | ID immagine |
Indietro
Positioned: l'immagine posizionata
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 Positioned Images()
Recupera tutti gli oggetti Positioned ancorati al paragrafo.
Indietro
Positioned: un elenco di immagini posizionate
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 Spacing After()
Recupera la spaziatura dopo l'elemento, in punti.
Indietro
Number|null: la spaziatura dopo l'elemento, 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 Spacing Before()
Recupera la spaziatura prima dell'elemento, in punti.
Indietro
Number|null: la spaziatura prima dell'elemento, 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 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
insert Horizontal Rule(childIndex)
Crea e inserisce un Horizontal nell'indice specificato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
child | Integer | l'indice in cui inserire l'elemento |
Indietro
Horizontal: il nuovo elemento della 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 Inline Image(childIndex, image)
Crea e inserisce un nuovo Inline dal blob immagine specificato, all'indice specificato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
child | Integer | l'indice in cui inserire l'elemento |
image | Blob | i dati dell'immagine |
Indietro
Inline: l'elemento immagine in linea 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 Inline Image(childIndex, image)
Inserisce il Inline specificato all'indice indicato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
child | Integer | l'indice in cui inserire l'elemento |
image | Inline | i dati dell'immagine |
Indietro
Inline: l'elemento immagine in linea 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 Page Break(childIndex)
Crea e inserisce un nuovo Page all'indice specificato.
Nota: Page potrebbe non essere contenuto in Table.
Se l'elemento corrente è contenuto in una cella di una tabella, verrà generata un'eccezione.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
child | Integer | l'indice in cui inserire l'elemento |
Indietro
Page: il nuovo elemento di interruzione di pagina
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 Page Break(childIndex, pageBreak)
Inserisce il Page specificato all'indice indicato.
Nota: Page potrebbe non essere contenuto in Table.
Se l'elemento corrente è contenuto in una cella di una tabella, verrà generata un'eccezione.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
child | Integer | l'indice in cui inserire l'elemento |
page | Page | l'interruzione di pagina da inserire |
Indietro
Page: l'elemento di interruzione di pagina 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 Text(childIndex, text)
Crea e inserisce un nuovo elemento di testo nell'indice specificato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
child | Integer | l'indice in cui inserire l'elemento |
text | String | i contenuti testuali |
Indietro
Text: il nuovo elemento 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
insert Text(childIndex, text)
Inserisce l'elemento Text specificato nell'indice specificato, con i contenuti di testo specificati.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
child | Integer | l'indice in cui inserire l'elemento |
text | Text | l'elemento di testo da inserire |
Indietro
Text: l'elemento di testo 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
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
is Left To Right()
Recupera l'impostazione da sinistra a destra.
Indietro
Boolean|null: l'impostazione da sinistra a destra
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
Paragraph|null: 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
Paragraph: 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
Paragraph|null: 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
remove Positioned Image(id)
Rimuove un Positioned in base all'ID dell'immagine.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
id | String | ID immagine |
Indietro
Boolean: indica se l'immagine specificata è stata rimossa o meno
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 Alignment(alignment)
Imposta Horizontal.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
alignment | Horizontal | l'allineamento orizzontale |
Indietro
Paragraph: 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
Paragraph: 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 Heading(heading)
Imposta Paragraph.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
heading | Paragraph | l'intestazione |
Indietro
Paragraph: 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 Indent End(indentEnd)
Imposta il rientro finale, in punti.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
indent | Number | il rientro finale, in punti |
Indietro
Paragraph: 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 Indent First Line(indentFirstLine)
Imposta il rientro della prima riga, in punti.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
indent | Number | il rientro della prima riga, in punti |
Indietro
Paragraph: 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 Indent Start(indentStart)
Imposta il rientro iniziale, in punti.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
indent | Number | il rientro iniziale, in punti |
Indietro
Paragraph: 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 Left To Right(leftToRight)
Imposta l'impostazione da sinistra a destra.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
left | Boolean | l'impostazione da sinistra a destra |
Indietro
Paragraph: 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 Line Spacing(multiplier)
Imposta l'interlinea come quantità che indica il numero di righe da utilizzare per la spaziatura.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
multiplier | Number | il numero di righe |
Indietro
Paragraph: 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
Paragraph: 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 Spacing After(spacingAfter)
Imposta la spaziatura dopo l'elemento, in punti.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
spacing | Number | la spaziatura dopo l'elemento, in punti |
Indietro
Paragraph: 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 Spacing Before(spacingBefore)
Imposta la spaziatura prima dell'elemento, in punti.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
spacing | Number | la spaziatura prima dell'elemento, in punti |
Indietro
Paragraph: 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 del paragrafo come testo.
Nota: i contenuti esistenti vengono cancellati.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
text | String | i nuovi contenuti 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
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
Paragraph: 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