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.
var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var rangeBuilder = documentTab.newRange();
var tables = documentTab.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());
Métodos
| Método | Tipo de datos que se muestra | Descripción breve |
|---|---|---|
addElement(element) | RangeBuilder | Agrega un Element completo a este RangeBuilder. |
addElement(textElement, startOffset, endOffsetInclusive) | RangeBuilder | Agrega un elemento Text parcial a este RangeBuilder. |
addElementsBetween(startElement, endElementInclusive) | RangeBuilder | Agrega dos elementos completos, y todos los elementos entre ellos, a este RangeBuilder. |
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive) | RangeBuilder | Agrega dos elementos Text parciales, y todos los elementos entre ellos, a RangeBuilder. |
addRange(range) | RangeBuilder | Agrega el contenido de otro Range a este RangeBuilder. |
build() | Range | Crea 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
| Nombre | Tipo | Descripción |
|---|---|---|
element | Element | el elemento que se agregará |
Volver
RangeBuilder: Este compilador se usa para encadenamiento.
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
addElement(textElement, startOffset, endOffsetInclusive)
Agrega un elemento Text parcial a este RangeBuilder.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
textElement | Text | el elemento de texto que se agregará |
startOffset | Integer | la cantidad de caracteres antes del primer carácter que se incluirá (es decir, el índice del primer carácter del rango) |
endOffsetInclusive | Integer | la cantidad de caracteres antes del último carácter que se incluirá (es decir, el índice del último carácter del rango) |
Volver
RangeBuilder: Este compilador se usa para encadenamiento.
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
addElementsBetween(startElement, endElementInclusive)
Agrega dos elementos completos, y todos los elementos entre ellos, a este RangeBuilder.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
startElement | Element | el primer elemento que se agregará |
endElementInclusive | Element | el último elemento que se agrega |
Volver
RangeBuilder: Este compilador se usa para encadenamiento.
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
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)
Agrega dos elementos Text parciales, y todos los elementos entre ellos, a RangeBuilder.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
startTextElement | Text | el primer elemento de texto que se agregará parcialmente |
startOffset | Integer | la cantidad de caracteres antes del primer carácter de startTextElement que se incluirá (es decir, el índice del primer carácter del rango) |
endTextElementInclusive | Text | el último elemento de texto que se agregó parcialmente |
endOffsetInclusive | Integer | la cantidad de caracteres antes del último carácter de endTextElementInclusive que se incluirá (es decir, el índice del último carácter de la
rango) |
Volver
RangeBuilder: Este compilador se usa para encadenamiento.
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
addRange(range)
Agrega el contenido de otro Range a este RangeBuilder.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
range | Range | el rango cuyos elementos se deben sumar |
Volver
RangeBuilder: Este compilador se usa para encadenamiento.
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
build()
Crea un Range a partir de la configuración aplicada al compilador.
Volver
Range: Es 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
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