Class RangeElement

IntervalloElemento

Un wrapper per un Element con un possibile offset di inizio e di 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	Recupera il Element corrispondente a questo RangeElement.
getEndOffsetInclusive()	Integer	Recupera la posizione della fine di un intervallo parziale all'interno dell'elemento intervallo.
getStartOffset()	Integer	Recupera la posizione dell'inizio di un intervallo parziale all'interno dell'elemento intervallo.
isPartial()	Boolean	Determina se questo elemento intervallo copre l'intero elemento o una selezione parziale dei caratteri dell'elemento.

Documentazione dettagliata

getElement()

Recupera il Element corrispondente 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.');
}

Invio

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()

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

Invio

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()

Recupera la posizione dell'inizio di un intervallo parziale all'interno dell'elemento 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 nell'intervallo); in ogni altro caso, questo metodo restituisce -1.

Invio

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 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().

Invio

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