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

Class TextRange

Segmento del contenido de texto de una Shape o TableCell

Si usas métodos que editan cómo se ajusta el texto dentro de una forma, cualquier configuración de ajuste automático que se aplique se desactiva 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`	Devuelve el texto renderizado delimitado por este rango de la forma o celda de tabla asociadas en una el formato adecuado para mostrar a los usuarios finales.
`asString()`	`String`	Muestra el texto sin procesar que limita este rango de la forma o la celda de tabla asociadas.
`clear()`	`void`	Borra el texto que limita este rango.
`clear(startOffset, endOffset)`	`void`	Borra el texto delimitado por los desplazamientos inicial y final 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[]`	Devuelve 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 el número de caracteres en este rango.
`getLinks()`	`TextRange[]`	Muestra una colección de rangos de texto que corresponden a todos los `Link` dentro del valor actual. de texto o superponer el rango de texto actual.
`getListParagraphs()`	`Paragraph[]`	Muestra los párrafos de las 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 inicial.
`insertRange(startOffset, textRange)`	`TextRange`	Inserta una copia del rango de texto proporcionado en el desplazamiento inicial.
`insertRange(startOffset, textRange, matchSourceFormatting)`	`TextRange`	Inserta una copia del rango de texto proporcionado en el desplazamiento inicial.
`insertText(startOffset, text)`	`TextRange`	Inserta texto en el desplazamiento inicial.
`isEmpty()`	`Boolean`	Muestra `true` si no hay caracteres en este rango y muestra `false` de lo contrario.
`replaceAllText(findText, replaceText)`	`Integer`	Reemplaza todas las instancias de texto que coincidan con el texto de búsqueda por texto de reemplazo.
`replaceAllText(findText, replaceText, matchCase)`	`Integer`	Reemplaza todas las instancias de texto que coincidan con el texto de búsqueda por texto de reemplazo.
`select()`	`void`	Selecciona solo la `TextRange` en la presentación activa y quita las anteriores selección.
`setText(newText)`	`TextRange`	Establece el texto delimitado por este rango de la forma o celda de tabla asociadas.

Documentación detallada

`appendParagraph(text)`

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

La cadena de texto proporcionada se anexa como párrafo agregando al menos una cadena carácter de salto de línea a la cadena.

Cuando la cadena de texto proporcionada contiene caracteres de salto de línea (por lo tanto, consta de varios párrafos), se muestra el último párrafo agregado.

Parámetros

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

Volver

Paragraph: Es el Paragraph agregado.

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`	El rango de texto que se agregará.

Volver

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

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 valor proporcionado de texto se reemplazan por sus valores renderizados. Además, cualquier elemento no texto dentro el rango de texto proporcionado no se anexa.

Parámetros

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

Volver

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

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 de la del texto existente.

Parámetros

Nombre	Tipo	Descripción
`text`	`String`	Cadena que se va a adjuntar

Volver

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

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()`

Devuelve el texto renderizado delimitado por este rango de la forma o celda de tabla asociadas en una el formato adecuado para mostrar a los usuarios finales.

Los elementos de AutoText, como los números de diapositiva generados, se reemplazan por sus valores renderizados. Se omiten los elementos que no sean de texto en el 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 procesar que limita este rango de la forma o la celda de tabla asociadas.

Los elementos de AutoText, como los números de las diapositivas generados y cualquier elemento no textual en el rango, se reemplazará 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 que limita este rango.

Como todo el texto de un objeto Shape o TableCell debe terminar en una línea nueva, la línea nueva final se el texto no se quita.

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 inicial y final del rango.

Como el texto debe terminar en una línea nueva, la línea nueva final no se quita, incluso si cubiertas por las compensaciones determinadas.

Parámetros

Nombre	Tipo	Descripción
`startOffset`	`Integer`	La cantidad de caracteres que superan el índice de inicio del rango de texto actual utilizado para determinar el índice de inicio inclusivo del rango que se borrará. El desplazamiento inicial debe ser igual o superior a 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 que superan el índice de inicio del rango de texto actual utilizado para determinar el índice final exclusivo del rango que se borrará. El valor de `endOffset` debe ser igual o mayor que `startOffset`. El valor de `endOffset` también debe ser menor que o igual a 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 es distingue mayúsculas de minúsculas.

