Un wrapper attorno a un Element
con un possibile offset di inizio e fine. Questi offset consentono
intervallo di caratteri all'interno di un Text
da rappresentare nei risultati di ricerca, nelle selezioni dei documenti e negli intervalli denominati.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
getElement() | Element | Restituisce il valore Element che corrisponde a questo RangeElement . |
getEndOffsetInclusive() | Integer | Restituisce la posizione della fine di un intervallo parziale all'interno dell'elemento dell'intervallo. |
getStartOffset() | Integer | Restituisce la posizione dell'inizio di un intervallo parziale all'interno dell'elemento dell'intervallo. |
isPartial() | Boolean | Determina se questo elemento dell'intervallo copre l'intero elemento o una selezione parziale dell'elemento caratteri dell'elemento. |
Documentazione dettagliata
getElement()
Restituisce il valore Element
che corrisponde a questo RangeElement
.
// 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()
Restituisce la posizione della fine di un intervallo parziale all'interno dell'elemento dell'intervallo. Se l'elemento è un
Text
e isPartial()
restituisce true
, l'offset è il numero di caratteri prima dell'ultimo elemento
carattere nell'intervallo (vale a dire l'indice dell'ultimo carattere nell'intervallo); in qualsiasi altra
questo metodo restituisce -1
.
Invio
Integer
: per gli elementi Text
, il valore
numero di carattere prima dell'ultimo carattere nell'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()
Restituisce la posizione dell'inizio di un intervallo parziale all'interno dell'elemento dell'intervallo. Se l'elemento è un
L'elemento Text
e isPartial()
restituisce true
, l'offset è il numero di caratteri precedenti all'inizio di
l'intervallo (ossia l'indice del primo carattere dell'intervallo); in tutti gli altri casi,
restituisce -1
.
Invio
Integer
: per gli elementi Text
, il valore
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 dell'intervallo copre l'intero elemento o una selezione parziale dell'elemento
caratteri dell'elemento. L'inizio e la fine dell'intervallo di un elemento dell'intervallo parziale possono essere
determinato utilizzando, rispettivamente, getStartOffset()
e getEndOffsetInclusive()
.
Invio
Boolean
: true
se l'elemento è parzialmente incluso; 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