메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
append | Paragraph | 텍스트 범위 끝에 단락을 추가합니다. |
append | Text | 제공된 텍스트 범위의 사본을 현재 텍스트 범위의 끝에 추가합니다. |
append | Text | 제공된 텍스트 범위의 사본을 현재 텍스트 범위의 끝에 추가합니다. |
append | Text | 텍스트 범위 끝에 텍스트를 추가합니다. |
as | String | 최종 사용자에게 표시하기에 적합한 형식으로 이 범위에 의해 바운드된 연결된 도형 또는 표 셀의 렌더링된 텍스트를 반환합니다. |
as | String | 연결된 도형 또는 표 셀의 이 범위로 제한된 원시 텍스트를 반환합니다. |
clear() | void | 이 범위로 제한된 텍스트를 삭제합니다. |
clear(startOffset, endOffset) | void | 범위에서 시작 및 종료 오프셋으로 제한된 텍스트를 지웁니다. |
find(pattern) | Text | 현재 텍스트 범위에서 검색 패턴과 일치하는 모든 범위를 반환합니다. |
find(pattern, startOffset) | Text | 시작 오프셋부터 시작하는 현재 텍스트 범위에서 검색 패턴과 일치하는 모든 범위를 반환합니다. |
get | Auto | 현재 텍스트 범위 내의 자동 텍스트를 반환합니다. |
get | Integer | 이 범위의 마지막 문자에 대한 0 기반 독점 색인을 반환합니다. |
get | Integer | 이 범위의 문자 수를 반환합니다. |
get | Text | 현재 텍스트 범위 내에 있거나 현재 텍스트 범위와 겹치는 모든 Link 에 해당하는 텍스트 범위 컬렉션을 반환합니다. |
get | Paragraph[] | 현재 텍스트 범위와 겹치는 목록의 단락을 반환합니다. |
get | List | 현재 텍스트 범위의 List 를 반환합니다. |
get | Paragraph | 현재 텍스트 범위의 Paragraph 를 반환합니다. |
get | Paragraph[] | 현재 텍스트 범위와 겹치는 단락을 반환합니다. |
get | Text | 파생된 범위의 일부를 포함하는 새 Text 를 반환합니다. |
get | Text | 현재 텍스트 범위와 겹치는 텍스트 실행을 반환합니다. |
get | Integer | 이 범위의 첫 번째 문자에 대한 0부터 시작하는 색인(포함)을 반환합니다. |
get | Text | 범위의 텍스트 스타일을 반환하거나 범위가 비어 있으면 null 를 반환합니다. |
insert | Paragraph | 시작 오프셋에 단락을 삽입합니다. |
insert | Text | 제공된 텍스트 범위의 사본을 시작 오프셋에 삽입합니다. |
insert | Text | 제공된 텍스트 범위의 사본을 시작 오프셋에 삽입합니다. |
insert | Text | 시작 오프셋에 텍스트를 삽입합니다. |
is | Boolean | 이 범위에 문자가 없으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다. |
replace | Integer | 찾기 텍스트와 일치하는 모든 텍스트 인스턴스를 바꾸기 텍스트로 바꿉니다. |
replace | Integer | 찾기 텍스트와 일치하는 모든 텍스트 인스턴스를 바꾸기 텍스트로 바꿉니다. |
select() | void | 활성 프레젠테이션에서 Text 만 선택하고 이전 선택을 삭제합니다. |
set | Text | 연결된 도형 또는 표 셀의 이 범위로 제한된 텍스트를 설정합니다. |
자세한 문서
append Paragraph(text)
텍스트 범위 끝에 단락을 추가합니다. 단락은 현재 텍스트 범위의 끝에 있는 스타일을 유지합니다.
제공된 텍스트 문자열은 문자열에 하나 이상의 둘러싸는 줄바꿈 문자를 추가하여 단락으로 추가됩니다.
제공된 텍스트 문자열에 줄바꿈 문자가 포함되어 여러 단락으로 구성된 경우 추가된 마지막 단락이 반환됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
text | String | 단락으로 추가할 문자열입니다. |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
append Range(textRange)
제공된 텍스트 범위의 사본을 현재 텍스트 범위의 끝에 추가합니다.
삽입된 텍스트의 서식이 소스 텍스트의 서식과 일치합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
text | Text | 추가할 텍스트 범위입니다. |
리턴
Text
- 추가된 텍스트를 나타내는 텍스트 범위입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
append Range(textRange, matchSourceFormatting)
제공된 텍스트 범위의 사본을 현재 텍스트 범위의 끝에 추가합니다.
대상 텍스트의 서식과 일치하도록 설정된 경우 제공된 텍스트 범위 내의 Auto
이 렌더링된 값으로 대체됩니다. 또한 제공된 텍스트 범위 내의 텍스트가 아닌 요소는 추가되지 않습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
text | Text | 추가할 텍스트 범위입니다. |
match | Boolean | true 인 경우 소스 텍스트의 서식을 일치시키고 false 인 경우 대상 텍스트의 서식을 일치시킵니다. |
리턴
Text
- 추가된 텍스트를 나타내는 텍스트 범위입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
append Text(text)
as Rendered String()
최종 사용자에게 표시하기에 적합한 형식으로 이 범위에 의해 바운드된 연결된 도형 또는 표 셀의 렌더링된 텍스트를 반환합니다.
생성된 슬라이드 번호와 같은 Auto
리턴
String
- 범위에 렌더링된 텍스트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
as String()
연결된 도형 또는 표 셀의 이 범위로 제한된 원시 텍스트를 반환합니다.
생성된 슬라이드 번호와 범위 내의 텍스트가 아닌 요소와 같은 Auto
리턴
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)
범위에서 시작 및 종료 오프셋으로 제한된 텍스트를 지웁니다.
텍스트는 줄바꿈으로 끝나야 하므로 텍스트의 마지막 줄바꿈은 지정된 오프셋으로 덮여도 삭제되지 않습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
start | Integer | 삭제할 범위의 포함된 시작 색인을 결정하는 데 사용되는 현재 텍스트 범위의 시작 색인을 지난 문자 수입니다. 시작 오프셋은 0 이상이고 end 이하이어야 합니다. start
또한 현재 범위의 길이보다 작아야 합니다. |
end | Integer | 삭제할 범위의 배타적 종료 색인을 결정하는 데 사용되는 현재 텍스트 범위의 시작 색인을 지난 문자 수입니다. end 는 start 이상이어야 합니다. end 는 현재 범위의 길이보다 작거나 같아야 합니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
find(pattern)
현재 텍스트 범위에서 검색 패턴과 일치하는 모든 범위를 반환합니다. 검색 시 대소문자를 구분합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
pattern | String | 검색할 정규 표현식 패턴입니다. 패턴의 모든 백슬래시는 이스케이프해야 합니다. |
리턴
Text
- 텍스트 범위 목록입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
find(pattern, startOffset)
시작 오프셋부터 시작하는 현재 텍스트 범위에서 검색 패턴과 일치하는 모든 범위를 반환합니다. 검색 시 대소문자를 구분합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
pattern | String | 검색할 정규 표현식 패턴입니다. 패턴의 모든 백슬래시는 이스케이프해야 합니다. |
start | Integer | 검색할 범위의 포함된 시작 색인을 결정하는 데 사용되는 현재 텍스트 범위의 시작 색인을 지난 문자 수입니다. start 은 현재 범위의 길이보다 작아야 합니다. |
리턴
Text
- 텍스트 범위 목록입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Auto Texts()
현재 텍스트 범위 내의 자동 텍스트를 반환합니다.
리턴
Auto
- 자동 텍스트 목록입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get End Index()
이 범위의 마지막 문자에 대한 0 기반 독점 색인을 반환합니다. 시작 및 종료 색인이 동일하면 범위가 비어 있는 것으로 간주됩니다.
리턴
Integer
- 범위의 끝 색인입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Length()
이 범위의 문자 수를 반환합니다.
리턴
Integer
- 이 범위의 문자 수입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Links()
현재 텍스트 범위 내에 있거나 현재 텍스트 범위와 겹치는 모든 Link
에 해당하는 텍스트 범위 컬렉션을 반환합니다.
반환된 각 범위는 생성될 때 하나의 링크에 걸쳐 있는 것으로 보장됩니다. 텍스트를 수정하면 정확히 하나의 링크를 더 이상 나타내지 않을 수 있습니다.
반환된 범위의 각 Link
는 Text
를 통해 액세스할 수 있습니다.
// Accesses the first link on a TextRange object. const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText(); const linkTextRange = textRange.getLinks()[0]; const textStyle = linkTextRange.getTextStyle(); Logger.log(textStyle.hasLink()); // logs 'true' const link = textStyle.getLink(); // Link object
리턴
Text
- 텍스트 범위 목록입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get List Paragraphs()
현재 텍스트 범위와 겹치는 목록의 단락을 반환합니다.
리턴
Paragraph[]
- 목록의 단락 목록입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get List Style()
get Paragraph Style()
현재 텍스트 범위의 Paragraph
를 반환합니다.
리턴
Paragraph
- 현재 텍스트 범위의 단락 스타일입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Paragraphs()
현재 텍스트 범위와 겹치는 단락을 반환합니다.
리턴
Paragraph[]
- 단락 목록입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Range(startOffset, endOffset)
파생된 범위의 일부를 포함하는 새 Text
를 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
start | Integer | 반환된 범위의 포함된 시작 색인을 결정하는 데 사용되는 현재 텍스트 범위의 시작 색인을 지난 문자 수입니다. 시작 오프셋은 0 이상이고 end 이하이어야 합니다. start
또한 현재 범위의 길이보다 작아야 합니다. |
end | Integer | 반환된 범위의 배타적 종료 색인을 결정하는 데 사용되는 현재 텍스트 범위의 시작 색인을 지난 문자 수입니다. end 는 start 이상이어야 합니다. end 는 현재 범위의 길이보다 작거나 같아야 합니다. |
리턴
Text
- 새 텍스트 범위입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Runs()
현재 텍스트 범위와 겹치는 텍스트 실행을 반환합니다. 텍스트 실행은 모든 문자의 텍스트 스타일이 동일한 텍스트 세그먼트입니다.
반환된 각 범위는 생성될 때 하나의 실행만 포함하도록 보장됩니다. 텍스트 또는 스타일을 수정하면 더 이상 정확히 하나의 러닝을 나타내지 않을 수 있습니다.
리턴
Text
- 텍스트 범위 목록입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Start Index()
이 범위의 첫 번째 문자에 대한 0부터 시작하는 색인(포함)을 반환합니다. 시작 및 종료 색인이 동일한 경우 범위가 비어 있는 것으로 간주됩니다.
리턴
Integer
- 범위의 시작 색인입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Text Style()
insert Paragraph(startOffset, text)
시작 오프셋에 단락을 삽입합니다. 단락은 시작 오프셋에서 현재 텍스트 범위의 스타일을 유지합니다.
제공된 텍스트 문자열은 문자열에 하나 이상의 둘러싸는 줄바꿈 문자를 추가하여 단락으로 삽입됩니다.
제공된 텍스트 문자열에 줄바꿈 문자가 포함되어 여러 단락으로 구성된 경우 추가된 마지막 단락이 반환됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
start | Integer | 삽입할 텍스트의 포함된 시작 색인을 결정하는 데 사용되는 현재 텍스트 범위의 시작 색인 이후의 문자 수입니다. |
text | String | 삽입할 문자열입니다. |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Range(startOffset, textRange)
제공된 텍스트 범위의 사본을 시작 오프셋에 삽입합니다.
삽입된 텍스트의 서식이 소스 텍스트의 서식과 일치합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
start | Integer | 삽입할 텍스트의 포함된 시작 색인을 결정하는 데 사용되는 현재 텍스트 범위의 시작 색인 이후의 문자 수입니다. |
text | Text | 삽입할 텍스트 범위입니다. |
리턴
Text
- 삽입된 텍스트를 나타내는 텍스트 범위입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Range(startOffset, textRange, matchSourceFormatting)
제공된 텍스트 범위의 사본을 시작 오프셋에 삽입합니다.
대상 텍스트의 서식과 일치하도록 설정된 경우 제공된 텍스트 범위 내의 Auto
이 렌더링된 값으로 대체됩니다. 또한 제공된 텍스트 범위 내의 텍스트가 아닌 요소는 삽입되지 않습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
start | Integer | 삽입할 텍스트의 포함된 시작 색인을 결정하는 데 사용되는 현재 텍스트 범위의 시작 색인 이후의 문자 수입니다. |
text | Text | 삽입할 텍스트 범위입니다. |
match | Boolean | true 인 경우 소스 텍스트의 서식을 일치시키고 false 인 경우 대상 텍스트의 서식을 일치시킵니다. |
리턴
Text
- 삽입된 텍스트를 나타내는 텍스트 범위입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Text(startOffset, text)
시작 오프셋에 텍스트를 삽입합니다. 텍스트는 시작 오프셋에서 기존 텍스트의 스타일을 유지합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
start | Integer | 삽입할 텍스트의 포함된 시작 색인을 결정하는 데 사용되는 현재 텍스트 범위의 시작 색인 이후의 문자 수입니다. |
text | String | 삽입할 문자열입니다. |
리턴
Text
- 삽입된 텍스트를 나타내는 텍스트 범위입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
is Empty()
이 범위에 문자가 없으면 true
를 반환하고, 그렇지 않으면 false
를 반환합니다.
리턴
Boolean
— 이 범위에 문자가 없으면 true
을 반환하고, 그렇지 않으면 false
를 반환합니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace All Text(findText, replaceText)
찾기 텍스트와 일치하는 모든 텍스트 인스턴스를 바꾸기 텍스트로 바꿉니다. 검색 시 대소문자를 구분하지 않습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
find | String | 찾을 텍스트입니다. |
replace | String | 일치하는 텍스트를 대체할 텍스트입니다. |
리턴
Integer
- 변경된 발생 횟수
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace All Text(findText, replaceText, matchCase)
찾기 텍스트와 일치하는 모든 텍스트 인스턴스를 바꾸기 텍스트로 바꿉니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
find | String | 찾을 텍스트입니다. |
replace | String | 일치하는 텍스트를 대체할 텍스트입니다. |
match | Boolean | true 이면 검색 시 대소문자를 구분하고, false 이면 검색 시 대소문자를 구분하지 않습니다. |
리턴
Integer
- 변경된 발생 횟수
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select()
활성 프레젠테이션에서 Text
만 선택하고 이전 선택을 삭제합니다.
스크립트는 스크립트를 실행하는 사용자의 선택 항목에만 액세스할 수 있으며, 스크립트가 프레젠테이션에 바인딩된 경우에만 액세스할 수 있습니다.
해당 Shape
또는 Table
의 상위 Page
이 current page selection
로 설정됩니다. Shape
또는 Table
이 selected page element
로 설정됩니다.
Selection
에는 두 가지 유형이 있습니다.
- 1. 텍스트 범위입니다. 비어 있지 않은 TextRange에서 select를 사용하여 문자 범위를 선택합니다.
- 2. 커서 위치: 빈 TextRange를 사용하여 원하는 색인에 커서를 배치합니다.
const 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
-
set Text(newText)
연결된 도형 또는 표 셀의 이 범위로 제한된 텍스트를 설정합니다. 텍스트는 기존 텍스트의 시작 부분의 스타일을 유지합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
new | String | 새 텍스트로 설정할 문자열입니다. |
리턴
Text
- 설정된 텍스트를 나타내는 텍스트 범위입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations