Questa pagina è stata tradotta dall'API Cloud Translation.

Interface Element

Un elemento generico. I contenuti di Document sono rappresentati come elementi. Ad esempio, ListItem, Paragraph e Table sono elementi e ereditano tutti i metodi definiti da Element, come getType().

Implementazione di classi

Nome	Breve descrizione
`Body`	I contenuti di una scheda in un documento di Documenti Google.
`ContainerElement`	Un elemento generico che può contenere altri elementi.
`Date`	Un elemento che rappresenta una data formattata
`Equation`	Un elemento che rappresenta un'espressione matematica.
`EquationFunction`	Un elemento che rappresenta una funzione in un `Equation` matematico.
`EquationFunctionArgumentSeparator`	Un elemento che rappresenta un separatore di funzioni in un `Equation` matematico.
`EquationSymbol`	Un elemento che rappresenta un simbolo in un `Equation` matematico.
`FooterSection`	Un elemento che rappresenta una sezione del piè di pagina.
`Footnote`	Un elemento che rappresenta una nota a piè di pagina.
`FootnoteSection`	Un elemento che rappresenta una sezione di note a piè di pagina.
`HeaderSection`	Un elemento che rappresenta una sezione di intestazione.
`HorizontalRule`	Un elemento che rappresenta una linea orizzontale.
`InlineDrawing`	Un elemento che rappresenta un disegno incorporato.
`InlineImage`	Un elemento che rappresenta un'immagine incorporata.
`ListItem`	Un elemento che rappresenta un elemento dell'elenco.
`PageBreak`	Un elemento che rappresenta un'interruzione di pagina.
`Paragraph`	Un elemento che rappresenta un paragrafo.
`Person`	Un elemento che rappresenta un link a una persona.
`RichLink`	Un elemento che rappresenta un link a una risorsa Google, ad esempio un file di Drive o un video di YouTube.
`Table`	Un elemento che rappresenta una tabella.
`TableCell`	Un elemento che rappresenta una cella di tabella.
`TableOfContents`	Un elemento contenente un sommario.
`TableRow`	Un elemento che rappresenta una riga di una tabella.
`Text`	Un elemento che rappresenta una regione di testo avanzato.
`UnsupportedElement`	Un elemento che rappresenta una regione sconosciuta o che non può essere interessata da uno script, ad esempio un numero di pagina.

Metodi

Metodo	Tipo restituito	Breve descrizione
`asBody()`	`Body`	Restituisce l'elemento corrente come `Body`.
`asDate()`	`Date`	Restituisce l'elemento corrente come `Date`.
`asEquation()`	`Equation`	Restituisce l'elemento corrente come `Equation`.
`asEquationFunction()`	`EquationFunction`	Restituisce l'elemento corrente come `EquationFunction`.
`asEquationFunctionArgumentSeparator()`	`EquationFunctionArgumentSeparator`	Restituisce l'elemento corrente come `EquationFunctionArgumentSeparator`.
`asEquationSymbol()`	`EquationSymbol`	Restituisce l'elemento corrente come `EquationSymbol`.
`asFooterSection()`	`FooterSection`	Restituisce l'elemento corrente come `FooterSection`.
`asFootnote()`	`Footnote`	Restituisce l'elemento corrente come `Footnote`.
`asFootnoteSection()`	`FootnoteSection`	Restituisce l'elemento corrente come `FootnoteSection`.
`asHeaderSection()`	`HeaderSection`	Restituisce l'elemento corrente come `HeaderSection`.
`asHorizontalRule()`	`HorizontalRule`	Restituisce l'elemento corrente come `HorizontalRule`.
`asInlineDrawing()`	`InlineDrawing`	Restituisce l'elemento corrente come `InlineDrawing`.
`asInlineImage()`	`InlineImage`	Restituisce l'elemento corrente come `InlineImage`.
`asListItem()`	`ListItem`	Restituisce l'elemento corrente come `ListItem`.
`asPageBreak()`	`PageBreak`	Restituisce l'elemento corrente come `PageBreak`.
`asParagraph()`	`Paragraph`	Restituisce l'elemento corrente come `Paragraph`.
`asPerson()`	`Person`	Restituisce l'elemento corrente come `Person`.
`asRichLink()`	`RichLink`	Restituisce l'elemento corrente come `RichLink`, ad esempio un link a un file di Fogli Google.
`asTable()`	`Table`	Restituisce l'elemento corrente come `Table`.
`asTableCell()`	`TableCell`	Restituisce l'elemento corrente come `TableCell`.
`asTableOfContents()`	`TableOfContents`	Restituisce l'elemento corrente come `TableOfContents`.
`asTableRow()`	`TableRow`	Restituisce l'elemento corrente come `TableRow`.
`asText()`	`Text`	Restituisce l'elemento corrente come `Text`.
`copy()`	`Element`	Restituisce una copia approfondita e scollegata dell'elemento corrente.
`getAttributes()`	`Object`	Recupera gli attributi dell'elemento.
`getNextSibling()`	`Element`	Recupera l'elemento successivo associato all'elemento.
`getParent()`	`ContainerElement`	Recupera l'elemento principale dell'elemento.
`getPreviousSibling()`	`Element`	Recupera l'elemento precedente associato all'elemento.
`getType()`	`ElementType`	Recupera il `ElementType` dell'elemento.
`isAtDocumentEnd()`	`Boolean`	Determina se l'elemento è alla fine del `Document`.
`merge()`	`Element`	Unisce l'elemento all'elemento precedente dello stesso tipo.
`removeFromParent()`	`Element`	Rimuove l'elemento dal relativo elemento principale.
`setAttributes(attributes)`	`Element`	Imposta gli attributi dell'elemento.

