Um wrapper em torno de um Element com um possível deslocamento inicial e final. Esses deslocamentos permitem que um
intervalo de caracteres em um elemento Text
seja representado nos resultados da pesquisa, nas seleções de documentos e nos intervalos nomeados.
Métodos
| Método | Tipo de retorno | Breve descrição |
|---|---|---|
getElement() | Element | Recebe o Element que corresponde a esse RangeElement. |
getEndOffsetInclusive() | Integer | Extrai a posição do fim de um intervalo parcial dentro do elemento do intervalo. |
getStartOffset() | Integer | Extrai a posição do início de um intervalo parcial dentro do elemento de intervalo. |
isPartial() | Boolean | Determina se esse elemento de intervalo cobre o elemento inteiro ou uma seleção parcial dos caracteres do elemento. |
Documentação detalhada
getElement()
Recebe o Element que corresponde a esse 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.');
}
Retorno
Element: o elemento que corresponde a essa RangeElement.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getEndOffsetInclusive()
Extrai a posição do fim de um intervalo parcial dentro do elemento do intervalo. Se o elemento for Text e isPartial() retornar true, o deslocamento será o número de caracteres antes do último caractere no intervalo (ou seja, o índice do último caractere no intervalo). Em qualquer outro caso, esse método retornará -1.
Retorno
Integer: para elementos Text, o número de caracteres antes do último caractere no intervalo. Para outros elementos, -1
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getStartOffset()
Extrai a posição do início de um intervalo parcial dentro do elemento de intervalo. Se o elemento for Text e isPartial() retornar true, o deslocamento será o número de caracteres antes do início do intervalo (ou seja, o índice do primeiro caractere no intervalo). Em qualquer outro caso, esse método retornará -1.
Retorno
Integer: para elementos Text, o
número de caracteres antes do início do intervalo. Para outros elementos, -1
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
isPartial()
Determina se esse elemento de intervalo cobre o elemento inteiro ou uma seleção parcial dos
caracteres do elemento. O início e o fim do intervalo de um elemento de intervalo parcial podem ser
determinados usando getStartOffset() e getEndOffsetInclusive(), respectivamente.
Retorno
Boolean: true se o elemento estiver parcialmente incluído; false se não for
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents