Class RangeElement

RangeElement

Un wrapper attorno a un Element con un possibile offset di inizio e fine. Questi offset consentono di rappresentare un intervallo di caratteri all'interno di un elemento Text nei risultati di ricerca, nelle selezioni di documenti e negli intervalli denominati.

Metodi

Metodo	Tipo restituito	Breve descrizione
getElement()	Element	Ottiene il Element che corrisponde a questo RangeElement.
getEndOffsetInclusive()	Integer	Ottiene la posizione della fine di un intervallo parziale all'interno dell'elemento di intervallo.
getStartOffset()	Integer	Ottiene la posizione dell'inizio di un intervallo parziale all'interno dell'elemento di intervallo.
isPartial()	Boolean	Determina se questo elemento di intervallo copre l'intero elemento o una selezione parziale dei caratteri dell'elemento.

Documentazione dettagliata

getElement()

Ottiene il Element che corrisponde a questo RangeElement.

const rangeElement = DocumentApp.getActiveDocument().getSelection().getRangeElements()[0];

// Log debug information about a range element.
Logger.log(`Element type: ${rangeElement.getElement().getType()}`);
if (rangeElement.isPartial()) {
  Logger.log(`The character range begins at ${rangeElement.getStartOffset()}`);
  Logger.log(
      `The character range ends at ${rangeElement.getEndOffsetInclusive()}`,
  );
} else {
  Logger.log('The entire range element is included.');
}

Indietro

Element : l'elemento che corrisponde a questo RangeElement

Autorizzazione

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

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

---

getEndOffsetInclusive()

Ottiene la posizione della fine di un intervallo parziale all'interno dell'elemento di intervallo. Se l'elemento è un elemento Text e isPartial() restituisce true, l'offset è il numero di caratteri prima dell'ultimo carattere dell'intervallo (ovvero l'indice dell'ultimo carattere dell'intervallo); in qualsiasi altro caso, questo metodo restituisce -1.

Indietro

Integer : per gli elementi Text, il numero di caratteri prima dell'ultimo carattere dell'intervallo; per gli altri elementi, -1

Autorizzazione

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

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

---

getStartOffset()

Ottiene la posizione dell'inizio di un intervallo parziale all'interno dell'elemento di intervallo. Se l'elemento è un elemento Text e isPartial() restituisce true, l'offset è il numero di caratteri prima dell'inizio dell'intervallo (ovvero l'indice del primo carattere dell'intervallo); in qualsiasi altro caso, questo metodo restituisce -1.

Indietro

Integer : per gli elementi Text, il numero di caratteri prima dell'inizio dell'intervallo; per gli altri elementi, -1

Autorizzazione

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

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

---

isPartial()

Determina se questo elemento di intervallo copre l'intero elemento o una selezione parziale dei caratteri dell'elemento. L'inizio e la fine dell'intervallo di un elemento di intervallo parziale possono essere determinati utilizzando rispettivamente getStartOffset() e getEndOffsetInclusive().

Indietro

Boolean : true se l'elemento è incluso parzialmente; false in caso contrario

Autorizzazione

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

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