Elemento che rappresenta una regione con testo RTF. Tutto il testo del Document
è incluso negli elementi Text
.
Un elemento Text
può essere contenuto all'interno di Equation
, EquationFunction
, ListItem
o Paragraph
, ma non può contenere nessun altro elemento. Per saperne di più sulla struttura dei documenti, consulta la guida all'estensione di Documenti Google.
var body = DocumentApp.getActiveDocument().getBody(); // Use editAsText to obtain a single text element containing // all the characters in the document. var text = body.editAsText(); // Insert text at the beginning of the document. text.insertText(0, 'Inserted text.\n'); // Insert text at the end of the document. text.appendText('\nAppended text.'); // Make the first half of the document 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 separata e profonda dell'elemento corrente. |
deleteText(startOffset, endOffsetInclusive) | Text | Consente di eliminare un intervallo di testo. |
editAsText() | Text | Permette di ottenere una versione Text dell'elemento corrente per la modifica. |
findText(searchPattern) | RangeElement | Cerca i contenuti dell'elemento in base al pattern di testo specificato utilizzando espressioni regolari. |
findText(searchPattern, from) | RangeElement | Cerca i contenuti dell'elemento in base al 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 con l'offset di caratteri specificato. |
getBackgroundColor() | String | Recupera l'impostazione del colore di sfondo. |
getBackgroundColor(offset) | String | Recupera il colore di sfondo con l'offset di caratteri 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 delle dimensioni del carattere. |
getFontSize(offset) | Number | Recupera le dimensioni dei caratteri con l'offset di caratteri specificato. |
getForegroundColor() | String | Recupera l'impostazione del colore in primo piano. |
getForegroundColor(offset) | String | Recupera il colore in primo piano all'offset del carattere specificato. |
getLinkUrl() | String | Recupera l'URL del link. |
getLinkUrl(offset) | String | Recupera l'URL del link all'offset del carattere 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 | Visualizza l'allineamento del testo. |
getTextAlignment(offset) | TextAlignment | Visualizza l'allineamento del testo di un singolo carattere. |
getTextAttributeIndices() | Integer[] | Recupera l'insieme di indici di testo che corrispondono all'inizio di esecuzioni di testo distinte. |
getType() | ElementType | Recupera il ElementType dell'elemento. |
insertText(offset, text) | Text | Consente di inserire il testo specificato con l'offset di un determinato carattere. |
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 in grassetto all'offset del carattere specificato. |
isItalic() | Boolean | Recupera l'impostazione del corsivo. |
isItalic(offset) | Boolean | Recupera l'impostazione del corsivo all'offset del carattere specificato. |
isStrikethrough() | Boolean | Recupera l'impostazione barrata. |
isStrikethrough(offset) | Boolean | Recupera l'impostazione barrata con l'offset del carattere specificato. |
isUnderline() | Boolean | Recupera l'impostazione di sottolineatura. |
isUnderline(offset) | Boolean | Recupera l'impostazione della sottolineatura all'offset del carattere specificato. |
merge() | Text | Unisce l'elemento con il precedente elemento di pari livello dello stesso tipo. |
removeFromParent() | Text | Rimuove l'elemento dall'elemento principale. |
replaceText(searchPattern, replacement) | Element | Sostituisce tutte le occorrenze di un determinato pattern di testo con una determinata stringa di sostituzione, utilizzando espressioni regolari. |
setAttributes(startOffset, endOffsetInclusive, attributes) | Text | Applica gli attributi specificati all'intervallo di caratteri specificato. |
setAttributes(attributes) | Text | Imposta 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 in primo piano per l'intervallo di caratteri specificato. |
setForegroundColor(color) | Text | Imposta il colore in primo piano. |
setItalic(italic) | Text | Imposta l'impostazione del corsivo. |
setItalic(startOffset, endOffsetInclusive, italic) | Text | Imposta l'impostazione del 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 barrata. |
setStrikethrough(startOffset, endOffsetInclusive, strikethrough) | Text | Consente di impostare l'impostazione barrata per l'intervallo di caratteri specificato. |
setText(text) | Text | Consente di impostare 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 di sottolineatura. |
setUnderline(startOffset, endOffsetInclusive, underline) | Text | Consente di impostare 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/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Adds the text, 'Sample body text,' to the end of the document body. const text = body.editAsText().appendText('Sample body text');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | Il testo da aggiungere. |
Andata e ritorno
Text
: 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 separata e profonda dell'elemento corrente.
Vengono copiati anche tutti gli elementi secondari presenti nell'elemento. Il nuovo elemento non ha un elemento principale.
Andata e ritorno
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/abc123456/edit'); // Gets the document body. const body = doc.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 | La differenza di caratteri dell'ultimo carattere da eliminare. |
Andata e ritorno
Text
: 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()
Permette di ottenere una versione Text
dell'elemento corrente per la modifica.
Utilizza editAsText
per manipolare i contenuti degli elementi come RTF. La modalità editAsText
ignora gli elementi non testuali (ad esempio InlineImage
e HorizontalRule
).
Gli elementi secondari contenuti in un intervallo di testo eliminato vengono rimossi dall'elemento.
var body = DocumentApp.getActiveDocument().getBody(); // Insert two paragraphs separated by a paragraph containing an // horizontal rule. body.insertParagraph(0, "An editAsText sample."); body.insertHorizontalRule(0); body.insertParagraph(0, "An example."); // Delete " sample.\n\n An" removing the horizontal rule in the process. body.editAsText().deleteText(14, 25);
Andata e ritorno
Text
: una versione testuale dell'elemento corrente.
findText(searchPattern)
Cerca i contenuti dell'elemento in base al pattern di testo specificato utilizzando espressioni regolari.
Un sottoinsieme delle funzionalità di espressione regolare JavaScript non è completamente supportato, ad esempio i gruppi di acquisizione e i modificatori di modalità.
Il pattern di espressione regolare fornito viene abbinato in modo indipendente a ogni blocco di testo contenuto nell'elemento corrente.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
searchPattern | String | il pattern da cercare |
Andata e ritorno
RangeElement
: un risultato di ricerca che indica la posizione del testo di ricerca oppure null se non viene trovata una corrispondenza
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findText(searchPattern, from)
Cerca i contenuti dell'elemento in base al pattern di testo specificato, a partire da un determinato risultato di ricerca.
Un sottoinsieme delle funzionalità di espressione regolare JavaScript non è completamente supportato, ad esempio i gruppi di acquisizione e i modificatori di modalità.
Il pattern di espressione regolare fornito viene abbinato in modo indipendente a ogni blocco di testo contenuto nell'elemento corrente.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
searchPattern | String | il pattern da cercare |
from | RangeElement | il risultato di ricerca da cui eseguire la ricerca |
Andata e ritorno
RangeElement
: un risultato di ricerca che indica la posizione successiva del testo di ricerca oppure null se non viene trovata una corrispondenza
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getAttributes()
Recupera gli attributi dell'elemento.
Il risultato è un oggetto contenente una proprietà per ogni attributo di elemento valido, in cui ogni nome di proprietà corrisponde a un elemento nell'enumerazione di DocumentApp.Attribute
.
var body = DocumentApp.getActiveDocument().getBody(); // Append a styled paragraph. var par = body.appendParagraph('A bold, italicized paragraph.'); par.setBold(true); par.setItalic(true); // Retrieve the paragraph's attributes. var atts = par.getAttributes(); // Log the paragraph attributes. for (var att in atts) { Logger.log(att + ":" + atts[att]); }
Andata e ritorno
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 con l'offset di caratteri specificato.
Il risultato è un oggetto contenente una proprietà per ogni attributo di testo valido, in cui ogni nome di proprietà corrisponde a un elemento nell'enumerazione di 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/abc123456/edit'); // Gets the document body. const body = doc.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 document 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. |
Andata e ritorno
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.
Andata e ritorno
String
: il colore dello sfondo, formattato in notazione CSS (come '#ffffff'
) 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
getBackgroundColor(offset)
Recupera il colore di sfondo con l'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/abc123456'); // Gets the document body. const body = doc.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. |
Andata e ritorno
String
: il colore dello 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 dal menu Caratteri di Documenti o Google Fonts ed è sensibile alle maiuscole. I metodi getFontFamily()
e setFontFamily(fontFamilyName)
ora utilizzano nomi di stringhe per i caratteri anziché l'enumerazione
. Anche se questa enumerazione è deprecata, rimarrà disponibile per la compatibilità con gli script precedenti.FontFamily
Andata e ritorno
String
: la famiglia di caratteri 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
getFontFamily(offset)
Recupera la famiglia di caratteri all'offset del carattere specificato. Il nome può essere qualsiasi carattere dal menu Caratteri in Documenti o Google Fonts ed è sensibile alle maiuscole. I metodi getFontFamily()
e setFontFamily(fontFamilyName)
ora utilizzano i nomi delle stringhe per i caratteri anziché l'enumerazione
. Anche se questa enumerazione è deprecata, rimarrà disponibile per 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/abc123456/edit'); // Gets the document body. const body = doc.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 document 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. |
Andata e ritorno
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 delle dimensioni del carattere.
Andata e ritorno
Number
: le dimensioni 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 le dimensioni dei caratteri con l'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/abc123456/edit'); // Gets the document body. const body = doc.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. |
Andata e ritorno
Number
: le dimensioni 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.
Andata e ritorno
String
: il colore in primo piano, formattato in notazione CSS (come '#ffffff'
) 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
getForegroundColor(offset)
Recupera il colore in primo piano 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/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the foreground color of the first 3 characters in the document body. const text = body.editAsText().setForegroundColor(0, 2, '#0000FF'); // Gets the foreground color of the first character in the document 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. |
Andata e ritorno
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.
Andata e ritorno
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 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/abc123456/edit'); // Gets the document body. const body = doc.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. |
Andata e ritorno
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.
Il fratello successivo ha lo stesso elemento padre e segue l'elemento corrente.
Andata e ritorno
Element
: il prossimo elemento di pari livello.
Autorizzazione
Gli script che utilizzano questo 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.
Andata e ritorno
ContainerElement
: 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.
Il gemello precedente ha lo stesso elemento principale e precede l'elemento corrente.
Andata e ritorno
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.
Andata e ritorno
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()
Visualizza l'allineamento del testo. I tipi di allineamento disponibili sono DocumentApp.TextAlignment.NORMAL
, DocumentApp.TextAlignment.SUBSCRIPT
e DocumentApp.TextAlignment.SUPERSCRIPT
.
Andata e ritorno
TextAlignment
: il tipo di allineamento del testo o null
se il testo contiene più tipi di allineamenti 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
getTextAlignment(offset)
Visualizza l'allineamento del testo di 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/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the text alignment of the document 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. |
Andata e ritorno
TextAlignment
: il tipo di allineamento del testo o null
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
getTextAttributeIndices()
Recupera l'insieme di indici di testo che corrispondono all'inizio di esecuzioni di testo distinte.
// 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/abc123456/edit'); // Gets the document body. const body = doc.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());
Andata e ritorno
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 ElementType
dell'elemento.
Utilizza getType()
per determinare il tipo esatto di un determinato elemento.
var body = DocumentApp.getActiveDocument().getBody(); // Obtain the first element in the document body. var firstChild = body.getChild(0); // Use getType() to determine the element's type. if (firstChild.getType() == DocumentApp.ElementType.PARAGRAPH) { Logger.log('The first element is a paragraph.'); } else { Logger.log('The first element is not a paragraph.'); }
Andata e ritorno
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)
Consente di inserire il testo specificato con l'offset di un determinato carattere.
// 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/abc123456/edit'); // Gets the document body. const body = doc.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 | La differenza di caratteri in cui inserire il testo. |
text | String | Il testo da inserire. |
Andata e ritorno
Text
: 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
.
Andata e ritorno
Boolean
: indica se l'elemento si trova alla fine del documento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
isBold()
Recupera l'impostazione in grassetto.
Andata e ritorno
Boolean
: indica se il testo è in grassetto 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
isBold(offset)
Recupera l'impostazione in grassetto 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/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Bolds the first 4 characters in the document 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. |
Andata e ritorno
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 del corsivo.
Andata e ritorno
Boolean
: indica se il testo è in corsivo 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
isItalic(offset)
Recupera l'impostazione del corsivo 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/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the first 13 characters of the document body to italic. const text = body.editAsText().setItalic(0, 12, true); // Gets whether the fifth character in the document 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. |
Andata e ritorno
Boolean
: l'impostazione del 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 barrata.
Andata e ritorno
Boolean
: indica 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 barrata con l'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/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the first 17 characters of the document body to strikethrough. const text = body.editAsText().setStrikethrough(0, 16, true); // Gets whether the first character in the document 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. |
Andata e ritorno
Boolean
: l'impostazione barrata.
Autorizzazione
Gli script che utilizzano questo 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 di sottolineatura.
Andata e ritorno
Boolean
: indica 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 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/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the first 13 characters of the document body to underline. const text = body.editAsText().setUnderline(0, 12, false); // Gets whether the first character in the document 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. |
Andata e ritorno
Boolean
: l'impostazione della 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 il precedente elemento di pari livello dello stesso tipo.
È possibile unire solo gli elementi dello stesso ElementType
. Tutti gli elementi secondari contenuti nell'elemento corrente vengono spostati nell'elemento gemello precedente.
L'elemento corrente viene rimosso dal documento.
var body = DocumentApp.getActiveDocument().getBody(); // Example 1: Merge paragraphs // Append two paragraphs to the document. var par1 = body.appendParagraph('Paragraph 1.'); var par2 = body.appendParagraph('Paragraph 2.'); // Merge the newly added paragraphs into a single paragraph. par2.merge(); // Example 2: Merge table cells // Create a two-dimensional array containing the table's cell contents. var cells = [ ['Row 1, Cell 1', 'Row 1, Cell 2'], ['Row 2, Cell 1', 'Row 2, Cell 2'] ]; // Build a table from the array. var table = body.appendTable(cells); // Get the first row in the table. var row = table.getRow(0); // Get the two cells in this row. var cell1 = row.getCell(0); var cell2 = row.getCell(1); // Merge the current cell into its preceding sibling element. var merged = cell2.merge();
Andata e ritorno
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 dall'elemento principale.
var body = DocumentApp.getActiveDocument().getBody(); // Remove all images in the document body. var imgs = body.getImages(); for (var i = 0; i < imgs.length; i++) { imgs[i].removeFromParent(); }
Andata e ritorno
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 di sostituzione, utilizzando espressioni regolari.
Il pattern di ricerca viene passato come stringa, non come oggetto di espressione regolare JavaScript. Per questo motivo, dovrai utilizzare il carattere di escape per le barre rovesciate nel pattern.
Questo metodo utilizza la libreria di espressioni regolari RE2 di Google, che limita la sintassi supportata.
Il pattern di espressione regolare fornito viene abbinato in modo indipendente a ogni blocco di testo contenuto nell'elemento corrente.
var body = DocumentApp.getActiveDocument().getBody(); // Clear the text surrounding "Apps Script", with or without text. body.replaceText("^.*Apps ?Script.*$", "Apps Script");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
searchPattern | String | il pattern specificato dall'espressione regolare per cercare |
replacement | String | il testo da usare come sostituto |
Andata e ritorno
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 proprietà è un elemento nell'enumerazione di DocumentApp.Attribute
e ogni valore della proprietà è il nuovo valore da applicare.
// 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/abc123456/edit'); // Gets the document body and edits as text. const body = doc.getBody().editAsText(); // 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 document 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. |
Andata e ritorno
Text
: elemento corrente.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setAttributes(attributes)
Imposta gli attributi dell'elemento.
Il parametro degli attributi specificato deve essere un oggetto in cui ogni nome proprietà è un elemento nell'enumerazione di DocumentApp.Attribute
e ogni valore della proprietà è il nuovo valore da applicare.
var body = DocumentApp.getActiveDocument().getBody(); // Define a custom paragraph style. var style = {}; style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] = DocumentApp.HorizontalAlignment.RIGHT; style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri'; style[DocumentApp.Attribute.FONT_SIZE] = 18; style[DocumentApp.Attribute.BOLD] = true; // Append a plain paragraph. var par = body.appendParagraph('A paragraph with custom style.'); // Apply the custom style. par.setAttributes(style);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
attributes | Object | Gli attributi dell'elemento. |
Andata e ritorno
Text
: 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/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the background color of the first 3 characters in the // document 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' ). |
Andata e ritorno
Text
: 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 dello sfondo, formattato in notazione CSS (ad es. '#ffffff' ) |
Andata e ritorno
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 |
Andata e ritorno
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/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the first 11 characters in the document 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 | L'impostazione in grassetto. |
Andata e ritorno
Text
: 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 dal menu Caratteri in Documenti o Google Fonts ed è sensibile alle maiuscole.
I nomi dei caratteri non riconosciuti verranno visualizzati come DICOM. I metodi getFontFamily(offset)
e setFontFamily(fontFamilyName)
ora utilizzano nomi di stringhe per i caratteri anziché l'enumerazione
. Anche se questa enumerazione è deprecata, rimarrà disponibile per 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/abc123456/edit'); // Gets body of the document. const body = doc.getBody(); // Sets the font of the first 4 characters in the document 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, nel menu Caratteri di Documenti o Google Fonts. |
Andata e ritorno
Text
: 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 dal menu Caratteri di Documenti o Google Fonts ed è sensibile alle maiuscole. I nomi dei caratteri non riconosciuti verranno visualizzati come DICOM. I metodi getFontFamily()
e setFontFamily(fontFamilyName)
ora utilizzano nomi di stringhe per i caratteri anziché l'enumerazione
. Anche se questa enumerazione è deprecata, rimarrà disponibile per la compatibilità con gli script precedenti.FontFamily
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontFamilyName | String | Il nome della famiglia di caratteri, nel menu Caratteri di Documenti o Google Fonts |
Andata e ritorno
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/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the size of the first 11 characters in the document 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 | La dimensione del carattere. |
Andata e ritorno
Text
: 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 |
Andata e ritorno
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 in 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/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the foreground color of the first 2 characters in the // document body to hex color #FF0000. const text = body.editAsText().setForegroundColor(0, 1, '#FF0000'); // Gets the foreground color for the second character in the document 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' ). |
Andata e ritorno
Text
: 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 in primo piano.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | il colore in primo piano, formattato in notazione CSS (ad es. '#ffffff' ) |
Andata e ritorno
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)
Imposta l'impostazione del corsivo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
italic | Boolean | l'impostazione del corsivo |
Andata e ritorno
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)
Imposta l'impostazione del 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/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the first 11 characters in the document 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 | L'impostazione del corsivo. |
Andata e ritorno
Text
: 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/abc123456/edit'); // Gets the document body. const body = doc.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. |
Andata e ritorno
Text
: 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 |
Andata e ritorno
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 barrata.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
strikethrough | Boolean | l'impostazione barrata |
Andata e ritorno
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 impostare l'impostazione barrata 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/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the first 11 characters in the document 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 barrata. |
Andata e ritorno
Text
: 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)
Consente di impostare 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/abc123456/edit'); // Gets the document body. const body = doc.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 del testo. |
Andata e ritorno
Text
: 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 be superscript. var text = DocumentApp.getActiveDocument().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. |
Andata e ritorno
Text
: elemento corrente.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setTextAlignment(textAlignment)
Imposta l'allineamento del testo. I tipi di allineamento disponibili sono DocumentApp.TextAlignment.NORMAL
, DocumentApp.TextAlignment.SUBSCRIPT
e DocumentApp.TextAlignment.SUPERSCRIPT
.
// Make the entire first paragraph be superscript. var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
textAlignment | TextAlignment | il tipo di allineamento del testo da applicare |
Andata e ritorno
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 di sottolineatura.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
underline | Boolean | l'impostazione della sottolineatura |
Andata e ritorno
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 impostare 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/abc123456/edit'); // Gets the document body. const body = doc.getBody(); // Sets the first 11 characters in the document 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 sottolineato. |
Andata e ritorno
Text
: 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