Class Range

Rango

Un rango de elementos en un documento. La selección del usuario se representa como un elemento Range, entre otros usos. Las secuencias de comandos solo pueden acceder a la selección del usuario que ejecuta la secuencia de comandos, y solo si está vinculada al 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étodoTipo de datos que se muestraDescripción breve
getRangeElements()RangeElement[]Obtiene todos los elementos de esta Range, incluidos los elementos Text parciales (por ejemplo, en el caso de una selección que incluye solo una parte de un elemento Text).

Documentación detallada

getRangeElements()

Obtiene todos los elementos de esta Range, incluidos los elementos Text parciales (por ejemplo, en el caso de una selección que incluye solo una parte de un elemento Text). Para determinar si un elemento Text solo se incluye parcialmente en el rango, consulta RangeElement.isPartial().

Devolvedor

RangeElement[]: Es un array de elementos, en el orden en que aparecen en el documento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

Métodos obsoletos