Parámetros

Nombre	Tipo	Descripción
`pattern`	`String`	El patrón de expresión regular para buscar; cualquier barra inversa en el patrón debe un escape.

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)`

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

Parámetros

Nombre	Tipo	Descripción
`pattern`	`String`	El patrón de expresión regular para buscar; cualquier barra inversa en el patrón debe un escape.
`startOffset`	`Integer`	La cantidad de caracteres que superan el índice de inicio del rango de texto actual utilizado para determinar el índice de inicio inclusivo del rango en el que se buscará. `startOffset` debe menor que la extensión 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 el inicio y el final 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 el número de caracteres en 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 valor actual. de texto o superponer el rango de texto actual.

Se garantiza que cada rango mostrado abarcará un vínculo cuando se crea. Modificaciones de texto puede hacer que ya no represente exactamente un vínculo.

Se puede acceder a cada Link en los rangos que se muestran 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 de las 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 que superan el índice de inicio del rango de texto actual utilizado para determinar el índice de inicio inclusivo del rango devuelto. El desplazamiento inicial debe ser igual o superior a 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 que superan el índice de inicio del rango de texto actual utilizado para determinar el índice de finalización exclusivo del rango devuelto. El valor de `endOffset` debe ser igual o mayor que `startOffset`. El valor de `endOffset` también debe ser menor que o igual a 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 donde todos los caracteres tienen el mismo estilo de texto.

Solo se garantiza que cada rango mostrado abarque una ejecución cuando se crea. 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 el inicio y de salida sean iguales, se considerará 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 inicial. El párrafo mantiene el estilo de la configuración rango de texto en el desplazamiento inicial.

La cadena de texto proporcionada se inserta como párrafo agregando al menos una cadena carácter de salto de línea a la cadena.

Cuando la cadena de texto proporcionada contiene caracteres de salto de línea (por lo tanto, consta de varios párrafos), se muestra el último párrafo agregado.

Parámetros

Nombre	Tipo	Descripción
`startOffset`	`Integer`	La cantidad de caracteres que superan el índice de inicio del rango de texto actual utilizado para determinar el índice de inicio inclusivo del texto que se insertará.
`text`	`String`	Cadena que se va a 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 inicial.

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

Parámetros

Nombre	Tipo	Descripción
`startOffset`	`Integer`	La cantidad de caracteres que superan el índice de inicio del rango de texto actual utilizado para determinar el índice de inicio inclusivo del texto que se insertará.
`textRange`	`TextRange`	El 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 inicial.

Parámetros

Nombre	Tipo	Descripción
`startOffset`	`Integer`	La cantidad de caracteres que superan el índice de inicio del rango de texto actual utilizado para determinar el índice de inicio inclusivo del texto que se insertará.
`textRange`	`TextRange`	El rango de texto que se insertará.
`matchSourceFormatting`	`Boolean`	Si es `true`, coincide con el formato del texto de origen; si `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 inicial. El texto mantiene el estilo del texto existente en la desplazamiento de inicio.

Parámetros

Nombre	Tipo	Descripción
`startOffset`	`Integer`	La cantidad de caracteres que superan el índice de inicio del rango de texto actual utilizado para determinar el índice de inicio inclusivo del texto que se insertará.
`text`	`String`	Cadena que se va a 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 muestra false. de lo contrario.

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 el texto de búsqueda por texto de reemplazo. La búsqueda es de mayúsculas y minúsculas es insensible.

Parámetros

Nombre	Tipo	Descripción
`findText`	`String`	El texto que se debe buscar.
`replaceText`	`String`	Es el texto en el que se reemplazará el texto que coincide.

Volver

Integer: La cantidad de casos modificados

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 el texto de búsqueda por texto de reemplazo.

Parámetros

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

Volver

Integer: La cantidad de casos modificados

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 anteriores selección.

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

Se establece el elemento superior Page del Shape correspondiente o el TableCell que el current page selection. Shape o TableCell se establecen como selected page element.

El Selection puede ser de dos tipos:

1. Rango de texto, usa {i>select<i} 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 asociadas. El texto mantiene el estilo del inicio del texto existente.

Parámetros

Nombre	Tipo	Descripción
`newText`	`String`	Cadena que se 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