Class RangeBuilder

RangeBuilder

Es un compilador que se usa para construir objetos Range a partir de elementos de documentos. 

// Change the user's selection to a range that includes every table in the
// active tab.
const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const rangeBuilder = documentTab.newRange();
const tables = documentTab.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());

Métodos

MétodoTipo de datos que se devuelveDescripción breve
addElement(element)RangeBuilderAgrega un Element completo a este RangeBuilder.
addElement(textElement, startOffset, endOffsetInclusive)RangeBuilderAgrega un elemento parcial Text a este RangeBuilder.
addElementsBetween(startElement, endElementInclusive)RangeBuilderAgrega dos elementos completos y todos los elementos que se encuentran entre ellos a este RangeBuilder.
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)RangeBuilderAgrega dos elementos Text parciales y todos los elementos que se encuentran entre ellos al RangeBuilder.
addRange(range)RangeBuilderAgrega el contenido de otro Range a este RangeBuilder.
build()RangeConstruye un Range a partir de la configuración aplicada al compilador.
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

addElement(element)

Agrega un Element completo a este RangeBuilder.

Parámetros

NombreTipoDescripción
elementElementel elemento que se agregará

Volver

RangeBuilder : Este compilador, para el encadenamiento

Autorización

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

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

addElement(textElement, startOffset, endOffsetInclusive)

Agrega un elemento Text parcial a este RangeBuilder.

Parámetros

NombreTipoDescripción
textElementTextel elemento de texto que se agregará parcialmente
startOffsetIntegerla cantidad de caracteres antes del primer carácter que se incluirá (es decir, el índice del primer carácter en el rango)
endOffsetInclusiveIntegerla cantidad de caracteres antes del último carácter que se incluirá (es decir, el índice del último carácter en el rango)

Volver

RangeBuilder : Este compilador, para el encadenamiento

Autorización

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

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

addElementsBetween(startElement, endElementInclusive)

Agrega dos elementos completos y todos los elementos que se encuentran entre ellos a este RangeBuilder.

Parámetros

NombreTipoDescripción
startElementElementel primer elemento que se agregará
endElementInclusiveElementel último elemento que se agregará

Volver

RangeBuilder : Este compilador, para el encadenamiento

Autorización

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

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

addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)

Agrega dos elementos Text parciales y todos los elementos que se encuentran entre ellos al RangeBuilder.

Parámetros

NombreTipoDescripción
startTextElementTextel primer elemento de texto que se agregará parcialmente
startOffsetIntegerla cantidad de caracteres antes del primer carácter de startTextElement que se incluirá (es decir, el índice del primer carácter en el rango)
endTextElementInclusiveTextel último elemento de texto que se agregará parcialmente
endOffsetInclusiveIntegerla cantidad de caracteres antes del último carácter de endTextElementInclusive que se incluirá (es decir, el índice del último carácter en el rango)

Volver

RangeBuilder : Este compilador, para el encadenamiento

Autorización

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

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

addRange(range)

Agrega el contenido de otro Range a este RangeBuilder.

Parámetros

NombreTipoDescripción
rangeRangeel rango cuyos elementos se deben agregar

Volver

RangeBuilder : Este compilador, para el encadenamiento

Autorización

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

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

build()

Construye un Range a partir de la configuración aplicada al compilador.

Volver

Range : El rango recién construido

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 elemento Text solo se incluye parcialmente en el rango, consulta RangeElement.isPartial().

Volver

RangeElement[] : 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 permisos:

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

Métodos obsoletos