Se usó la API de Cloud Translation para traducir esta página.

Class TextRange

Es un segmento del contenido de texto de una Shape o una TableCell.

Si usas métodos que editan la forma en que el texto se ajusta a una forma, se desactivan todas las configuraciones de ajuste automático aplicadas a la forma.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`appendParagraph(text)`	`Paragraph`	Agrega un párrafo al final del rango de texto.
`appendRange(textRange)`	`TextRange`	Agrega una copia del rango de texto proporcionado al final del rango de texto actual.
`appendRange(textRange, matchSourceFormatting)`	`TextRange`	Agrega una copia del rango de texto proporcionado al final del rango de texto actual.
`appendText(text)`	`TextRange`	Agrega texto al final del rango de texto.
`asRenderedString()`	`String`	Muestra el texto procesado que delimita este rango de la forma o celda de tabla asociada en un formato adecuado para mostrarse a los usuarios finales.
`asString()`	`String`	Muestra el texto sin formato limitado por este rango de la forma o celda de tabla asociada.
`clear()`	`void`	Borra el texto delimitado por este rango.
`clear(startOffset, endOffset)`	`void`	Borra el texto delimitado por los desplazamientos de inicio y fin del rango.
`find(pattern)`	`TextRange[]`	Muestra todos los rangos que coinciden con el patrón de búsqueda en el rango de texto actual.
`find(pattern, startOffset)`	`TextRange[]`	Muestra todos los rangos que coinciden con el patrón de búsqueda en el rango de texto actual a partir del desplazamiento de inicio.
`getAutoTexts()`	`AutoText[]`	Muestra los textos automáticos dentro del rango de texto actual.
`getEndIndex()`	`Integer`	Muestra el índice exclusivo basado en 0 para el último carácter de este rango.
`getLength()`	`Integer`	Muestra la cantidad de caracteres de este rango.
`getLinks()`	`TextRange[]`	Muestra una colección de rangos de texto que corresponden a todos los `Link` dentro del rango de texto actual o se superponen con el rango de texto actual.
`getListParagraphs()`	`Paragraph[]`	Muestra los párrafos en listas que se superponen con el rango de texto actual.
`getListStyle()`	`ListStyle`	Muestra el `ListStyle` del rango de texto actual.
`getParagraphStyle()`	`ParagraphStyle`	Muestra el `ParagraphStyle` del rango de texto actual.
`getParagraphs()`	`Paragraph[]`	Muestra los párrafos que se superponen con el rango de texto actual.
`getRange(startOffset, endOffset)`	`TextRange`	Muestra un `TextRange` nuevo que cubre parte del rango del que se deriva.
`getRuns()`	`TextRange[]`	Muestra las ejecuciones de texto que se superponen con el rango de texto actual.
`getStartIndex()`	`Integer`	Muestra el índice inclusivo basado en 0 para el primer carácter de este rango.
`getTextStyle()`	`TextStyle`	Muestra el estilo de texto del rango o `null` si el rango está vacío.
`insertParagraph(startOffset, text)`	`Paragraph`	Inserta un párrafo en el desplazamiento de inicio.
`insertRange(startOffset, textRange)`	`TextRange`	Inserta una copia del rango de texto proporcionado en el desplazamiento de inicio.
`insertRange(startOffset, textRange, matchSourceFormatting)`	`TextRange`	Inserta una copia del rango de texto proporcionado en el desplazamiento de inicio.
`insertText(startOffset, text)`	`TextRange`	Inserta texto en el desplazamiento de inicio.
`isEmpty()`	`Boolean`	Muestra `true` si no hay caracteres en este rango y, de lo contrario, muestra `false`.
`replaceAllText(findText, replaceText)`	`Integer`	Reemplaza todas las instancias de texto que coincidan con texto con reemplazar texto.
`replaceAllText(findText, replaceText, matchCase)`	`Integer`	Reemplaza todas las instancias de texto que coincidan con texto con reemplazar texto.
`select()`	`void`	Selecciona solo la `TextRange` en la presentación activa y quita las selecciones anteriores.
`setText(newText)`	`TextRange`	Establece el texto delimitado por este rango de la forma o celda de tabla asociada.

Documentación detallada

`appendParagraph(text)`

