Class Text

Testo

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

MetodoTipo restituitoBreve descrizione
appendText(text)TextAggiunge il testo specificato alla fine di questa regione di testo.
copy()TextRestituisce una copia separata e profonda dell'elemento corrente.
deleteText(startOffset, endOffsetInclusive)TextConsente di eliminare un intervallo di testo.
editAsText()TextPermette di ottenere una versione Text dell'elemento corrente per la modifica.
findText(searchPattern)RangeElementCerca i contenuti dell'elemento in base al pattern di testo specificato utilizzando espressioni regolari.
findText(searchPattern, from)RangeElementCerca i contenuti dell'elemento in base al pattern di testo specificato, a partire da un determinato risultato di ricerca.
getAttributes()ObjectRecupera gli attributi dell'elemento.
getAttributes(offset)ObjectRecupera gli attributi con l'offset di caratteri specificato.
getBackgroundColor()StringRecupera l'impostazione del colore di sfondo.
getBackgroundColor(offset)StringRecupera il colore di sfondo con l'offset di caratteri specificato.
getFontFamily()StringRecupera l'impostazione della famiglia di caratteri.
getFontFamily(offset)StringRecupera la famiglia di caratteri all'offset del carattere specificato.
getFontSize()NumberRecupera l'impostazione delle dimensioni del carattere.
getFontSize(offset)NumberRecupera le dimensioni dei caratteri con l'offset di caratteri specificato.
getForegroundColor()StringRecupera l'impostazione del colore in primo piano.
getForegroundColor(offset)StringRecupera il colore in primo piano all'offset del carattere specificato.
getLinkUrl()StringRecupera l'URL del link.
getLinkUrl(offset)StringRecupera l'URL del link all'offset del carattere specificato.
getNextSibling()ElementRecupera l'elemento di pari livello successivo dell'elemento.
getParent()ContainerElementRecupera l'elemento principale dell'elemento.
getPreviousSibling()ElementRecupera l'elemento di pari livello precedente dell'elemento.
getText()StringRecupera i contenuti dell'elemento come stringa di testo.
getTextAlignment()TextAlignmentVisualizza l'allineamento del testo.
getTextAlignment(offset)TextAlignmentVisualizza 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()ElementTypeRecupera il ElementType dell'elemento.
insertText(offset, text)TextConsente di inserire il testo specificato con l'offset di un determinato carattere.
isAtDocumentEnd()BooleanDetermina se l'elemento si trova alla fine di Document.
isBold()BooleanRecupera l'impostazione in grassetto.
isBold(offset)BooleanRecupera l'impostazione in grassetto all'offset del carattere specificato.
isItalic()BooleanRecupera l'impostazione del corsivo.
isItalic(offset)BooleanRecupera l'impostazione del corsivo all'offset del carattere specificato.
isStrikethrough()BooleanRecupera l'impostazione barrata.
isStrikethrough(offset)BooleanRecupera l'impostazione barrata con l'offset del carattere specificato.
isUnderline()BooleanRecupera l'impostazione di sottolineatura.
isUnderline(offset)BooleanRecupera l'impostazione della sottolineatura all'offset del carattere specificato.
merge()TextUnisce l'elemento con il precedente elemento di pari livello dello stesso tipo.
removeFromParent()TextRimuove l'elemento dall'elemento principale.
replaceText(searchPattern, replacement)ElementSostituisce tutte le occorrenze di un determinato pattern di testo con una determinata stringa di sostituzione, utilizzando espressioni regolari.
setAttributes(startOffset, endOffsetInclusive, attributes)TextApplica gli attributi specificati all'intervallo di caratteri specificato.
setAttributes(attributes)TextImposta gli attributi dell'elemento.
setBackgroundColor(startOffset, endOffsetInclusive, color)TextImposta il colore di sfondo per l'intervallo di caratteri specificato.
setBackgroundColor(color)TextImposta il colore dello sfondo.
setBold(bold)TextConsente di impostare il grassetto.
setBold(startOffset, endOffsetInclusive, bold)TextConsente di impostare il grassetto per l'intervallo di caratteri specificato.
setFontFamily(startOffset, endOffsetInclusive, fontFamilyName)TextImposta la famiglia di caratteri per l'intervallo di caratteri specificato.
setFontFamily(fontFamilyName)TextImposta la famiglia di caratteri.
setFontSize(startOffset, endOffsetInclusive, size)TextImposta la dimensione del carattere per l'intervallo di caratteri specificato.
setFontSize(size)TextImposta la dimensione del carattere.
setForegroundColor(startOffset, endOffsetInclusive, color)TextImposta il colore in primo piano per l'intervallo di caratteri specificato.
setForegroundColor(color)TextImposta il colore in primo piano.
setItalic(italic)TextImposta l'impostazione del corsivo.
setItalic(startOffset, endOffsetInclusive, italic)TextImposta l'impostazione del corsivo per l'intervallo di caratteri specificato.
setLinkUrl(startOffset, endOffsetInclusive, url)TextImposta l'URL del link per l'intervallo di caratteri specificato.
setLinkUrl(url)TextImposta l'URL del link.
setStrikethrough(strikethrough)TextConsente di impostare l'impostazione barrata.
setStrikethrough(startOffset, endOffsetInclusive, strikethrough)TextConsente di impostare l'impostazione barrata per l'intervallo di caratteri specificato.
setText(text)TextConsente di impostare i contenuti del testo.
setTextAlignment(startOffset, endOffsetInclusive, textAlignment)TextImposta l'allineamento del testo per un determinato intervallo di caratteri.
setTextAlignment(textAlignment)TextImposta l'allineamento del testo.
setUnderline(underline)TextConsente di impostare l'impostazione di sottolineatura.
setUnderline(startOffset, endOffsetInclusive, underline)TextConsente 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

NomeTipoDescrizione
textStringIl 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

NomeTipoDescrizione
startOffsetIntegerL'offset del primo carattere da eliminare.
endOffsetInclusiveIntegerLa 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

NomeTipoDescrizione
searchPatternStringil 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

NomeTipoDescrizione
searchPatternStringil pattern da cercare
fromRangeElementil 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

NomeTipoDescrizione
offsetIntegerL'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

NomeTipoDescrizione
offsetIntegerL'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 FontFamily. Anche se questa enumerazione è deprecata, rimarrà disponibile per la compatibilità con gli script precedenti.

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 FontFamily. Anche se questa enumerazione è deprecata, rimarrà disponibile per la compatibilità con gli script precedenti. 

// 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

NomeTipoDescrizione
offsetIntegerL'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

NomeTipoDescrizione
offsetIntegerL'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

NomeTipoDescrizione
offsetIntegerL'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

NomeTipoDescrizione
offsetIntegerL'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

NomeTipoDescrizione
offsetIntegerL'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

NomeTipoDescrizione
offsetIntegerLa differenza di caratteri in cui inserire il testo.
textStringIl 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

NomeTipoDescrizione
offsetIntegerL'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

NomeTipoDescrizione
offsetIntegerL'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

NomeTipoDescrizione
offsetIntegerL'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

NomeTipoDescrizione
offsetIntegerL'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

NomeTipoDescrizione
searchPatternStringil pattern specificato dall'espressione regolare per cercare
replacementStringil 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

NomeTipoDescrizione
startOffsetIntegerL'offset iniziale dell'intervallo di testo.
endOffsetInclusiveIntegerL'offset finale dell'intervallo di testo.
attributesObjectGli 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

NomeTipoDescrizione
attributesObjectGli 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

NomeTipoDescrizione
startOffsetIntegerL'offset iniziale dell'intervallo di testo.
endOffsetInclusiveIntegerL'offset finale dell'intervallo di testo.
colorStringIl 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

NomeTipoDescrizione
colorStringil 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

NomeTipoDescrizione
boldBooleanl'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

NomeTipoDescrizione
startOffsetIntegerL'offset iniziale dell'intervallo di testo.
endOffsetInclusiveIntegerL'offset finale dell'intervallo di testo.
boldBooleanL'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 FontFamily. Anche se questa enumerazione è deprecata, rimarrà disponibile per la compatibilità con gli script precedenti. 

// 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

NomeTipoDescrizione
startOffsetIntegerL'offset iniziale dell'intervallo di testo.
endOffsetInclusiveIntegerL'offset finale dell'intervallo di testo.
fontFamilyNameStringIl 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 FontFamily. Anche se questa enumerazione è deprecata, rimarrà disponibile per la compatibilità con gli script precedenti.

Parametri

NomeTipoDescrizione
fontFamilyNameStringIl 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

NomeTipoDescrizione
startOffsetIntegerL'offset iniziale dell'intervallo di testo.
endOffsetInclusiveIntegerL'offset finale dell'intervallo di testo.
sizeNumberLa 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

NomeTipoDescrizione
sizeNumberla 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

NomeTipoDescrizione
startOffsetIntegerL'offset iniziale dell'intervallo di testo.
endOffsetInclusiveIntegerL'offset finale dell'intervallo di testo.
colorStringIl 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

NomeTipoDescrizione
colorStringil 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

NomeTipoDescrizione
italicBooleanl'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

NomeTipoDescrizione
startOffsetIntegerL'offset iniziale dell'intervallo di testo.
endOffsetInclusiveIntegerL'offset finale dell'intervallo di testo.
italicBooleanL'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

NomeTipoDescrizione
startOffsetIntegerL'offset iniziale dell'intervallo di testo.
endOffsetInclusiveIntegerL'offset finale dell'intervallo di testo.
urlStringL'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

NomeTipoDescrizione
urlStringl'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

NomeTipoDescrizione
strikethroughBooleanl'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

NomeTipoDescrizione
startOffsetIntegerL'offset iniziale dell'intervallo di testo.
endOffsetInclusiveIntegerL'offset finale dell'intervallo di testo.
strikethroughBooleanL'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

NomeTipoDescrizione
textStringI 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

NomeTipoDescrizione
startOffsetIntegerL'offset iniziale dell'intervallo di caratteri.
endOffsetInclusiveIntegerL'offset finale dell'intervallo di caratteri (incluso).
textAlignmentTextAlignmentIl 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

NomeTipoDescrizione
textAlignmentTextAlignmentil 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

NomeTipoDescrizione
underlineBooleanl'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

NomeTipoDescrizione
startOffsetIntegerL'offset iniziale dell'intervallo di testo.
endOffsetInclusiveIntegerL'offset finale dell'intervallo di testo.
underlineBooleanL'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