Class Range

Rango

Es un rango de elementos en un documento. La selección del usuario se representa como un Range, entre para otros usos. Las secuencias de comandos solo pueden acceder a la selección del usuario que las ejecuta y solo si están vinculadas 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 este 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 este 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 El elemento Text solo se incluye parcialmente en el rango; consulta RangeElement.isPartial().

Volver

RangeElement[]: Es un array de elementos, en el orden en el 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