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

MetodoTipo restituitoBreve descrizione
getElement()ElementRecupera il Element corrispondente a questo RangeElement.
getEndOffsetInclusive()IntegerRecupera la posizione della fine di un intervallo parziale all'interno dell'elemento intervallo.
getStartOffset()IntegerRecupera la posizione dell'inizio di un intervallo parziale all'interno dell'elemento intervallo.
isPartial()BooleanDetermina 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