Un elemento che rappresenta una regione RTF. Tutto il testo in un elemento Document
è contenuto all'interno di elementi Text
.
Un elemento Text
può essere contenuto in Equation
, EquationFunction
,
ListItem
o Paragraph
, ma non può contenere altri elementi. Per ulteriori informazioni
informazioni sulla struttura dei documenti, consulta la guida per estendere Google Documenti.
// Gets the body contents of the active tab. var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Use editAsText to obtain a single text element containing // all the characters in the tab. var text = body.editAsText(); // Insert text at the beginning of the tab. text.insertText(0, 'Inserted text.\n'); // Insert text at the end of the tab. text.appendText('\nAppended text.'); // Make the first half of the tab blue. text.setForegroundColor(0, text.getText().length / 2, '#00FFFF');
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
appendText(text) | Text | Aggiunge il testo specificato alla fine di questa regione di testo. |
copy() | Text | Restituisce una copia diretta scollegata dell'elemento corrente. |
deleteText(startOffset, endOffsetInclusive) | Text | Consente di eliminare un intervallo di testo. |
editAsText() | Text | Consente di ottenere una versione Text dell'elemento corrente, da modificare. |
findText(searchPattern) | RangeElement | Cerca nei contenuti dell'elemento il pattern di testo specificato utilizzando espressioni regolari. |
findText(searchPattern, from) | RangeElement | Cerca i contenuti dell'elemento per il pattern di testo specificato, a partire da un determinato risultato di ricerca. |
getAttributes() | Object | Recupera gli attributi dell'elemento. |
getAttributes(offset) | Object | Recupera gli attributi all'offset del carattere specificato. |
getBackgroundColor() | String | Recupera l'impostazione del colore di sfondo. |
getBackgroundColor(offset) | String | Recupera il colore di sfondo in base all'offset del carattere specificato. |
getFontFamily() | String | Recupera l'impostazione della famiglia di caratteri. |
getFontFamily(offset) | String | Recupera la famiglia di caratteri all'offset del carattere specificato. |
getFontSize() | Number | Recupera l'impostazione della dimensione del carattere. |
getFontSize(offset) | Number | Recupera la dimensione del carattere all'offset del carattere specificato. |
getForegroundColor() | String | Recupera l'impostazione del colore in primo piano. |
getForegroundColor(offset) | String | Recupera il colore in primo piano all'offset dei caratteri specificato. |
getLinkUrl() | String | Recupera l'URL del link. |
getLinkUrl(offset) | String | Recupera l'URL del link all'offset di caratteri specificato. |
getNextSibling() | Element | Recupera l'elemento di pari livello successivo dell'elemento. |
getParent() | ContainerElement | Recupera l'elemento principale dell'elemento. |
getPreviousSibling() | Element | Recupera l'elemento di pari livello precedente dell'elemento. |
getText() | String | Recupera i contenuti dell'elemento come stringa di testo. |
getTextAlignment() | TextAlignment | Ottiene l'allineamento del testo. |
getTextAlignment(offset) | TextAlignment | Restituisce l'allineamento del testo per un singolo carattere. |
getTextAttributeIndices() | Integer[] | Recupera l'insieme di indici di testo che corrispondono all'inizio di una formattazione di testo distinta viene eseguito. |
getType() | ElementType | Recupera il valore ElementType dell'elemento. |
insertText(offset, text) | Text | Inserisce il testo specificato in corrispondenza dell'offset di caratteri specificato. |
isAtDocumentEnd() | Boolean | Determina se l'elemento si trova alla fine di Document . |
isBold() | Boolean | Recupera l'impostazione in grassetto. |
isBold(offset) | Boolean | Recupera l'impostazione del grassetto in corrispondenza dell'offset di caratteri specificato. |
isItalic() | Boolean | Recupera l'impostazione in corsivo. |
isItalic(offset) | Boolean | Recupera l'impostazione del corsivo in corrispondenza dell'offset del carattere specificato. |
isStrikethrough() | Boolean | Recupera l'impostazione barrato. |
isStrikethrough(offset) | Boolean | Recupera l'impostazione di barrato in corrispondenza dell'offset di caratteri specificato. |
isUnderline() | Boolean | Recupera l'impostazione della sottolineatura. |
isUnderline(offset) | Boolean | Recupera l'impostazione della sottolineatura in corrispondenza dell'offset del carattere specificato. |
merge() | Text | Unisce l'elemento con l'elemento di pari livello precedente dello stesso tipo. |
removeFromParent() | Text | Rimuove l'elemento da quello principale. |
replaceText(searchPattern, replacement) | Element | Sostituisce tutte le occorrenze di un determinato pattern di testo con una determinata stringa sostitutiva, utilizzando regolari le espressioni regolari. |
setAttributes(startOffset, endOffsetInclusive, attributes) | Text | Applica gli attributi specificati all'intervallo di caratteri specificato. |
setAttributes(attributes) | Text | Consente di impostare gli attributi dell'elemento. |
setBackgroundColor(startOffset, endOffsetInclusive, color) | Text | Imposta il colore di sfondo per l'intervallo di caratteri specificato. |
setBackgroundColor(color) | Text | Imposta il colore dello sfondo. |
setBold(bold) | Text | Consente di impostare il grassetto. |
setBold(startOffset, endOffsetInclusive, bold) | Text | Consente di impostare il grassetto per l'intervallo di caratteri specificato. |
setFontFamily(startOffset, endOffsetInclusive, fontFamilyName) | Text | Imposta la famiglia di caratteri per l'intervallo di caratteri specificato. |
setFontFamily(fontFamilyName) | Text | Imposta la famiglia di caratteri. |
setFontSize(startOffset, endOffsetInclusive, size) | Text | Imposta la dimensione del carattere per l'intervallo di caratteri specificato. |
setFontSize(size) | Text | Imposta la dimensione del carattere. |
setForegroundColor(startOffset, endOffsetInclusive, color) | Text | Imposta il colore di primo piano per l'intervallo di caratteri specificato. |
setForegroundColor(color) | Text | Imposta il colore del primo piano. |
setItalic(italic) | Text | Consente di impostare l'impostazione del corsivo. |
setItalic(startOffset, endOffsetInclusive, italic) | Text | Consente di impostare il corsivo per l'intervallo di caratteri specificato. |
setLinkUrl(startOffset, endOffsetInclusive, url) | Text | Imposta l'URL del link per l'intervallo di caratteri specificato. |
setLinkUrl(url) | Text | Imposta l'URL del link. |
setStrikethrough(strikethrough) | Text | Consente di impostare l'impostazione del testo barrato. |
setStrikethrough(startOffset, endOffsetInclusive, strikethrough) | Text | Consente di configurare l'impostazione barrato per l'intervallo di caratteri specificato. |
setText(text) | Text | Imposta i contenuti del testo. |
setTextAlignment(startOffset, endOffsetInclusive, textAlignment) | Text | Imposta l'allineamento del testo per un determinato intervallo di caratteri. |
setTextAlignment(textAlignment) | Text | Imposta l'allineamento del testo. |
setUnderline(underline) | Text | Consente di impostare l'impostazione per la sottolineatura. |
setUnderline(startOffset, endOffsetInclusive, underline) | Text | Consente di configurare l'impostazione di sottolineatura per l'intervallo di caratteri specificato. |
Documentazione dettagliata
appendText(text)
Aggiunge il testo specificato alla fine di questa regione di testo.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Adds the text, 'Sample body text,' to the end of the tab body. const text = body.editAsText().appendText('Sample body text');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | Il testo da aggiungere. |
Invio
Text
: 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
copy()
Restituisce una copia diretta scollegata dell'elemento corrente.
Vengono copiati anche tutti gli elementi secondari presenti nell'elemento. Il nuovo elemento non ha principale.
Invio
Text
: 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
deleteText(startOffset, endOffsetInclusive)
Consente di eliminare un intervallo di testo.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Deletes the first 10 characters in the body. const text = body.editAsText().deleteText(0, 9);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startOffset | Integer | L'offset del primo carattere da eliminare. |
endOffsetInclusive | Integer | L'offset dell'ultimo carattere da eliminare. |
Invio
Text
: 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
editAsText()
Consente di ottenere una versione Text
dell'elemento corrente, da modificare.
Usa editAsText
per manipolare i contenuti degli elementi come RTF. La modalità editAsText
ignora gli elementi non testuali (come InlineImage
e HorizontalRule
).
Gli elementi secondari completamente contenuti all'interno di un intervallo di testo eliminato vengono rimossi dall'elemento.
var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Insert two paragraphs separated by a paragraph containing an // horizontal rule. body.insertParagraph(0, "An editAsText sample."); body.insertHorizontalRule(0); body.insertParagraph(0, "An example."); // Delete " sample.\n\n An" removing the horizontal rule in the process. body.editAsText().deleteText(14, 25);
Invio
Text
: una versione di testo dell'elemento corrente
findText(searchPattern)
Cerca nei contenuti dell'elemento il pattern di testo specificato utilizzando espressioni regolari.
Un sottoinsieme delle caratteristiche dell'espressione regolare JavaScript non è completamente supportato, ad esempio: gruppi di acquisizione e modificatori di modalità.
Il pattern dell'espressione regolare fornito viene confrontato in modo indipendente con ogni blocco di testo contenuto nell'elemento corrente.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
searchPattern | String | il pattern da cercare |
Invio
RangeElement
: un risultato di ricerca che indica la posizione del testo di ricerca o nullo in caso contrario
compensare
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 i contenuti dell'elemento per il pattern di testo specificato, a partire da un determinato risultato di ricerca.
Un sottoinsieme delle caratteristiche dell'espressione regolare JavaScript non è completamente supportato, ad esempio: gruppi di acquisizione e modificatori di modalità.
Il pattern dell'espressione regolare fornito viene confrontato in modo indipendente con ogni blocco di testo contenuto nell'elemento corrente.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
searchPattern | String | il pattern da cercare |
from | RangeElement | il risultato di ricerca da cui eseguire la ricerca |
Invio
RangeElement
: un risultato di ricerca che indica la posizione successiva del testo di ricerca o nullo se non è presente
compensare
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 di elemento valido in cui
nome della proprietà corrisponde a un elemento nell'enumerazione DocumentApp.Attribute
.
var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab(); var body = documentTab.getBody(); // Append a styled paragraph. var par = body.appendParagraph('A bold, italicized paragraph.'); par.setBold(true); par.setItalic(true); // Retrieve the paragraph's attributes. var atts = par.getAttributes(); // Log the paragraph attributes. for (var att in atts) { Logger.log(att + ":" + atts[att]); }
Invio
Object
: gli attributi dell'elemento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getAttributes(offset)
Recupera gli attributi all'offset del carattere specificato.
Il risultato è un oggetto contenente una proprietà per ogni attributo di testo valido in cui
nome della proprietà corrisponde a un elemento nell'enumerazione DocumentApp.Attribute
.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Declares style attributes. const style = {} style[DocumentApp.Attribute.BOLD] = true; style[DocumentApp.Attribute.ITALIC] = true; style[DocumentApp.Attribute.FONT_SIZE] = 29; // Sets the style attributes to the tab's body. const text = body.editAsText(); text.setAttributes(style); // Gets the style attributes applied to the eleventh character in the // body and logs them to the console. const attributes = text.getAttributes(10); console.log(attributes);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | Integer | L'offset del carattere. |
Invio
Object
: gli attributi dell'elemento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getBackgroundColor()
Recupera l'impostazione del colore di sfondo.
Invio
String
: il colore di sfondo, formattato con notazione CSS (come '#ffffff'
) 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
getBackgroundColor(offset)
Recupera il colore di sfondo in base all'offset del carattere specificato.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Sets the background color of the first 3 characters in the body. const text = body.editAsText().setBackgroundColor(0, 2, '#FFC0CB'); // Gets the background color of the first character in the body. const backgroundColor = text.getBackgroundColor(0); // Logs the background color to the console. console.log(backgroundColor);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | Integer | L'offset del carattere. |
Invio
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
getFontFamily()
Recupera l'impostazione della famiglia di caratteri. Il nome può essere qualsiasi carattere presente nel menu Carattere di Documenti o Google Fonts e fa distinzione tra maiuscole e minuscole. I metodi getFontFamily()
e setFontFamily(fontFamilyName)
ora utilizzano nomi di stringhe per i caratteri anziché
l'enum
. Sebbene questa enum sia
deprecato, rimarrà disponibile per garantire la compatibilità con gli script precedenti.FontFamily
Invio
String
: la famiglia di caratteri o nullo 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
getFontFamily(offset)
Recupera la famiglia di caratteri all'offset del carattere specificato. Il nome può essere qualsiasi carattere
menu Carattere in Documenti o Google Fonts e viene
sensibile alle maiuscole. I metodi getFontFamily()
e setFontFamily(fontFamilyName)
ora utilizza nomi delle stringhe per i caratteri anziché l'enum
. Sebbene questa enum sia
deprecato, rimarrà disponibile per garantire la compatibilità con gli script precedenti.
FontFamily
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Sets the font of the first 16 characters to Impact. const text = body.editAsText().setFontFamily(0, 15, 'Impact'); // Gets the font family of the 16th character in the tab body. const fontFamily = text.getFontFamily(15); // Logs the font family to the console. console.log(fontFamily);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | Integer | L'offset del carattere. |
Invio
String
: la famiglia di caratteri.
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
getFontSize()
Recupera l'impostazione della dimensione del carattere.
Invio
Number
: la dimensione del carattere 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
getFontSize(offset)
Recupera la dimensione del carattere all'offset del carattere specificato.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Sets the font size of the first 13 characters to 15. const text = body.editAsText().setFontSize(0, 12, 15); // Gets the font size of the first character. const fontSize = text.getFontSize(0); // Logs the font size to the console. console.log(fontSize);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | Integer | L'offset del carattere. |
Invio
Number
: la dimensione del carattere.
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
getForegroundColor()
Recupera l'impostazione del colore in primo piano.
Invio
String
: il colore in primo piano, formattato in notazione CSS (come '#ffffff'
) 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
getForegroundColor(offset)
Recupera il colore in primo piano all'offset dei caratteri specificato.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Sets the foreground color of the first 3 characters in the tab body. const text = body.editAsText().setForegroundColor(0, 2, '#0000FF'); // Gets the foreground color of the first character in the tab body. const foregroundColor = text.getForegroundColor(0); // Logs the foreground color to the console. console.log(foregroundcolor);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | Integer | L'offset del carattere. |
Invio
String
: il colore in primo piano, 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
getLinkUrl()
Recupera l'URL del link.
Invio
String
: l'URL del link o nullo 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
getLinkUrl(offset)
Recupera l'URL del link all'offset di caratteri specificato.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Applies a link to the first 10 characters in the body. const text = body.editAsText().setLinkUrl(0, 9, 'https://www.example.com/'); // Gets the URL of the link from the first character. const link = text.getLinkUrl(0); // Logs the link URL to the console. console.log(link);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | Integer | L'offset del carattere. |
Invio
String
: l'URL del link.
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'altro elemento di pari livello ha lo stesso elemento principale e segue l'elemento corrente.
Invio
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
getParent()
Recupera l'elemento principale dell'elemento.
L'elemento principale contiene l'elemento corrente.
Invio
ContainerElement
: l'elemento principale.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
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.
Invio
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
getText()
Recupera i contenuti dell'elemento come stringa di testo.
Invio
String
: i contenuti dell'elemento come stringa di testo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getTextAlignment()
Ottiene l'allineamento del testo. I tipi di allineamento disponibili sono DocumentApp.TextAlignment.NORMAL
, DocumentApp.TextAlignment.SUBSCRIPT
e DocumentApp.TextAlignment.SUPERSCRIPT
.
Invio
TextAlignment
: il tipo di allineamento del testo o null
se il testo contiene più tipi di testo
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
getTextAlignment(offset)
Restituisce l'allineamento del testo per un singolo carattere. I tipi di allineamento disponibili sono DocumentApp.TextAlignment.NORMAL
, DocumentApp.TextAlignment.SUBSCRIPT
e DocumentApp.TextAlignment.SUPERSCRIPT
.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Sets the text alignment of the tab's body to NORMAL. const text = body.editAsText().setTextAlignment(DocumentApp.TextAlignment.NORMAL); // Gets the text alignment of the ninth character. const alignment = text.getTextAlignment(8); // Logs the text alignment to the console. console.log(alignment.toString());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | Integer | L'offset del carattere. |
Invio
TextAlignment
: il tipo di allineamento del testo o null
se non è mai stato impostato l'allineamento del 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
getTextAttributeIndices()
Recupera l'insieme di indici di testo che corrispondono all'inizio di una formattazione di testo distinta viene eseguito.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Gets the text indices at which text formatting changes. const indices = body.editAsText().getTextAttributeIndices(); // Logs the indices to the console. console.log(indices.toString());
Invio
Integer[]
: l'insieme di indici di testo a cui cambia la formattazione del 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
getType()
Recupera il valore ElementType
dell'elemento.
Usa getType()
per determinare il tipo esatto di un determinato elemento.
var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab(); var body = documentTab.getBody(); // Obtain the first element in the active tab's body. var firstChild = body.getChild(0); // Use getType() to determine the element's type. if (firstChild.getType() == DocumentApp.ElementType.PARAGRAPH) { Logger.log('The first element is a paragraph.'); } else { Logger.log('The first element is not a paragraph.'); }
Invio
ElementType
: il tipo di elemento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertText(offset, text)
Inserisce il testo specificato in corrispondenza dell'offset di caratteri specificato.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Inserts the text, 'Sample inserted text', at the start of the body content. const text = body.editAsText().insertText(0, 'Sample inserted text');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | Integer | L'offset del carattere a cui inserire il testo. |
text | String | Il testo da inserire. |
Invio
Text
: 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
isAtDocumentEnd()
Determina se l'elemento si trova alla fine di Document
.
Invio
Boolean
: 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
isBold()
Recupera l'impostazione in grassetto.
Invio
Boolean
: se il testo è in grassetto o nullo 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
isBold(offset)
Recupera l'impostazione del grassetto in corrispondenza dell'offset di caratteri specificato.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Bolds the first 4 characters in the tab body. const text = body.editAsText().setBold(0, 3, true); // Gets whether or not the text is bold. const bold = text.editAsText().isBold(0); // Logs the text's bold setting to the console console.log(bold);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | Integer | L'offset del carattere. |
Invio
Boolean
: l'impostazione in grassetto.
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
isItalic()
Recupera l'impostazione in corsivo.
Invio
Boolean
: se il testo è in corsivo o nullo 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
isItalic(offset)
Recupera l'impostazione del corsivo in corrispondenza dell'offset del carattere specificato.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Sets the first 13 characters of the tab body to italic. const text = body.editAsText().setItalic(0, 12, true); // Gets whether the fifth character in the tab body is set to // italic and logs it to the console. const italic = text.isItalic(4); console.log(italic);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | Integer | L'offset del carattere. |
Invio
Boolean
: l'impostazione in corsivo.
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
isStrikethrough()
Recupera l'impostazione barrato.
Invio
Boolean
: indica se il testo è barrato o nullo 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
isStrikethrough(offset)
Recupera l'impostazione di barrato in corrispondenza dell'offset di caratteri specificato.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Sets the first 17 characters of the tab body to strikethrough. const text = body.editAsText().setStrikethrough(0, 16, true); // Gets whether the first character in the tab body is set to // strikethrough and logs it to the console. const strikethrough = text.isStrikethrough(0); console.log(strikethrough);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | Integer | L'offset del carattere. |
Invio
Boolean
: l'impostazione barrato.
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
isUnderline()
Recupera l'impostazione della sottolineatura.
Invio
Boolean
: se il testo è sottolineato o nullo 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
isUnderline(offset)
Recupera l'impostazione della sottolineatura in corrispondenza dell'offset del carattere specificato.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Sets the first 13 characters of the tab body to underline. const text = body.editAsText().setUnderline(0, 12, false); // Gets whether the first character in the tab body is set to // underline and logs it to the console const underline = text.editAsText().isUnderline(0); console.log(underline);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | Integer | L'offset del carattere. |
Invio
Boolean
: l'impostazione di sottolineatura.
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 elementi dello stesso elemento ElementType
. Qualsiasi elemento secondario contenuto in
gli elementi correnti vengono spostati all'elemento di pari livello precedente.
L'elemento corrente viene rimosso dal documento.
var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab(); var body = documentTab.getBody(); // Example 1: Merge paragraphs // Append two paragraphs to the document's active tab. var par1 = body.appendParagraph('Paragraph 1.'); var par2 = body.appendParagraph('Paragraph 2.'); // Merge the newly added paragraphs into a single paragraph. par2.merge(); // Example 2: Merge table cells // Create a two-dimensional array containing the table's cell contents. var cells = [ ['Row 1, Cell 1', 'Row 1, Cell 2'], ['Row 2, Cell 1', 'Row 2, Cell 2'] ]; // Build a table from the array. var table = body.appendTable(cells); // Get the first row in the table. var row = table.getRow(0); // Get the two cells in this row. var cell1 = row.getCell(0); var cell2 = row.getCell(1); // Merge the current cell into its preceding sibling element. var merged = cell2.merge();
Invio
Text
: 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
removeFromParent()
Rimuove l'elemento da quello principale.
var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab() var body = documentTab.getBody(); // Remove all images in the active tab's body. var imgs = body.getImages(); for (var i = 0; i < imgs.length; i++) { imgs[i].removeFromParent(); }
Invio
Text
: 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 regolari le espressioni regolari.
Il pattern di ricerca viene trasmesso come stringa, non come oggetto di espressione regolare JavaScript. Per questo motivo dovrai eseguire l'escape delle eventuali barre rovesciate nel pattern.
Questo metodo utilizza la tecnologia standard RE2 di Google libreria di espressioni, che limita la sintassi supportata.
Il pattern dell'espressione regolare fornito viene confrontato in modo indipendente con ogni blocco di testo contenuto nell'elemento corrente.
var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Clear the text surrounding "Apps Script", with or without text. body.replaceText("^.*Apps ?Script.*$", "Apps Script");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
searchPattern | String | il pattern dell'espressione regolare per cercare |
replacement | String | il testo da utilizzare come sostituzione |
Invio
Element
: l'elemento corrente
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setAttributes(startOffset, endOffsetInclusive, attributes)
Applica gli attributi specificati all'intervallo di caratteri specificato.
Il parametro degli attributi specificato deve essere un oggetto in cui ogni nome di proprietà è un elemento in
l'enumerazione DocumentApp.Attribute
e il valore di ogni proprietà è il nuovo valore da
applicati.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Declares style attributes for font size and font family. const style = {} style[DocumentApp.Attribute.FONT_SIZE] = 20 ; style[DocumentApp.Attribute.FONT_FAMILY] = 'Impact'; // Sets the style attributes to the first 9 characters in the tab's body. const text = body.setAttributes(0, 8, style);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startOffset | Integer | L'offset iniziale dell'intervallo di testo. |
endOffsetInclusive | Integer | L'offset finale dell'intervallo di testo. |
attributes | Object | Gli attributi dell'elemento. |
Invio
Text
: 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)
Consente di impostare gli attributi dell'elemento.
Il parametro degli attributi specificato deve essere un oggetto in cui ogni nome di proprietà è un elemento in
l'enumerazione DocumentApp.Attribute
e il valore di ogni proprietà è il nuovo valore da
applicati.
var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab(); var body = documentTab.getBody(); // Define a custom paragraph style. var style = {}; style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] = DocumentApp.HorizontalAlignment.RIGHT; style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri'; style[DocumentApp.Attribute.FONT_SIZE] = 18; style[DocumentApp.Attribute.BOLD] = true; // Append a plain paragraph. var par = body.appendParagraph('A paragraph with custom style.'); // Apply the custom style. par.setAttributes(style);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
attributes | Object | Gli attributi dell'elemento. |
Invio
Text
: 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(startOffset, endOffsetInclusive, color)
Imposta il colore di sfondo per l'intervallo di caratteri specificato.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Sets the background color of the first 3 characters in the // tab body to hex color #0000FF. const text = body.editAsText().setBackgroundColor(0, 2, '#0000FF');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startOffset | Integer | L'offset iniziale dell'intervallo di testo. |
endOffsetInclusive | Integer | L'offset finale dell'intervallo di testo. |
color | String | Il colore di sfondo, formattato in notazione CSS (come '#ffffff' ). |
Invio
Text
: 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' ) |
Invio
Text
: 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
setBold(bold)
Consente di impostare il grassetto.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
bold | Boolean | l'impostazione in grassetto |
Invio
Text
: 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
setBold(startOffset, endOffsetInclusive, bold)
Consente di impostare il grassetto per l'intervallo di caratteri specificato.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Sets the first 11 characters in the tab's body to bold. const text = body.editAsText().setBold(0, 10, true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startOffset | Integer | L'offset iniziale dell'intervallo di testo. |
endOffsetInclusive | Integer | L'offset finale dell'intervallo di testo. |
bold | Boolean | Impostazione grassetto. |
Invio
Text
: 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
setFontFamily(startOffset, endOffsetInclusive, fontFamilyName)
Imposta la famiglia di caratteri per l'intervallo di caratteri specificato. Il nome può essere qualsiasi carattere
in Documenti o Google Fonts e fa distinzione tra maiuscole e minuscole.
I nomi dei caratteri non riconosciuti verranno visualizzati come Arial. I metodi getFontFamily(offset)
e
setFontFamily(fontFamilyName)
ora utilizza i nomi delle stringhe per i caratteri anziché l'enum
. Sebbene questa enum sia
deprecato, rimarrà disponibile per garantire la compatibilità con gli script precedenti.
FontFamily
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Sets the font of the first 4 characters in the tab's body to Roboto. const text = body.editAsText().setFontFamily(0, 3, 'Roboto');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startOffset | Integer | L'offset iniziale dell'intervallo di testo. |
endOffsetInclusive | Integer | L'offset finale dell'intervallo di testo. |
fontFamilyName | String | Il nome della famiglia di caratteri, dal menu Carattere in Documenti o Google Fonts. |
Invio
Text
: 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
setFontFamily(fontFamilyName)
Imposta la famiglia di caratteri. Il nome può essere qualsiasi carattere presente nel menu Carattere di Documenti o Google Fonts e fa distinzione tra maiuscole e minuscole. Carattere non riconosciuto
i nomi verranno visualizzati come Arial. I metodi getFontFamily()
e setFontFamily(fontFamilyName)
ora utilizzano nomi di stringhe per i caratteri anziché l'enum
. Sebbene questa enum sia
deprecato, rimarrà disponibile per garantire la compatibilità con gli script precedenti.FontFamily
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontFamilyName | String | Il nome della famiglia di caratteri, dal menu Carattere in Documenti o Google Fonts |
Invio
Text
: 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
setFontSize(startOffset, endOffsetInclusive, size)
Imposta la dimensione del carattere per l'intervallo di caratteri specificato.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Sets the size of the first 11 characters in the tab's body to 12. const text = body.editAsText().setFontSize(0, 10, 12);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startOffset | Integer | L'offset iniziale dell'intervallo di testo. |
endOffsetInclusive | Integer | L'offset finale dell'intervallo di testo. |
size | Number | Le dimensioni del carattere. |
Invio
Text
: 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
setFontSize(size)
Imposta la dimensione del carattere.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
size | Number | la dimensione del carattere |
Invio
Text
: 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
setForegroundColor(startOffset, endOffsetInclusive, color)
Imposta il colore di primo piano per l'intervallo di caratteri specificato.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Sets the foreground color of the first 2 characters in the // tab's body to hex color #FF0000. const text = body.editAsText().setForegroundColor(0, 1, '#FF0000'); // Gets the foreground color for the second character in the tab's body. const foregroundColor = text.getForegroundColor(1); // Logs the foreground color to the console. console.log(foregroundColor);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startOffset | Integer | L'offset iniziale dell'intervallo di testo. |
endOffsetInclusive | Integer | L'offset finale dell'intervallo di testo. |
color | String | Il colore in primo piano, formattato in notazione CSS (come '#ffffff' ). |
Invio
Text
: 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
setForegroundColor(color)
Imposta il colore del primo piano.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | il colore in primo piano, formattato in notazione CSS (come '#ffffff' ) |
Invio
Text
: 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
setItalic(italic)
Consente di impostare l'impostazione del corsivo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
italic | Boolean | l'impostazione del corsivo |
Invio
Text
: 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
setItalic(startOffset, endOffsetInclusive, italic)
Consente di impostare il corsivo per l'intervallo di caratteri specificato.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Sets the first 11 characters in the tab's body to italic. const text = body.editAsText().setItalic(0, 10, true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startOffset | Integer | L'offset iniziale dell'intervallo di testo. |
endOffsetInclusive | Integer | L'offset finale dell'intervallo di testo. |
italic | Boolean | Impostazione del corsivo. |
Invio
Text
: 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(startOffset, endOffsetInclusive, url)
Imposta l'URL del link per l'intervallo di caratteri specificato.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Applies a link to the first 11 characters in the body. const text = body.editAsText().setLinkUrl(0, 10, 'https://example.com');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startOffset | Integer | L'offset iniziale dell'intervallo di testo. |
endOffsetInclusive | Integer | L'offset finale dell'intervallo di testo. |
url | String | L'URL del link. |
Invio
Text
: l'elemento corrente.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLinkUrl(url)
Imposta l'URL del link.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
url | String | l'URL del link |
Invio
Text
: 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
setStrikethrough(strikethrough)
Consente di impostare l'impostazione del testo barrato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
strikethrough | Boolean | l'impostazione del testo barrato |
Invio
Text
: 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
setStrikethrough(startOffset, endOffsetInclusive, strikethrough)
Consente di configurare l'impostazione barrato per l'intervallo di caratteri specificato.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Sets the first 11 characters in the tab's body to strikethrough. const text = body.editAsText().setStrikethrough(0, 10, true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startOffset | Integer | L'offset iniziale dell'intervallo di testo. |
endOffsetInclusive | Integer | L'offset finale dell'intervallo di testo. |
strikethrough | Boolean | L'impostazione del testo barrato. |
Invio
Text
: 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 del testo.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Replaces the contents of the body with the text, 'New body text.' const text = body.editAsText().setText('New body text.');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | I nuovi contenuti di testo. |
Invio
Text
: 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(startOffset, endOffsetInclusive, textAlignment)
Imposta l'allineamento del testo per un determinato intervallo di caratteri. I tipi di allineamento disponibili sono
DocumentApp.TextAlignment.NORMAL
, DocumentApp.TextAlignment.SUBSCRIPT
e
DocumentApp.TextAlignment.SUPERSCRIPT
.
// Make the first character in the first paragraph of the active tab be superscript. var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab(); var text = documentTab.getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(0, 0, DocumentApp.TextAlignment.SUPERSCRIPT);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startOffset | Integer | L'offset iniziale dell'intervallo di caratteri. |
endOffsetInclusive | Integer | L'offset finale dell'intervallo di caratteri (incluso). |
textAlignment | TextAlignment | Il tipo di allineamento del testo da applicare. |
Invio
Text
: l'elemento corrente.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setTextAlignment(textAlignment)
Imposta l'allineamento del testo. I tipi di allineamento disponibili sono DocumentApp.TextAlignment.NORMAL
, DocumentApp.TextAlignment.SUBSCRIPT
e DocumentApp.TextAlignment.SUPERSCRIPT
.
// Make the entire first paragraph in the active tab be superscript. var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab(); var text = documentTab.getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
textAlignment | TextAlignment | il tipo di allineamento del testo da applicare |
Invio
Text
: 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
setUnderline(underline)
Consente di impostare l'impostazione per la sottolineatura.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
underline | Boolean | l'impostazione della sottolineatura. |
Invio
Text
: 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
setUnderline(startOffset, endOffsetInclusive, underline)
Consente di configurare l'impostazione di sottolineatura per l'intervallo di caratteri specificato.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/DOCUMENT_ID/edit'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab(TAB_ID).asDocumentTab().getBody(); // Sets the first 11 characters in the tab's body to underline. const text = body.editAsText().setUnderline(0, 10, true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
startOffset | Integer | L'offset iniziale dell'intervallo di testo. |
endOffsetInclusive | Integer | L'offset finale dell'intervallo di testo. |
underline | Boolean | L'impostazione per sottolineare. |
Invio
Text
: 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