Puedes editar y aplicar estilo al texto con los rangos de texto, que se representan con el tipo TextRange
. Un TextRange
representa un segmento de texto dentro de una forma o dentro de una celda de una tabla. Si llamas a getText()
en una forma o celda de tabla, se muestra un rango de texto que abarca todo el texto.
Si usas métodos que editan la forma en que el texto se ajusta a una forma, se desactivará cualquier configuración de ajuste automático que se aplique a ella.
Cómo usar rangos de texto
Un rango de texto tiene dos índices que delimitan el segmento de texto cubierto por un rango de texto: el índice de inicio y el índice de finalización. Puedes determinar
estos índices con las funciones getStartIndex()
y getEndIndex()
.
Para leer el contenido de un rango de texto, usa las funciones asString()
o asRenderedString()
.
Para recuperar un subrango dentro de un rango de texto, usa la función getRange()
.
La siguiente secuencia de comandos crea un cuadro de texto en la primera diapositiva y establece su contenido de texto en “Hello world!”. Luego, recupera un subrango que abarca solo “Hello”.
El rango de texto que muestra una forma o una celda de la tabla siempre cubrirá todo el texto, incluso si se inserta y se borra texto. Por lo tanto, en el ejemplo anterior, se producen las siguientes instrucciones de registro:
Start: 0; End: 13; Content: Hello world! Start: 0; End: 5; Content: Hello
Cómo insertar y borrar texto
También puedes insertar y borrar formas de texto y celdas de tablas con los rangos de texto.
insertText()
yappendText()
te permiten insertar texto.setText()
reemplaza el texto de un rango de texto por el texto proporcionado.clear()
borra texto dentro de un rango de texto.
En la siguiente secuencia de comandos, se demuestra el uso de estas funciones:
Esta secuencia de comandos crea un cuadro de texto en la primera diapositiva y establece su contenido de texto en “Hello world!”. Luego, borra los caracteres del 6 al 11 ("mundo") y, en su lugar, inserta el texto "galaxia" en el índice 6. En el ejemplo anterior, se produce la siguiente instrucción de registro:
Start: 0; End: 14; Content: Hello galaxy!
Buscar y reemplazar
Usa la función replaceAllText()
en una presentación o una página para realizar una búsqueda y reemplazo global en toda la presentación o en una página específica.
La función find()
en TextRange muestra las instancias de una string dentro del rango. Se puede usar junto con setText()
para realizar búsquedas y reemplazos en una forma o celda de una tabla.
Párrafos, elementos de lista y ejecuciones
TextRange
proporciona funciones para mostrar colecciones útiles de entidades de texto.
Algunas de estas funciones incluyen las siguientes:
getParagraphs(),
, que proporciona todos los párrafos que se superponen con el rango de texto Un párrafo es una secuencia de texto que termina con el carácter de salto de línea "\n".getListParagraphs(),
, que muestra los elementos de lista en el rango de texto actualgetRuns(),
, que proporciona 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.
Estilos de texto
El estilo del texto determina la representación de caracteres de texto en tu presentación, incluida la fuente, el color y los hipervínculos.
La función getTextStyle()
de un rango de texto proporciona un objeto TextStyle
que se usa para aplicar estilo al texto. El objeto TextStyle
cubre el mismo texto que su TextRange
superior.
En el ejemplo anterior, primero se crea un cuadro de texto en la primera diapositiva y se establece su contenido en "Hello ". Luego, agrega el texto "world!". El texto que se agregó recientemente se muestra en negrita, está vinculado a www.example.com
y su color se establece en rojo.
Cuando se leen estilos, la función muestra un valor nulo si el rango tiene varios valores para el diseño. Por lo tanto, en el ejemplo anterior, se producen las siguientes instrucciones de registro:
Text: Hello; Bold: false Text: world!; Bold: true Text: Hello world!; Bold: null
Hay muchos otros estilos que se pueden aplicar al texto. Puedes encontrar más detalles en la documentación de referencia de TextStyle
.
Estilos de párrafo
Los estilos de párrafo se aplican a párrafos enteros y, además, incluyen la alineación del texto y el espaciado de líneas. La función getParagraphStyle() en TextRange
proporciona un objeto ParagraphStyle
para aplicar diseño a todos los párrafos que se superponen con el rango de texto superior.
En el siguiente ejemplo, se crea un cuadro de texto en la primera diapositiva con cuatro párrafos y, luego, se alinean los primeros tres párrafos al centro.
Estilos de listas
De manera similar a ParagraphStyle
, se puede usar ListStyle
para aplicar diseño a todos los párrafos que se superpongan con el rango de texto superior.
En el ejemplo anterior, se crea un cuadro de texto en la primera diapositiva que contiene cuatro párrafos: en el segundo, se aplica una sangría y dos en el tercer párrafo. Luego, aplica un ajuste predeterminado de lista a todos los párrafos. Por último, se registra el nivel de anidación de cada párrafo. (El nivel de anidamiento del párrafo proviene de la cantidad de tabulaciones antes del texto del párrafo). Por lo tanto, la secuencia de comandos anterior produce las siguientes instrucciones de registro:
Paragraph 1's nesting level: 0 Paragraph 2's nesting level: 1 Paragraph 3's nesting level: 2 Paragraph 4's nesting level: 0