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 apenas se o script estiver vinculado ao documento.
// Bold all selected text. var selection = DocumentApp.getActiveDocument().getSelection(); if (selection) { var elements = selection.getRangeElements(); for (var i = 0; i < elements.length; i++) { var element = elements[i]; // Only modify elements that can be edited as text; skip images and other non-text elements. if (element.getElement().editAsText) { var 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 todos os elementos Text parciais (por exemplo, no caso
de uma seleção que inclua apenas parte de um elemento Text ). |
Documentação detalhada
getRangeElements()
Recebe todos os elementos nesse Range
, incluindo todos os elementos Text
parciais (por exemplo, no caso
de uma seleção que inclua apenas parte de um elemento Text
). Para determinar se um
elemento Text
foi incluído apenas parcialmente no intervalo, consulte RangeElement.isPartial()
.
Retorno
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