Class Range

Intervalo

Um intervalo de elementos em um documento. A seleção do usuário é representada como um Range, entre outros usos. Os scripts só podem acessar a seleção do usuário que está executando o script e somente se o script estiver vinculado ao documento.

// Bold all selected text.
const selection = DocumentApp.getActiveDocument().getSelection();
if (selection) {
  const elements = selection.getRangeElements();
  for (let i = 0; i < elements.length; i++) {
    const element = elements[i];

    // Only modify elements that can be edited as text; skip images and other
    // non-text elements.
    if (element.getElement().editAsText) {
      const text = element.getElement().editAsText();

      // Bold the selected part of the element, or the full element if it's
      // completely selected.
      if (element.isPartial()) {
        text.setBold(
            element.getStartOffset(),
            element.getEndOffsetInclusive(),
            true,
        );
      } else {
        text.setBold(true);
      }
    }
  }
}

Métodos

Método	Tipo de retorno	Breve descrição
getRangeElements()	RangeElement[]	Recebe todos os elementos nesse Range, incluindo elementos Text parciais (por exemplo, no caso de uma seleção que inclui apenas parte de um elemento Text).

Métodos obsoletos

Método	Tipo de retorno	Breve descrição
getSelectedElements()	RangeElement[]	Recebe todos os elementos que o usuário selecionou na instância aberta do documento, incluindo elementos Text parcialmente selecionados.

Documentação detalhada

getRangeElements()

Recebe todos os elementos nesse Range, incluindo elementos Text parciais (por exemplo, no caso de uma seleção que inclui apenas parte de um elemento Text). Para determinar se um elemento Text está incluído apenas parcialmente no intervalo, consulte RangeElement.isPartial().

Retornar

RangeElement[] — uma matriz de elementos, na ordem em que aparecem no documento

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

Métodos obsoletos

getSelectedElements()

Obsoleto. Renomeado como getRangeElements().

Recebe todos os elementos que o usuário selecionou na instância aberta do documento, incluindo elementos Text parcialmente selecionados.

Retornar

RangeElement[] — uma matriz de elementos selecionados ou parcialmente selecionados, na ordem em que aparecem no documento

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