Documentazione dettagliata

`asBody()`

Restituisce l'elemento corrente come Body.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

Body: 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

`asDate()`

Restituisce l'elemento corrente come Date.

Quando sai che un elemento è un Date, utilizza questo metodo per impostarne il tipo come Date. In questo modo, il completamento automatico nell'editor di Apps Script mostra i metodi che puoi utilizzare con un Date.

Invio

Date: l'elemento corrente con il tipo impostato su Date.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`asEquation()`

Restituisce l'elemento corrente come Equation.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

Equation: 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

`asEquationFunction()`

Restituisce l'elemento corrente come EquationFunction.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

EquationFunction: 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

`asEquationFunctionArgumentSeparator()`

Restituisce l'elemento corrente come EquationFunctionArgumentSeparator.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

EquationFunctionArgumentSeparator: 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

`asEquationSymbol()`

Restituisce l'elemento corrente come EquationSymbol.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

EquationSymbol: 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

`asFooterSection()`

Restituisce l'elemento corrente come FooterSection.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

FooterSection: 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

`asFootnote()`

Restituisce l'elemento corrente come Footnote.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

Footnote: 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

`asFootnoteSection()`

Restituisce l'elemento corrente come FootnoteSection.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

FootnoteSection: 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

`asHeaderSection()`

Restituisce l'elemento corrente come HeaderSection.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

HeaderSection: 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

`asHorizontalRule()`

Restituisce l'elemento corrente come HorizontalRule.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

HorizontalRule: 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

`asInlineDrawing()`

Restituisce l'elemento corrente come InlineDrawing.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

InlineDrawing: 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

`asInlineImage()`

Restituisce l'elemento corrente come InlineImage.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

InlineImage: 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

`asListItem()`

Restituisce l'elemento corrente come ListItem.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

ListItem: 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

`asPageBreak()`

Restituisce l'elemento corrente come PageBreak.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

PageBreak: 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

`asParagraph()`

Restituisce l'elemento corrente come Paragraph.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

Paragraph: l'elemento corrente.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`asPerson()`

Restituisce l'elemento corrente come Person.

Quando sai che un elemento è un Person, utilizza questo metodo per impostarne il tipo come persona. In questo modo, il completamento automatico nell'editor di Apps Script mostra i metodi che puoi utilizzare con un elemento person.

Invio

Person: l'elemento corrente con il tipo impostato su Person.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`asRichLink()`

Restituisce l'elemento corrente come RichLink, ad esempio un link a un file di Fogli Google.

Quando sai che un elemento è un RichLink, utilizza questo metodo per impostarne il tipo come RichLink. In questo modo, il completamento automatico nell'editor di Apps Script mostra i metodi che puoi utilizzare con un RichLink.

Invio

RichLink: l'elemento corrente con il tipo impostato su RichLink.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`asTable()`

Restituisce l'elemento corrente come Table.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

Table: l'elemento corrente.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`asTableCell()`

Restituisce l'elemento corrente come TableCell.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

TableCell: 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

`asTableOfContents()`

Restituisce l'elemento corrente come TableOfContents.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

TableOfContents: 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

`asTableRow()`

Restituisce l'elemento corrente come TableRow.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

TableRow: 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

`asText()`

Restituisce l'elemento corrente come Text.

Utilizza questo metodo per facilitare il completamento automatico ogni volta che è noto che un determinato elemento appartiene a un tipo specifico.

Invio

Text: l'elemento corrente.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`copy()`

Restituisce una copia approfondita e scollegata dell'elemento corrente.

Vengono copiati anche gli eventuali elementi secondari presenti nell'elemento. Il nuovo elemento non ha un elemento primario.

Invio

Element: 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

`getAttributes()`

Recupera gli attributi dell'elemento.

Il risultato è un oggetto contenente una proprietà per ogni attributo elemento valido, in cui ogni nome della proprietà corrisponde a un elemento dell'enumerazione DocumentApp.Attribute.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Append a styled paragraph.
const par = body.appendParagraph('A bold, italicized paragraph.');
par.setBold(true);
par.setItalic(true);

// Retrieve the paragraph's attributes.
const atts = par.getAttributes();

// Log the paragraph attributes.
for (const att in atts) {
  Logger.log(`${att}:${atts[att]}`);
}

Invio

Object: gli attributi dell'elemento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getNextSibling()`

Recupera l'elemento successivo associato all'elemento.

L'elemento successivo ha lo stesso elemento principale e segue l'elemento corrente.

Invio

Element: l'elemento successivo associato.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getParent()`

Recupera l'elemento principale dell'elemento.

L'elemento principale contiene l'elemento corrente.

Invio

ContainerElement: l'elemento principale.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getPreviousSibling()`

Recupera l'elemento precedente associato all'elemento.

L'elemento precedente associato ha lo stesso elemento principale e precede l'elemento corrente.

Invio

Element: l'elemento precedente associato.

Autorizzazione

Gli script che utilizzano questo 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.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Obtain the first element in the active tab's body.

const firstChild = body.getChild(0);

// Use getType() to determine the element's type.
if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) {
  Logger.log('The first element is a paragraph.');
} else {
  Logger.log('The first element is not a paragraph.');
}

Invio

ElementType: il tipo di elemento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`isAtDocumentEnd()`

Determina se l'elemento è alla fine del Document.

Invio

Boolean: indica se l'elemento si trova alla fine della scheda.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`merge()`

Unisce l'elemento all'elemento precedente dello stesso tipo.

È possibile unire solo elementi dello stesso ElementType. Tutti gli elementi secondari contenuti nell'elemento corrente vengono spostati nell'elemento precedente associato.

L'elemento corrente viene rimosso dal documento.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Example 1: Merge paragraphs
// Append two paragraphs to the document's active tab.
const par1 = body.appendParagraph('Paragraph 1.');
const par2 = body.appendParagraph('Paragraph 2.');
// Merge the newly added paragraphs into a single paragraph.
par2.merge();

// Example 2: Merge table cells
// Create a two-dimensional array containing the table's cell contents.
const cells = [
  ['Row 1, Cell 1', 'Row 1, Cell 2'],
  ['Row 2, Cell 1', 'Row 2, Cell 2'],
];
// Build a table from the array.
const table = body.appendTable(cells);
// Get the first row in the table.
const row = table.getRow(0);
// Get the two cells in this row.
const cell1 = row.getCell(0);
const cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
const merged = cell2.merge();

Invio

Element: 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 dal relativo elemento principale.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Remove all images in the active tab's body.
const imgs = body.getImages();
for (let i = 0; i < imgs.length; i++) {
  imgs[i].removeFromParent();
}

Invio

Element: 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

`setAttributes(attributes)`

Imposta gli attributi dell'elemento.

Il parametro degli attributi specificato deve essere un oggetto in cui ogni nome della proprietà è un elemento dell'enumerazione DocumentApp.Attribute e ogni valore della proprietà è il nuovo valore da applicare.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Define a custom paragraph style.
const style = {};
style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] =
    DocumentApp.HorizontalAlignment.RIGHT;
style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri';
style[DocumentApp.Attribute.FONT_SIZE] = 18;
style[DocumentApp.Attribute.BOLD] = true;

// Append a plain paragraph.
const par = body.appendParagraph('A paragraph with custom style.');

// Apply the custom style.
par.setAttributes(style);

Parametri

Nome	Tipo	Descrizione
`attributes`	`Object`	Gli attributi dell'elemento.

Invio

Element: l'elemento corrente.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents