TextRange
유형으로 표시되는 텍스트 범위를 사용하여 텍스트를 수정하고 스타일을 지정할 수 있습니다. TextRange
는 도형 내 또는 표 셀 내의 텍스트 세그먼트를 나타냅니다. 모양 또는 표 셀에서 getText()
을 호출하면 전체 텍스트를 포함하는 텍스트 범위가 반환됩니다.
텍스트가 도형 내에 맞도록 수정하는 방법을 사용하면 도형에 적용된 자동 맞춤 설정이 비활성화됩니다.
텍스트 범위 사용
텍스트 범위에는 텍스트 범위로 처리되는 텍스트 세그먼트를 구분하는 두 개의 색인이 있습니다. 시작 색인과 종료 색인입니다. getStartIndex()
및 getEndIndex()
함수를 사용하여 이러한 색인을 확인할 수 있습니다.
텍스트 범위의 콘텐츠를 읽으려면 asString()
또는 asRenderedString()
함수를 사용합니다.
텍스트 범위 내에서 하위 범위를 검색하려면 getRange()
함수를 사용합니다.
다음 스크립트는 첫 번째 슬라이드에 텍스트 상자를 만들고 텍스트 콘텐츠를 'Hello world!'로 설정합니다. 그런 다음 'Hello'에만 걸쳐 있는 하위 범위를 가져옵니다.
모양이나 표 셀에서 반환된 텍스트 범위는 텍스트가 삽입되고 삭제되더라도 항상 전체 텍스트를 포함합니다. 따라서 위의 예시에서는 다음 로그 문을 생성합니다.
Start: 0; End: 13; Content: Hello world! Start: 0; End: 5; Content: Hello
텍스트 삽입 및 삭제
텍스트 범위를 사용하여 텍스트 도형과 표 셀을 삽입하고 삭제할 수도 있습니다.
insertText()
및appendText()
을 사용하면 텍스트를 삽입할 수 있습니다.setText()
는 텍스트 범위의 텍스트를 제공된 텍스트로 대체합니다.clear()
는 텍스트 범위 내에서 텍스트를 삭제합니다.
다음 스크립트는 이러한 함수의 사용을 보여줍니다.
이 스크립트는 첫 번째 슬라이드에 텍스트 상자를 만들고 텍스트 콘텐츠를 'Hello world!'로 설정합니다. 그런 다음 6~11번째 문자 ('world')를 삭제하고 대신 6번째 색인에 'galaxy'라는 텍스트를 삽입합니다. 위 예시는 다음 로그 문을 생성합니다.
Start: 0; End: 14; Content: Hello galaxy!
찾기 및 바꾸기
프레젠테이션 또는 페이지에서 replaceAllText()
함수를 사용하여 전체 프레젠테이션 또는 특정 페이지에서 전역 찾기 및 바꾸기를 실행합니다.
TextRange의 find()
함수는 범위 내 문자열의 인스턴스를 반환합니다. setText()
와 함께 사용하여 도형 또는 표 셀 내에서 찾기 및 바꾸기를 실행할 수 있습니다.
단락, 목록 항목, 실행
TextRange
는 유용한 텍스트 엔티티 컬렉션을 반환하는 함수를 제공합니다.
이러한 함수에는 다음이 포함됩니다.
- 텍스트 범위와 겹치는 모든 단락을 제공하는
getParagraphs(),
단락은 줄바꿈 문자 '\n'으로 끝나는 텍스트 시퀀스입니다. getListParagraphs(),
는 현재 텍스트 범위의 목록 항목을 반환합니다.- 현재 텍스트 범위와 겹치는 텍스트 실행을 제공하는
getRuns(),
텍스트 실행은 모든 문자의 텍스트 스타일이 동일한 텍스트 세그먼트입니다.
텍스트 스타일 지정
텍스트 스타일은 글꼴, 색상, 하이퍼링크를 비롯한 프레젠테이션의 텍스트 문자의 렌더링을 결정합니다.
텍스트 범위의 getTextStyle()
함수는 텍스트 스타일 지정에 사용되는 TextStyle
객체를 제공합니다. TextStyle
객체는 상위 TextRange
와 동일한 텍스트를 포함합니다.
위의 예에서는 먼저 첫 번째 슬라이드에 텍스트 상자를 만들고 콘텐츠를 'Hello'로 설정합니다. 그런 다음 'world!'라는 텍스트를 추가합니다. 새로 추가된 텍스트는 굵게 표시되고 www.example.com
에 연결되며 색상이 빨간색으로 설정됩니다.
스타일을 읽을 때 범위에 스타일 값이 여러 개 있으면 함수는 null을 반환합니다. 따라서 위의 샘플은 다음 로그 문을 생성합니다.
Text: Hello; Bold: false Text: world!; Bold: true Text: Hello world!; Bold: null
텍스트에 적용할 수 있는 다른 스타일도 많이 있습니다. 자세한 내용은 TextStyle
참조 문서를 참고하세요.
단락 스타일 지정
단락 스타일은 전체 단락에 적용되며 텍스트 정렬, 줄 간격과 같은 항목이 포함됩니다. TextRange
의 getParagraphStyle() 함수는 상위 텍스트 범위와 겹치는 모든 단락의 스타일을 지정하는 ParagraphStyle
객체를 제공합니다.
다음 예에서는 단락이 4개인 텍스트 상자를 첫 번째 슬라이드에 만든 다음 처음 세 단락을 가운데 정렬합니다.
목록 스타일 지정
ParagraphStyle
와 마찬가지로 ListStyle
는 상위 텍스트 범위와 겹치는 모든 단락의 스타일을 지정하는 데 사용할 수 있습니다.
위의 예에서는 첫 번째 슬라이드에 텍스트 상자를 만듭니다. 텍스트 상자에는 단락이 4개 포함되어 있으며 두 번째 단락은 한 번 들여쓰기되고 세 번째 단락은 두 번 들여쓰기됩니다. 그런 다음 모든 단락에 목록 사전 설정을 적용합니다. 마지막으로 각 단락의 중첩 수준이 로깅됩니다. (단락의 중첩 수준은 단락 텍스트 앞의 탭 수에서 가져옵니다.) 따라서 위의 스크립트는 다음 로그 문을 생성합니다.
Paragraph 1's nesting level: 0 Paragraph 2's nesting level: 1 Paragraph 3's nesting level: 2 Paragraph 4's nesting level: 0