Class TextRange

TextoRango

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étodoTipo de datos que se muestraDescripción breve
appendParagraph(text)ParagraphAgrega un párrafo al final del rango de texto.
appendRange(textRange)TextRangeAgrega una copia del rango de texto proporcionado al final del rango de texto actual.
appendRange(textRange, matchSourceFormatting)TextRangeAgrega una copia del rango de texto proporcionado al final del rango de texto actual.
appendText(text)TextRangeAgrega texto al final del rango de texto.
asRenderedString()StringMuestra 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()StringMuestra el texto sin formato limitado por este rango de la forma o celda de tabla asociada.
clear()voidBorra el texto delimitado por este rango.
clear(startOffset, endOffset)voidBorra 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()IntegerMuestra el índice exclusivo basado en 0 para el último carácter de este rango.
getLength()IntegerMuestra 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()ListStyleMuestra el ListStyle del rango de texto actual.
getParagraphStyle()ParagraphStyleMuestra 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)TextRangeMuestra 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()IntegerMuestra el índice inclusivo basado en 0 para el primer carácter de este rango.
getTextStyle()TextStyleMuestra el estilo de texto del rango o null si el rango está vacío.
insertParagraph(startOffset, text)ParagraphInserta un párrafo en el desplazamiento de inicio.
insertRange(startOffset, textRange)TextRangeInserta una copia del rango de texto proporcionado en el desplazamiento de inicio.
insertRange(startOffset, textRange, matchSourceFormatting)TextRangeInserta una copia del rango de texto proporcionado en el desplazamiento de inicio.
insertText(startOffset, text)TextRangeInserta texto en el desplazamiento de inicio.
isEmpty()BooleanMuestra true si no hay caracteres en este rango y, de lo contrario, muestra false.
replaceAllText(findText, replaceText)IntegerReemplaza todas las instancias de texto que coincidan con texto con reemplazar texto.
replaceAllText(findText, replaceText, matchCase)IntegerReemplaza todas las instancias de texto que coincidan con texto con reemplazar texto.
select()voidSelecciona solo la TextRange en la presentación activa y quita las selecciones anteriores.
setText(newText)TextRangeEstablece 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

NombreTipoDescripción
textStringString 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

NombreTipoDescripción
textRangeTextRangeRango 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

NombreTipoDescripción
textRangeTextRangeRango de texto que se agregará.
matchSourceFormattingBooleanSi 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

NombreTipoDescripción
textStringLa 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

NombreTipoDescripción
startOffsetIntegerLa 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.
endOffsetIntegerLa 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

NombreTipoDescripción
patternStringPatró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

NombreTipoDescripción
patternStringPatrón de expresión regular en el que se buscará; se deben escapar las barras diagonales inversas en el patrón.
startOffsetIntegerLa 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

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

NombreTipoDescripción
startOffsetIntegerLa 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.
endOffsetIntegerLa 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

NombreTipoDescripción
startOffsetIntegerLa 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á.
textStringLa 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

NombreTipoDescripción
startOffsetIntegerLa 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á.
textRangeTextRangeRango 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

NombreTipoDescripción
startOffsetIntegerLa 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á.
textRangeTextRangeRango de texto que se insertará.
matchSourceFormattingBooleanSi 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

NombreTipoDescripción
startOffsetIntegerLa 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á.
textStringLa 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

NombreTipoDescripción
findTextStringEl texto que se debe buscar.
replaceTextStringEl 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

NombreTipoDescripción
findTextStringEl texto que se debe buscar.
replaceTextStringEl texto que reemplazará al texto coincidente.
matchCaseBooleanSi 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

    NombreTipoDescripción
    newTextStringCadena 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