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
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
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
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
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
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()
getParagraphStyle()
Muestra el ParagraphStyle
del rango de texto actual.
Volver
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
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
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
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
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