Class Range

Rango

Es un rango de elementos en un documento. La selección del usuario se representa como un Range, entre 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.
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 datos que se muestra	Descripció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 parte de un elemento Text).

Métodos obsoletos

Método	Tipo de datos que se muestra	Descripción breve
getSelectedElements()	RangeElement[]	Obtiene todos los elementos que el usuario seleccionó en la instancia abierta del documento, incluidos los elementos Text seleccionados de forma parcial.

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 parte de un elemento Text). Para determinar si un elemento Text solo se incluye de forma parcial en el rango, consulta RangeElement.isPartial().

Volver

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 ámbitos:

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

Métodos obsoletos

getSelectedElements()

Obsoleto. Se cambió el nombre a getRangeElements()

Obtiene todos los elementos que el usuario seleccionó en la instancia abierta del documento, incluidos los elementos Text seleccionados de forma parcial.

Volver

RangeElement[]: Es un array de elementos seleccionados o parcialmente seleccionados, 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 ámbitos:

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