Un objeto Range que tiene un nombre y un ID para permitir la recuperación posterior Los nombres no son necesariamente únicos; varios rangos diferentes en el mismo documento pueden compartir el mismo nombre, al igual que una clase en HTML. En cambio, los ID son únicos dentro del documento, como un ID en HTML. Una vez que se agrega un NamedRange a un documento, no se puede modificar, solo se puede quitar.
Se puede acceder a un NamedRange desde cualquier secuencia de comandos que acceda al documento. Para evitar conflictos no deseados entre las secuencias de comandos, considera usar una string única como prefijo a los nombres de los rangos.
// Create a named range that includes every table in the document.
var doc = DocumentApp.getActiveDocument();
var rangeBuilder = doc.newRange();
var tables = doc.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
rangeBuilder.addElement(tables[i]);
}
doc.addNamedRange('myUniquePrefix-tables', rangeBuilder.build());
Métodos
| Método | Tipo de datos que se muestra | Descripción breve |
|---|---|---|
getId() | String | Obtiene el ID de este NamedRange. |
getName() | String | Obtiene el nombre de este NamedRange. |
getRange() | Range | Obtiene el rango de elementos asociados con este NamedRange. |
remove() | void | Quita este NamedRange del documento. |
Documentación detallada
getId()
Obtiene el ID de este NamedRange. El ID es único dentro del documento.
Volver
String: el ID del rango, que es único dentro del documento
getName()
Obtiene el nombre de este NamedRange. El nombre no es necesariamente único.
Volver
String: el nombre del rango, que no es necesariamente único
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
getRange()
Obtiene el rango de elementos asociados con este NamedRange.
Volver
Range: Es el rango de elementos asociados con el nombre y el ID.
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
remove()
Quita este NamedRange del documento. Este método no borra el contenido del rango; simplemente quita la referencia. Llamar a este método en un NamedRange que ya se quitó no tiene ningún efecto.
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