텍스트 스타일입니다.
이 클래스의 읽기 메서드는 해당 Text
가 여러 텍스트 실행에 걸쳐 있고 이러한 실행에 호출되는 읽기 메서드의 값이 다른 경우 null
를 반환합니다. 이를 방지하려면 Text
메서드에서 반환된 Text
를 사용하여 텍스트 스타일을 쿼리합니다.
텍스트가 도형 내에 맞는 방식을 수정하는 메서드를 사용하면 텍스트 스타일에 적용된 모든 자동 조정 설정이 비활성화됩니다.
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
get | Color | 텍스트의 배경 색상 또는 텍스트에 여러 스타일이 있는 경우 null 를 반환합니다. |
get | Text | 텍스트의 일반 위치에서 텍스트의 세로 오프셋을 반환하거나 텍스트에 여러 스타일이 있는 경우 null 을 반환합니다. |
get | String | 텍스트의 글꼴 모음을 반환하거나 텍스트에 여러 스타일이 있는 경우 null 를 반환합니다. |
get | Number | 텍스트의 글꼴 크기(포인트)를 반환하거나 텍스트에 여러 스타일이 있는 경우 null 를 반환합니다. |
get | Integer | 텍스트의 글꼴 두께를 반환하거나 텍스트에 여러 스타일이 있는 경우 null 를 반환합니다. |
get | Color | 텍스트의 전경 색상 또는 텍스트에 여러 스타일이 있는 경우 null 를 반환합니다. |
get | Link | 텍스트의 Link 를 반환하거나 링크가 없거나 링크가 텍스트의 일부에 있거나 링크가 여러 개인 경우 null 을 반환합니다. |
has | Boolean | 텍스트에 링크가 있으면 true 를, 링크가 없으면 false 를, 링크가 텍스트의 일부에 있거나 링크가 여러 개 있는 경우에는 null 를 반환합니다. |
is | Boolean | 텍스트의 배경이 투명하면 true 를, 투명하지 않으면 false 를, 텍스트에 여러 스타일이 있으면 null 를 반환합니다. |
is | Boolean | 텍스트가 굵게 렌더링된 경우 true , 그렇지 않은 경우 false , 텍스트에 여러 스타일이 있는 경우 null 를 반환합니다. |
is | Boolean | 텍스트가 기울임꼴인 경우 true , 기울임꼴이 아닌 경우 false , 텍스트에 여러 스타일이 있는 경우 null 를 반환합니다. |
is | Boolean | 텍스트가 소문자 대문자인지 여부에 따라 true , false 또는 null 를 반환합니다. 텍스트에 여러 스타일이 있는 경우에는 null 를 반환합니다. |
is | Boolean | 텍스트가 취소선이 그어진 경우 true , 취소선이 그어지지 않은 경우 false , 텍스트에 여러 스타일이 있는 경우 null 를 반환합니다. |
is | Boolean | 텍스트에 밑줄이 있는 경우 true , 밑줄이 없는 경우 false , 텍스트에 여러 스타일이 있는 경우 null 를 반환합니다. |
remove | Text | Link 를 삭제합니다. |
set | Text | 텍스트의 배경 색상을 설정합니다. |
set | Text | 텍스트의 배경 색상을 0~255 사이의 지정된 RGB 값으로 설정합니다. |
set | Text | 텍스트의 배경 색상을 지정된 16진수 색상 문자열로 설정합니다. |
set | Text | 텍스트의 배경 색상을 지정된 Theme 로 설정합니다. |
set | Text | 텍스트의 배경 색상을 투명하게 설정합니다. |
set | Text | 텍스트의 일반 위치를 기준으로 텍스트의 세로 오프셋을 설정합니다. |
set | Text | 텍스트를 굵게 렌더링할지 여부를 설정합니다. |
set | Text | 텍스트의 글꼴 모음을 설정합니다 . |
set | Text | 텍스트의 글꼴 모음 및 두께를 설정합니다. |
set | Text | 텍스트의 글꼴 크기를 포인트로 설정합니다. |
set | Text | 텍스트의 전경 색상을 설정합니다. |
set | Text | 텍스트의 전경 색상을 0~255 사이의 지정된 RGB 값으로 설정합니다. |
set | Text | 텍스트의 전경 색상을 지정된 16진수 색상 문자열로 설정합니다. |
set | Text | 텍스트의 전경 색상을 지정된 Theme 로 설정합니다. |
set | Text | 텍스트의 기울임꼴 여부를 설정합니다. |
set | Text | 슬라이드의 0부터 시작하는 색인을 사용하여 Link 를 지정된 Slide 로 설정합니다. |
set | Text | Link 를 지정된 Slide 로 설정합니다. 링크는 지정된 슬라이드 ID로 설정됩니다. |
set | Text | 슬라이드의 상대 위치를 사용하여 Link 를 지정된 Slide 에 설정합니다. |
set | Text | Link 를 주어진 비어 있지 않은 URL 문자열로 설정합니다. |
set | Text | 텍스트를 소문자 대문자로 렌더링할지 여부를 설정합니다. |
set | Text | 텍스트를 취소선 처리할지 여부를 설정합니다. |
set | Text | 텍스트에 밑줄을 표시할지 여부를 설정합니다. |
자세한 문서
get Background Color()
get Baseline Offset()
텍스트의 일반 위치에서 텍스트의 세로 오프셋을 반환하거나 텍스트에 여러 스타일이 있는 경우 null
을 반환합니다.
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Font Family()
텍스트의 글꼴 모음을 반환하거나 텍스트에 여러 스타일이 있는 경우 null
를 반환합니다.
리턴
String
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Font Size()
텍스트의 글꼴 크기(포인트)를 반환하거나 텍스트에 여러 스타일이 있는 경우 null
를 반환합니다.
리턴
Number
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Font Weight()
텍스트의 글꼴 두께를 반환하거나 텍스트에 여러 스타일이 있는 경우 null
를 반환합니다.
가중치는 100과 900 사이의 100의 배수입니다. 이 범위는 CSS 2.1 사양 15.6절에 설명된 숫자 값에 해당하며 숫자가 아닌 값은 허용되지 않습니다. 700 이상인 글꼴 크기는 굵은 글꼴로 간주되며 이 경우 is
는 true
를 반환합니다. 기본값은 400('normal')입니다.
리턴
Integer
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Foreground Color()
get Link()
텍스트의 Link
를 반환하거나 링크가 없거나 링크가 텍스트의 일부에 있거나 링크가 여러 개인 경우 null
을 반환합니다. has
를 호출하여 텍스트에 링크가 없는지 확인합니다.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; const textLink = shape.getText().getTextStyle().getLink(); if (textLink != null) { Logger.log(`Shape text has a link of type: ${textLink.getLinkType()}`); }
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
has Link()
텍스트에 링크가 있으면 true
를, 링크가 없으면 false
를, 링크가 텍스트의 일부에 있거나 링크가 여러 개 있는 경우에는 null
를 반환합니다.
줄바꿈 문자에는 링크를 설정할 수 없습니다. 따라서 Text
에 줄바꿈 문자가 포함된 경우 이 메서드는 항상 null
또는 false
를 반환합니다.
리턴
Boolean
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
is Background Transparent()
텍스트의 배경이 투명하면 true
를, 투명하지 않으면 false
를, 텍스트에 여러 스타일이 있으면 null
를 반환합니다.
리턴
Boolean
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
is Bold()
텍스트가 굵게 렌더링된 경우 true
, 그렇지 않은 경우 false
, 텍스트에 여러 스타일이 있는 경우 null
를 반환합니다.
리턴
Boolean
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
is Italic()
텍스트가 기울임꼴인 경우 true
, 기울임꼴이 아닌 경우 false
, 텍스트에 여러 스타일이 있는 경우 null
를 반환합니다.
리턴
Boolean
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
is Small Caps()
텍스트가 소문자 대문자인지 여부에 따라 true
, false
또는 null
를 반환합니다. 텍스트에 여러 스타일이 있는 경우에는 null
를 반환합니다.
리턴
Boolean
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
is Strikethrough()
텍스트가 취소선이 그어진 경우 true
, 취소선이 그어지지 않은 경우 false
, 텍스트에 여러 스타일이 있는 경우 null
를 반환합니다.
리턴
Boolean
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
is Underline()
텍스트에 밑줄이 있는 경우 true
, 밑줄이 없는 경우 false
, 텍스트에 여러 스타일이 있는 경우 null
를 반환합니다.
리턴
Boolean
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove Link()
set Background Color(color)
set Background Color(red, green, blue)
set Background Color(hexColor)
set Background Color(color)
텍스트의 배경 색상을 지정된 Theme
로 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
color | Theme |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Background Color Transparent()
set Baseline Offset(offset)
텍스트의 일반 위치를 기준으로 텍스트의 세로 오프셋을 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
offset | Text |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Bold(bold)
set Font Family(fontFamily)
set Font Family And Weight(fontFamily, fontWeight)
텍스트의 글꼴 모음 및 두께를 설정합니다.
가중치는 100과 900 사이의 100의 배수입니다. 이 범위는 CSS 2.1 사양 15.6절에 설명된 숫자 값에 해당하며 숫자가 아닌 값은 허용되지 않습니다. 700 이상인 글꼴 크기는 굵은 글꼴로 간주되며 이 경우 is
는 true
를 반환합니다. 기본값은 400('normal')입니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
font | String | |
font | Integer |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Font Size(fontSize)
set Foreground Color(foregroundColor)
set Foreground Color(red, green, blue)
set Foreground Color(hexColor)
set Foreground Color(color)
텍스트의 전경 색상을 지정된 Theme
로 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
color | Theme |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Italic(italic)
set Link Slide(slideIndex)
슬라이드의 0부터 시작하는 색인을 사용하여 Link
를 지정된 Slide
로 설정합니다.
링크를 설정하면 텍스트 스타일이 변경되어 밑줄이 생기고 전경색이 Theme
로 설정됩니다. 이는 set
및 set
을 통해 변경할 수 있습니다.
줄바꿈 문자에는 링크를 설정할 수 없으므로 Text
의 줄바꿈 문자는 무시됩니다.
// Set a link to the first slide of the presentation. const presentation = SlidesApp.getActivePresentation(); const slide = presentation.getSlides()[0]; const textRange = slide.getShapes()[0].getText(); textRange.getTextStyle().setLinkSlide(0);
매개변수
이름 | 유형 | 설명 |
---|---|---|
slide | Integer | 슬라이드의 0부터 시작하는 색인입니다. |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Link Slide(slide)
Link
를 지정된 Slide
로 설정합니다. 링크는 지정된 슬라이드 ID로 설정됩니다.
링크를 설정하면 텍스트 스타일이 변경되어 밑줄이 생기고 전경색이 Theme
로 설정됩니다. 이는 set
및 set
을 통해 변경할 수 있습니다.
줄바꿈 문자에는 링크를 설정할 수 없으므로 Text
의 줄바꿈 문자는 무시됩니다.
// Set a link to the first slide of the presentation. const presentation = SlidesApp.getActivePresentation(); const slide = presentation.getSlides()[0]; const textRange = slide.getShapes()[0].getText(); textRange.getTextStyle().setLinkSlide(slide);
매개변수
이름 | 유형 | 설명 |
---|---|---|
slide | Slide | 연결할 Slide 입니다. |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Link Slide(slidePosition)
슬라이드의 상대 위치를 사용하여 Link
를 지정된 Slide
에 설정합니다.
링크를 설정하면 텍스트 스타일이 변경되어 밑줄이 생기고 전경색이 Theme
로 설정됩니다. 이는 set
및 set
을 통해 변경할 수 있습니다.
줄바꿈 문자에는 링크를 설정할 수 없으므로 Text
의 줄바꿈 문자는 무시됩니다.
// Set a link to the first slide of the presentation. const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText(); textRange.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
매개변수
이름 | 유형 | 설명 |
---|---|---|
slide | Slide | 상대적 Slide 입니다. |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Link Url(url)
Link
를 주어진 비어 있지 않은 URL 문자열로 설정합니다.
링크를 설정하면 텍스트 스타일이 변경되어 밑줄이 생기고 전경색이 Theme
로 설정됩니다. 이는 set
및 set
을 통해 변경할 수 있습니다.
줄바꿈 문자에는 링크를 설정할 수 없으므로 Text
의 줄바꿈 문자는 무시됩니다.
// Set a link to the URL. const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText(); textRange.getTextStyle().setLinkUrl('https://slides.google.com');
매개변수
이름 | 유형 | 설명 |
---|---|---|
url | String | URL 문자열입니다. |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations