Class TextRange

TextRange

Shape 또는 TableCell의 텍스트 콘텐츠 세그먼트입니다.

텍스트가 도형에 들어가는 방식을 수정하는 메서드를 사용하면 도형이 비활성화됩니다.

메서드

메서드반환 유형간략한 설명
appendParagraph(text)Paragraph텍스트 범위 끝에 단락을 추가합니다.
appendRange(textRange)TextRange현재 텍스트 범위의 끝에 제공된 텍스트 범위의 사본을 추가합니다.
appendRange(textRange, matchSourceFormatting)TextRange현재 텍스트 범위의 끝에 제공된 텍스트 범위의 사본을 추가합니다.
appendText(text)TextRange텍스트 범위 끝에 텍스트를 추가합니다.
asRenderedString()String연결된 도형 또는 테이블 셀의 이 범위로 제한된 렌더링된 텍스트를 최종 사용자에게 표시하기에 적합한 형식을 선택해야 합니다.
asString()String연결된 도형 또는 표 셀의 이 범위로 제한된 원시 텍스트를 반환합니다.
clear()void이 범위로 제한된 텍스트를 지웁니다.
clear(startOffset, endOffset)void범위의 시작 및 끝 오프셋으로 제한된 텍스트를 지웁니다.
find(pattern)TextRange[]현재 텍스트 범위에서 검색 패턴과 일치하는 모든 범위를 반환합니다.
find(pattern, startOffset)TextRange[]에서 시작하여 현재 텍스트 범위에서 검색 패턴과 일치하는 모든 범위를 반환합니다. 시작 오프셋입니다.
getAutoTexts()AutoText[]현재 텍스트 범위 내의 자동 텍스트를 반환합니다.
getEndIndex()Integer이 범위의 마지막 문자에 대해 0부터 시작하는 배타적 색인을 반환합니다.
getLength()Integer이 범위의 문자 수를 반환합니다.
getLinks()TextRange[]현재 범위 내의 모든 Link에 해당하는 텍스트 범위 모음을 반환합니다. 현재 텍스트 범위와 겹치는 경우
getListParagraphs()Paragraph[]목록에서 현재 텍스트 범위와 겹치는 단락을 반환합니다.
getListStyle()ListStyle현재 텍스트 범위의 ListStyle를 반환합니다.
getParagraphStyle()ParagraphStyle현재 텍스트 범위의 ParagraphStyle를 반환합니다.
getParagraphs()Paragraph[]현재 텍스트 범위와 겹치는 단락을 반환합니다.
getRange(startOffset, endOffset)TextRange파생된 범위 일부를 포함하는 새 TextRange를 반환합니다.
getRuns()TextRange[]현재 텍스트 범위와 겹치는 텍스트 실행을 반환합니다.
getStartIndex()Integer이 범위의 첫 번째 문자에 대해 0부터 시작하는 색인을 반환합니다.
getTextStyle()TextStyle범위의 텍스트 스타일을 반환하거나 범위가 비어 있는 경우 null를 반환합니다.
insertParagraph(startOffset, text)Paragraph시작 오프셋에 단락을 삽입합니다.
insertRange(startOffset, textRange)TextRange시작 오프셋에 제공된 텍스트 범위의 사본을 삽입합니다.
insertRange(startOffset, textRange, matchSourceFormatting)TextRange시작 오프셋에 제공된 텍스트 범위의 사본을 삽입합니다.
insertText(startOffset, text)TextRange시작 오프셋에 텍스트를 삽입합니다.
isEmpty()Boolean이 범위에 문자가 없으면 true를 반환하고 false를 반환합니다. 없습니다.
replaceAllText(findText, replaceText)Integer찾기 텍스트와 일치하는 모든 인스턴스를 교체 텍스트로 바꿉니다.
replaceAllText(findText, replaceText, matchCase)Integer찾기 텍스트와 일치하는 모든 인스턴스를 교체 텍스트로 바꿉니다.
select()void활성 프레젠테이션에서 TextRange만 선택하고 이전 프레젠테이션은 모두 삭제합니다. 선택합니다.
setText(newText)TextRange연결된 도형 또는 표 셀의 이 범위로 제한된 텍스트를 설정합니다.

자세한 문서

appendParagraph(text)

텍스트 범위 끝에 단락을 추가합니다. 단락은 현재 텍스트 범위의 끝부분입니다.

제공된 텍스트 문자열은 환경 변수를 하나 이상 추가하여 단락을 추가합니다. 줄바꿈 문자를 문자열에 추가합니다.

제공된 텍스트 문자열에 줄바꿈 문자가 포함되어 단락)를 제출하면 추가된 마지막 단락이 반환됩니다.

매개변수

이름유형설명
textString단락으로 추가할 문자열입니다.

리턴

Paragraph: 추가된 Paragraph입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

appendRange(textRange)

현재 텍스트 범위의 끝에 제공된 텍스트 범위의 사본을 추가합니다.

삽입된 텍스트의 서식은 원본 텍스트와 일치합니다.

매개변수

이름유형설명
textRangeTextRange추가할 텍스트 범위입니다.

리턴

TextRange: 추가된 텍스트를 나타내는 텍스트 범위

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

appendRange(textRange, matchSourceFormatting)

현재 텍스트 범위의 끝에 제공된 텍스트 범위의 사본을 추가합니다.

대상 텍스트의 형식과 일치하도록 설정된 경우 제공된 내의 AutoText 텍스트 범위가 렌더링된 값으로 대체됩니다. 또한 입력한 텍스트 범위는 추가되지 않습니다.

매개변수

이름유형설명
textRangeTextRange추가할 텍스트 범위입니다.
matchSourceFormattingBooleantrue인 경우 원본 텍스트의 형식과 일치합니다. 조건: false는 대상 텍스트의 형식과 일치합니다.

리턴

TextRange: 추가된 텍스트를 나타내는 텍스트 범위

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

appendText(text)

텍스트 범위 끝에 텍스트를 추가합니다. 텍스트는 추가할 수 있습니다.

매개변수

이름유형설명
textString추가할 문자열입니다.

리턴

TextRange: 추가된 텍스트를 나타내는 텍스트 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

asRenderedString()

연결된 도형 또는 표 셀의 이 범위로 제한된 렌더링된 텍스트를 최종 사용자에게 표시하기에 적합한 형식을 선택해야 합니다.

생성된 슬라이드 번호와 같은 AutoText 요소는 렌더링된 값으로 대체됩니다. 범위 내의 텍스트가 아닌 요소는 모두 생략됩니다.

리턴

String

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

asString()

연결된 도형 또는 테이블 셀의 이 범위로 제한된 원시 텍스트를 반환합니다.

생성된 슬라이드 번호 등의 자동 텍스트 요소 및 범위에 있는 텍스트가 아닌 요소가 모두 포함됩니다. 유니코드 문자 U+E907로 대체되었습니다.

리턴

String

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

clear()

이 범위로 제한된 텍스트를 지웁니다.

Shape 또는 TableCell의 전체 텍스트는 줄바꿈으로 끝나야 하므로 텍스트가 삭제되지 않습니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

clear(startOffset, endOffset)

범위의 시작 및 끝 오프셋으로 제한된 텍스트를 지웁니다.

텍스트는 줄바꿈으로 끝나야 하므로 텍스트의 마지막 줄바꿈은 지정된 오프셋으로 커버됩니다.

매개변수

이름유형설명
startOffsetInteger사용된 현재 텍스트 범위의 시작 색인 이후의 문자 수 를 입력합니다. 시작 오프셋은 0 이상 endOffset 이하입니다. startOffset 또한 현재 범위의 길이보다 작아야 합니다.
endOffsetInteger사용된 현재 텍스트 범위의 시작 색인 이후의 문자 수 를 사용하여 지울 범위의 배타적 끝 색인을 결정합니다. endOffset는 다음과 같아야 합니다. startOffset 이상이어야 합니다. endOffset은(는) 이보다 작거나 같아야 합니다. 현재 범위의 길이와 같아야 합니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

find(pattern)

현재 텍스트 범위에서 검색 패턴과 일치하는 모든 범위를 반환합니다. 검색은 대소문자를 구분합니다.

매개변수

이름유형설명
patternString검색할 정규 표현식 패턴입니다. 패턴의 백슬래시는 이스케이프 처리됩니다.

리턴

TextRange[]

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

find(pattern, startOffset)

에서 시작하여 현재 텍스트 범위에서 검색 패턴과 일치하는 모든 범위를 반환합니다. 시작 오프셋입니다. 검색은 대소문자를 구분합니다.

매개변수

이름유형설명
patternString검색할 정규 표현식 패턴입니다. 패턴의 백슬래시는 이스케이프 처리됩니다.
startOffsetInteger사용된 현재 텍스트 범위의 시작 색인 이후의 문자 수 를 사용하여 검색할 범위의 포괄적인 시작 색인을 결정합니다. startOffset 필수 요건 현재 범위의 길이보다 작을 수 있습니다.

리턴

TextRange[]

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getAutoTexts()

현재 텍스트 범위 내의 자동 텍스트를 반환합니다.

리턴

AutoText[]

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getEndIndex()

이 범위의 마지막 문자에 대해 0부터 시작하는 배타적 색인을 반환합니다. 시작과 끝이 색인이 같으면 범위는 비어 있는 것으로 간주됩니다.

리턴

Integer

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getLength()

이 범위의 문자 수를 반환합니다.

리턴

Integer

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

현재 범위 내의 모든 Link에 해당하는 텍스트 범위 모음을 반환합니다. 현재 텍스트 범위와 겹치는 경우

반환된 각 범위는 생성 시 하나의 링크에 걸쳐 적용됩니다. 텍스트 수정 더 이상 정확히 하나의 링크를 나타내지 않을 수 있습니다.

반환된 범위의 각 Link는 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

리턴

TextRange[]

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getListParagraphs()

목록에서 현재 텍스트 범위와 겹치는 단락을 반환합니다.

리턴

Paragraph[]

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getListStyle()

현재 텍스트 범위의 ListStyle를 반환합니다.

리턴

ListStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getParagraphStyle()

현재 텍스트 범위의 ParagraphStyle를 반환합니다.

리턴

ParagraphStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getParagraphs()

현재 텍스트 범위와 겹치는 단락을 반환합니다.

리턴

Paragraph[]

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getRange(startOffset, endOffset)

파생된 범위 일부를 포함하는 새 TextRange를 반환합니다.

매개변수

이름유형설명
startOffsetInteger사용된 현재 텍스트 범위의 시작 색인 이후의 문자 수 를 입력합니다. 시작 오프셋은 0 이상 endOffset 이하입니다. startOffset 또한 현재 범위의 길이보다 작아야 합니다.
endOffsetInteger사용된 현재 텍스트 범위의 시작 색인 이후의 문자 수 반환된 범위의 배타적 끝 색인을 결정합니다. endOffset는 다음과 같아야 합니다. startOffset 이상이어야 합니다. endOffset은(는) 이보다 작거나 같아야 합니다. 현재 범위의 길이와 같아야 합니다.

리턴

TextRange

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getRuns()

현재 텍스트 범위와 겹치는 텍스트 실행을 반환합니다. 텍스트 런은 텍스트에서 모든 문자의 텍스트 스타일이 동일합니다.

반환된 각 범위는 생성 시 하나의 실행만 포함되도록 보장됩니다. 텍스트 또는 스타일 수정사항이 더 이상 정확히 하나의 실행을 나타내지 않을 수 있습니다.

리턴

TextRange[]

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getStartIndex()

이 범위의 첫 번째 문자에 대해 0부터 시작하는 색인을 반환합니다. 시작과 끝이 끝 색인이 같으면 범위는 비어 있는 것으로 간주됩니다.

리턴

Integer

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getTextStyle()

범위의 텍스트 스타일을 반환하거나 범위가 비어 있는 경우 null를 반환합니다.

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertParagraph(startOffset, text)

시작 오프셋에 단락을 삽입합니다. 단락은 현재 시작 오프셋의 텍스트 범위를 지정합니다.

제공된 텍스트 문자열이 주변을 1개 이상 추가하여 단락으로 삽입됩니다. 줄바꿈 문자를 문자열에 추가합니다.

제공된 텍스트 문자열에 줄바꿈 문자가 포함되어 단락)를 제출하면 추가된 마지막 단락이 반환됩니다.

매개변수

이름유형설명
startOffsetInteger사용된 현재 텍스트 범위의 시작 색인 이후의 문자 수 를 사용하여 삽입할 텍스트의 포괄적인 시작 색인을 결정합니다.
textString삽입할 문자열입니다.

리턴

Paragraph: 삽입된 Paragraph입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertRange(startOffset, textRange)

시작 오프셋에 제공된 텍스트 범위의 사본을 삽입합니다.

삽입된 텍스트의 서식은 원본 텍스트와 일치합니다.

매개변수

이름유형설명
startOffsetInteger사용된 현재 텍스트 범위의 시작 색인 이후의 문자 수 를 사용하여 삽입할 텍스트의 포괄적인 시작 색인을 결정합니다.
textRangeTextRange삽입할 텍스트 범위입니다.

리턴

TextRange: 삽입된 텍스트를 나타내는 텍스트 범위

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertRange(startOffset, textRange, matchSourceFormatting)

시작 오프셋에 제공된 텍스트 범위의 사본을 삽입합니다.

대상 텍스트의 형식과 일치하도록 설정된 경우 제공된 내의 AutoText 텍스트 범위가 렌더링된 값으로 대체됩니다. 또한 삽입되지 않습니다.

매개변수

이름유형설명
startOffsetInteger사용된 현재 텍스트 범위의 시작 색인 이후의 문자 수 를 사용하여 삽입할 텍스트의 포괄적인 시작 색인을 결정합니다.
textRangeTextRange삽입할 텍스트 범위입니다.
matchSourceFormattingBooleantrue인 경우 원본 텍스트의 형식과 일치합니다. 조건: false는 대상 텍스트의 형식과 일치합니다.

리턴

TextRange: 삽입된 텍스트를 나타내는 텍스트 범위

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertText(startOffset, text)

시작 오프셋에 텍스트를 삽입합니다. 텍스트는 시작 오프셋입니다.

매개변수

이름유형설명
startOffsetInteger사용된 현재 텍스트 범위의 시작 색인 이후의 문자 수 를 사용하여 삽입할 텍스트의 포괄적인 시작 색인을 결정합니다.
textString삽입할 문자열입니다.

리턴

TextRange: 삽입된 텍스트를 나타내는 텍스트 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isEmpty()

이 범위에 문자가 없으면 true를 반환하고 false를 반환합니다. 없습니다.

리턴

Boolean

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replaceAllText(findText, replaceText)

찾기 텍스트와 일치하는 모든 인스턴스를 교체 텍스트로 바꿉니다. 케이스 검색 몰지각하지 않습니다.

매개변수

이름유형설명
findTextString찾을 텍스트입니다.
replaceTextString일치하는 텍스트를 대체할 텍스트입니다.

리턴

Integer — 일치하는 항목 수가 변경됨

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replaceAllText(findText, replaceText, matchCase)

찾기 텍스트와 일치하는 모든 인스턴스를 교체 텍스트로 바꿉니다.

매개변수

이름유형설명
findTextString찾을 텍스트입니다.
replaceTextString일치하는 텍스트를 대체할 텍스트입니다.
matchCaseBooleantrue인 경우 검색에서 대소문자를 구분합니다. false인 경우 검색: 대소문자를 구분하지 않습니다.

리턴

Integer — 일치하는 항목 수가 변경됨

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

select()

활성 프레젠테이션에서 TextRange만 선택하고 이전 프레젠테이션은 모두 삭제합니다. 선택합니다.

스크립트는 스크립트를 실행하는 사용자의 선택에 액세스할 수 있고 스크립트가 프레젠테이션에 바인딩된 경우

상응하는 Shape 또는 TableCell의 상위 Page가 설정됩니다. current page selection로 설정합니다. Shape 또는 TableCell이 selected page element로 설정됩니다.

    를 탭합니다. Selection는 다음 두 가지 유형일 수 있습니다. <ph type="x-smartling-placeholder">
      </ph>
    • 1. 텍스트 범위입니다. 비어 있지 않은 TextRange에서 select를 사용하여 있습니다.
    • 2. 커서 위치. 빈 TextRange를 사용하여 원하는 색인에 커서를 배치합니다. 
      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();

      승인

      이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

      • https://www.googleapis.com/auth/presentations.currentonly
      • https://www.googleapis.com/auth/presentations

    setText(newText)

    연결된 도형 또는 표 셀의 이 범위로 제한된 텍스트를 설정합니다. 텍스트는 기존 텍스트의 시작 스타일을 지정합니다.

    매개변수

    이름유형설명
    newTextString새 텍스트로 설정할 문자열입니다.

    리턴

    TextRange: 설정된 텍스트를 나타내는 텍스트 범위

    승인

    이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

    • https://www.googleapis.com/auth/presentations.currentonly
    • https://www.googleapis.com/auth/presentations