Agrega un párrafo al final del rango de texto. El párrafo mantiene el estilo del final del rango de texto actual.

Para agregar la string de texto proporcionada como párrafo, agrega al menos un carácter de línea nueva circundante a la string.

Cuando la string de texto proporcionada contiene caracteres de saltos de línea (que consisten en varios párrafos), se muestra el párrafo final agregado.

Parámetros

Nombre	Tipo	Descripción
`text`	`String`	String que se agregará como párrafo.

Volver

Paragraph: Es el Paragraph adjunto.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`appendRange(textRange)`

Agrega una copia del rango de texto proporcionado al final del rango de texto actual.

El formato del texto insertado coincidirá con el del texto de origen.

Parámetros

Nombre	Tipo	Descripción
`textRange`	`TextRange`	Rango de texto que se agregará.

Volver

TextRange: Es el rango de texto que representa el texto adjunto.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`appendRange(textRange, matchSourceFormatting)`

Agrega una copia del rango de texto proporcionado al final del rango de texto actual.

Si se configura para que coincida con el formato del texto de destino, AutoText dentro del rango de texto proporcionado se reemplazan por sus valores procesados. Además, no se agregan los elementos que no son de texto dentro del rango de texto proporcionado.

Parámetros

Nombre	Tipo	Descripción
`textRange`	`TextRange`	Rango de texto que se agregará.
`matchSourceFormatting`	`Boolean`	Si es `true`, coincide con el formato del texto fuente; si es `false`, coincide con el formato del texto de destino.

Volver

TextRange: Es el rango de texto que representa el texto adjunto.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`appendText(text)`

Agrega texto al final del rango de texto. El texto mantiene el estilo del final del texto existente.

Parámetros

Nombre	Tipo	Descripción
`text`	`String`	La string que se agregará.

Volver

TextRange: Es el rango de texto que representa el texto adjunto.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`asRenderedString()`

Muestra el texto procesado que delimita este rango de la forma o celda de tabla asociada en un formato adecuado para mostrarse a los usuarios finales.

Los elementos de texto automático, como los números de diapositiva generados, se reemplazan por sus valores procesados. Se omitirán todos los elementos que no sean de texto del rango.

Volver

String

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`asString()`

Muestra el texto sin formato limitado por este rango de la forma o celda de tabla asociada.

Los elementos de AutoText, como los números de diapositiva generados y cualquier elemento que no sea texto en el rango, se reemplazan por el carácter Unicode U+E907.

Volver

String

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`clear()`

Borra el texto delimitado por este rango.

Dado que todo el texto de una forma o de una celda de tabla debe terminar en una línea nueva, no se quita la línea nueva final del texto.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`clear(startOffset, endOffset)`

Borra el texto delimitado por los desplazamientos de inicio y fin del rango.

Dado que el texto debe terminar en una línea nueva, no se quita la nueva línea final, incluso si está cubierta por desplazamientos determinados.

Parámetros

Nombre	Tipo	Descripción
`startOffset`	`Integer`	La cantidad de caracteres después del índice de inicio del rango de texto actual que se usa para determinar el índice de inicio inclusivo del rango que se borrará. El desplazamiento inicial debe ser igual o mayor que 0 y menor o igual que `endOffset`. `startOffset` también debe ser menor que la longitud del rango actual.
`endOffset`	`Integer`	La cantidad de caracteres después del índice de inicio del rango de texto actual que se usa para determinar el índice final exclusivo del rango que se borrará. `endOffset` debe ser igual o mayor que `startOffset`. `endOffset` también debe ser menor o igual que la longitud del rango actual.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`find(pattern)`

Muestra todos los rangos que coinciden con el patrón de búsqueda en el rango de texto actual. La búsqueda distingue entre mayúsculas y minúsculas.

Parámetros

Nombre	Tipo	Descripción
`pattern`	`String`	Patrón de expresión regular en el que se buscará; se deben escapar las barras diagonales inversas en el patrón.

Volver

TextRange[]

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`find(pattern, startOffset)`

Muestra todos los rangos que coinciden con el patrón de búsqueda en el rango de texto actual a partir del desplazamiento de inicio. La búsqueda distingue entre mayúsculas y minúsculas.

Parámetros

Nombre	Tipo	Descripción
`pattern`	`String`	Patrón de expresión regular en el que se buscará; se deben escapar las barras diagonales inversas en el patrón.
`startOffset`	`Integer`	La cantidad de caracteres después del índice de inicio del rango de texto actual que se usa para determinar el índice de inicio inclusivo del rango que se buscará. `startOffset` también debe ser menor que la longitud del rango actual.

Volver

TextRange[]

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getAutoTexts()`

Muestra los textos automáticos dentro del rango de texto actual.

Volver

AutoText[]

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getEndIndex()`

Muestra el índice exclusivo basado en 0 para el último carácter de este rango. Si los índices de inicio y finalización son iguales, se considera que el rango está vacío.

Volver

Integer

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getLength()`

Muestra la cantidad de caracteres de este rango.

Volver

Integer

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getLinks()`

Muestra una colección de rangos de texto que corresponden a todos los Link dentro del rango de texto actual o se superponen con el rango de texto actual.

Se garantiza que cada rango mostrado abarcará un vínculo cuando se cree. Las modificaciones de texto pueden hacer que ya no represente exactamente un vínculo.

Se puede acceder a cada Link en los rangos mostrados a través de TextStyle.getLink().

// Accesses the first link on a TextRange object.
var linkTextRange = textRange.getLinks()[0];
var textStyle = linkTextRange.getTextStyle();
Logger.log(textStyle.hasLink()); // logs 'true'
var link = textStyle.getLink();  // Link object

Volver

TextRange[]

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getListParagraphs()`

Muestra los párrafos en listas que se superponen con el rango de texto actual.

Volver

Paragraph[]

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getListStyle()`

Muestra el ListStyle del rango de texto actual.

Volver

ListStyle

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParagraphStyle()`

Muestra el ParagraphStyle del rango de texto actual.

Volver

ParagraphStyle

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParagraphs()`

Muestra los párrafos que se superponen con el rango de texto actual.

Volver

Paragraph[]

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getRange(startOffset, endOffset)`

Muestra un TextRange nuevo que cubre parte del rango del que se deriva.

Parámetros

Nombre	Tipo	Descripción
`startOffset`	`Integer`	La cantidad de caracteres después del índice de inicio del rango de texto actual que se usa para determinar el índice de inicio inclusivo del rango que se muestra. El desplazamiento inicial debe ser igual o mayor que 0 y menor o igual que `endOffset`. `startOffset` también debe ser menor que la longitud del rango actual.
`endOffset`	`Integer`	La cantidad de caracteres después del índice de inicio del rango de texto actual que se usa para determinar el índice final exclusivo del rango que se muestra. `endOffset` debe ser igual o mayor que `startOffset`. `endOffset` también debe ser menor o igual que la longitud del rango actual.

Volver

TextRange

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getRuns()`

Muestra las ejecuciones de texto que se superponen con el rango de texto actual. Una ejecución de texto es un segmento de texto en el que todos los caracteres tienen el mismo estilo de texto.

Cada rango que se muestra solo garantiza que abarque una ejecución cuando se crea. Las modificaciones de texto o estilo pueden hacer que ya no represente exactamente una ejecución.

Volver

TextRange[]

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getStartIndex()`

Muestra el índice inclusivo basado en 0 para el primer carácter de este rango. Si los índices de inicio y finalización son iguales, se considera que el rango está vacío.

Volver

Integer

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getTextStyle()`

Muestra el estilo de texto del rango o null si el rango está vacío.

Volver

TextStyle

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertParagraph(startOffset, text)`

Inserta un párrafo en el desplazamiento de inicio. El párrafo mantiene el estilo del rango de texto actual en el desplazamiento de inicio.

Para insertar la string de texto proporcionada como párrafo, agrega al menos un carácter de línea nueva circundante a la string.

Cuando la string de texto proporcionada contiene caracteres de saltos de línea (que consisten en varios párrafos), se muestra el párrafo final agregado.

Parámetros

Nombre	Tipo	Descripción
`startOffset`	`Integer`	La cantidad de caracteres después del índice de inicio del rango de texto actual que se usa para determinar el índice de inicio inclusivo del texto que se insertará.
`text`	`String`	La string que se insertará.

Volver

Paragraph: Es el Paragraph insertado.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertRange(startOffset, textRange)`

Inserta una copia del rango de texto proporcionado en el desplazamiento de inicio.

El formato del texto insertado coincidirá con el del texto de origen.

Parámetros

Nombre	Tipo	Descripción
`startOffset`	`Integer`	La cantidad de caracteres después del índice de inicio del rango de texto actual que se usa para determinar el índice de inicio inclusivo del texto que se insertará.
`textRange`	`TextRange`	Rango de texto que se insertará.

Volver

TextRange: Es el rango de texto que representa el texto insertado.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertRange(startOffset, textRange, matchSourceFormatting)`

Inserta una copia del rango de texto proporcionado en el desplazamiento de inicio.

Si se configura para que coincida con el formato del texto de destino, AutoText dentro del rango de texto proporcionado se reemplazan por sus valores procesados. Además, no se insertan elementos que no sean de texto dentro del rango de texto proporcionado.

Parámetros

Nombre	Tipo	Descripción
`startOffset`	`Integer`	La cantidad de caracteres después del índice de inicio del rango de texto actual que se usa para determinar el índice de inicio inclusivo del texto que se insertará.
`textRange`	`TextRange`	Rango de texto que se insertará.
`matchSourceFormatting`	`Boolean`	Si es `true`, coincide con el formato del texto fuente; si es `false`, coincide con el formato del texto de destino.

Volver

TextRange: Es el rango de texto que representa el texto insertado.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertText(startOffset, text)`

Inserta texto en el desplazamiento de inicio. El texto mantiene el estilo del texto existente en el desplazamiento de inicio.

Parámetros

Nombre	Tipo	Descripción
`startOffset`	`Integer`	La cantidad de caracteres después del índice de inicio del rango de texto actual que se usa para determinar el índice de inicio inclusivo del texto que se insertará.
`text`	`String`	La string que se insertará.

Volver

TextRange: Es el rango de texto que representa el texto insertado.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`isEmpty()`

Muestra true si no hay caracteres en este rango y, de lo contrario, muestra false.

Volver

Boolean

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replaceAllText(findText, replaceText)`

Reemplaza todas las instancias de texto que coincidan con texto con reemplazar texto. La búsqueda no distingue entre mayúsculas y minúsculas.

Parámetros

Nombre	Tipo	Descripción
`findText`	`String`	El texto que se debe buscar.
`replaceText`	`String`	El texto que reemplazará al texto coincidente.

Volver

Integer: La cantidad de casos cambió.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replaceAllText(findText, replaceText, matchCase)`

Reemplaza todas las instancias de texto que coincidan con texto con reemplazar texto.

Parámetros

Nombre	Tipo	Descripción
`findText`	`String`	El texto que se debe buscar.
`replaceText`	`String`	El texto que reemplazará al texto coincidente.
`matchCase`	`Boolean`	Si es `true`, la búsqueda distingue entre mayúsculas y minúsculas; si es `false`, no distingue entre mayúsculas y minúsculas.

Volver

Integer: La cantidad de casos cambió.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`select()`

Selecciona solo la TextRange en la presentación activa y quita las selecciones anteriores.

Una secuencia de comandos solo puede acceder a la selección del usuario que ejecuta la secuencia de comandos y solo si está vinculada a la presentación.

El Page superior del Shape correspondiente o el TableCell se establece como current page selection. Shape o TableCell se configuran como selected page element.

Selection puede ser de dos tipos:

1. Rango de texto; usa la opción de selección en un TextRange que no esté vacío para seleccionar el rango de caracteres
2. Posición del cursor; usa un TextRange vacío para colocar el cursor en el índice deseado.
```
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.getText().setText("Hello");
// Range selection: Select the text range "He".
shape.getText().getRange(0, 2).select();
// Cursor selection: Place the cursor after "H" like "H|ello".
shape.getText().getRange(1, 1).select();
```
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/presentations.currentonly
- https://www.googleapis.com/auth/presentations

`setText(newText)`

Establece el texto delimitado por este rango de la forma o celda de tabla asociada. El texto mantiene el estilo del inicio del texto existente.

Parámetros

Nombre	Tipo	Descripción
`newText`	`String`	Cadena que se va a establecer como texto nuevo

Volver

TextRange: Es el rango de texto que representa el texto establecido.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations