텍스트 스타일입니다.
이 클래스의 읽기 메서드는 해당 TextRange이 여러 텍스트 실행에 걸쳐 있고 이러한 실행에 호출되는 읽기 메서드의 값이 서로 다른 경우 null을 반환합니다. 이를 방지하려면 TextRange.getRuns() 메서드에서 반환된 TextRange를 사용하여 텍스트 스타일을 쿼리하세요.
텍스트가 도형에 맞도록 수정하는 방법을 사용하면 텍스트 스타일에 적용된 자동 맞춤 설정이 비활성화됩니다.
메서드
| 메서드 | 반환 유형 | 간략한 설명 |
|---|---|---|
get | Color|null | 텍스트의 배경색을 반환합니다. 텍스트에 여러 스타일이 있는 경우 null를 반환합니다. |
get | Text | 텍스트의 일반 위치에서 세로 오프셋을 반환합니다. 텍스트에 여러 스타일이 있는 경우 null을 반환합니다. |
get | String|null | 텍스트의 글꼴 모음을 반환합니다. 텍스트에 여러 스타일이 있는 경우 null를 반환합니다. |
get | Number|null | 텍스트의 글꼴 크기를 포인트 단위로 반환합니다. 텍스트에 스타일이 여러 개 있는 경우 null를 반환합니다. |
get | Integer|null | 텍스트의 글꼴 두께를 반환합니다. 텍스트에 여러 스타일이 있는 경우 null를 반환합니다. |
get | Color|null | 텍스트의 전경색을 반환합니다. 텍스트에 여러 스타일이 있는 경우 null를 반환합니다. |
get | Link|null | 텍스트의 Link를 반환합니다. 링크가 없거나 링크가 텍스트의 일부에 있거나 링크가 여러 개인 경우 null를 반환합니다. |
has | Boolean|null | 텍스트에 링크가 있으면 true를 반환하고, 없으면 false를 반환하며, 텍스트의 일부에 링크가 있거나 링크가 여러 개 있으면 null를 반환합니다. |
is | Boolean|null | 텍스트의 배경이 투명하면 true를 반환하고, 그렇지 않으면 false를 반환하며, 텍스트에 여러 스타일이 있으면 null를 반환합니다. |
is | Boolean|null | 텍스트가 굵게 표시되면 true를 반환하고, 그렇지 않으면 false를 반환하며, 텍스트에 여러 스타일이 있으면 null를 반환합니다. |
is | Boolean|null | 텍스트가 기울임체이면 true를, 그렇지 않으면 false를, 텍스트에 여러 스타일이 있으면 null를 반환합니다. |
is | Boolean|null | 텍스트가 소형 대문자인 경우 true를 반환하고, 그렇지 않은 경우 false를 반환하며, 텍스트에 여러 스타일이 있는 경우 null를 반환합니다. |
is | Boolean|null | 텍스트에 취소선이 있으면 true를, 없으면 false를, 텍스트에 여러 스타일이 있으면 null를 반환합니다. |
is | Boolean|null | 텍스트에 밑줄이 있으면 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 기반 색인을 사용하여 지정된 Slide에 Link을 설정합니다. |
set | Text | Link을 지정된 Slide로 설정합니다. 링크는 지정된 슬라이드 ID로 설정됩니다. |
set | Text | 슬라이드의 상대적 위치를 사용하여 지정된 Slide에 Link를 설정합니다. |
set | Text | Link를 지정된 비어 있지 않은 URL 문자열로 설정합니다. |
set | Text | 텍스트가 소형 대문자로 렌더링되는지 여부를 설정합니다. |
set | Text | 텍스트에 취소선을 적용할지 여부를 설정합니다. |
set | Text | 텍스트에 밑줄이 표시되는지 여부를 설정합니다. |
자세한 문서
getBackgroundColor()
getBaselineOffset()
텍스트의 일반 위치에서 세로 오프셋을 반환합니다. 텍스트에 여러 스타일이 있는 경우 null을 반환합니다.
리턴
TextBaselineOffset|null - 텍스트의 일반 위치에서 세로 오프셋입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
getFontFamily()
텍스트의 글꼴 모음을 반환합니다. 텍스트에 여러 스타일이 있는 경우 null를 반환합니다.
리턴
String|null - 텍스트의 글꼴 모음입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
getFontSize()
텍스트의 글꼴 크기를 포인트 단위로 반환합니다. 텍스트에 스타일이 여러 개 있는 경우 null를 반환합니다.
리턴
Number|null: 텍스트의 글꼴 크기(포인트)입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
getFontWeight()
텍스트의 글꼴 두께를 반환합니다. 텍스트에 여러 스타일이 있는 경우 null를 반환합니다.
가중치는 100에서 900까지 100의 배수입니다. 이 범위는 CSS 2.1 사양의 섹션 15.6에 설명된 숫자 값에 해당하며 숫자 이외의 값은 허용되지 않습니다. 가중치가 700 이상이면 굵은 글씨로 간주되며 이 경우 isBold()는 true를 반환합니다. 기본값은 400('normal')입니다.
리턴
Integer|null - 텍스트의 글꼴 두께입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
getForegroundColor()
getLink()
텍스트의 Link를 반환합니다. 링크가 없거나 링크가 텍스트의 일부에 있거나 링크가 여러 개인 경우 null를 반환합니다. hasLink()를 호출하여 텍스트에 링크가 없는지 확인합니다.
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()}`); }
리턴
Link|null: 텍스트의 링크입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
hasLink()
텍스트에 링크가 있으면 true를 반환하고, 없으면 false를 반환하며, 텍스트의 일부에 링크가 있거나 링크가 여러 개 있으면 null를 반환합니다.
링크는 줄 바꿈 문자에 설정할 수 없습니다. 따라서 TextRange에 줄바꿈 문자가 포함되어 있으면 이 메서드는 항상 null 또는 false를 반환합니다.
리턴
Boolean|null - 텍스트에 링크가 있는지 여부
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
isBackgroundTransparent()
텍스트의 배경이 투명하면 true를 반환하고, 그렇지 않으면 false를 반환하며, 텍스트에 여러 스타일이 있으면 null를 반환합니다.
리턴
Boolean|null - 텍스트의 배경이 투명한지 여부입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
isBold()
텍스트가 굵게 표시되면 true를 반환하고, 그렇지 않으면 false를 반환하며, 텍스트에 여러 스타일이 있으면 null를 반환합니다.
리턴
Boolean|null - 텍스트가 굵게 렌더링되는지 여부입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
isItalic()
텍스트가 기울임체이면 true를, 그렇지 않으면 false를, 텍스트에 여러 스타일이 있으면 null를 반환합니다.
리턴
Boolean|null - 텍스트의 기울임체 여부입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
isSmallCaps()
텍스트가 소형 대문자인 경우 true를 반환하고, 그렇지 않은 경우 false를 반환하며, 텍스트에 여러 스타일이 있는 경우 null를 반환합니다.
리턴
Boolean|null - 텍스트가 소형 대문자인지 여부입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
isStrikethrough()
텍스트에 취소선이 있으면 true를, 없으면 false를, 텍스트에 여러 스타일이 있으면 null를 반환합니다.
리턴
Boolean|null - 텍스트에 취소선이 그어져 있는지 여부입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
isUnderline()
텍스트에 밑줄이 있으면 true를, 없으면 false를, 텍스트에 여러 스타일이 있으면 null를 반환합니다.
리턴
Boolean|null - 텍스트에 밑줄이 그어져 있는지 여부입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
removeLink()
setBackgroundColor(color)
setBackgroundColor(red, green, blue)
텍스트의 배경색을 0~255의 지정된 RGB 값으로 설정합니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
red | Integer | 색상의 빨간색 구성요소입니다. |
green | Integer | 색상의 녹색 구성요소입니다. |
blue | Integer | 색상의 파란색 구성요소입니다. |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
setBackgroundColor(hexColor)
텍스트의 배경색을 지정된 16진수 색상 문자열로 설정합니다.
16진수 문자열은 '#RRGGBB' 형식이어야 합니다. 예를 들어 분홍색은 다음과 같이 표현됩니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
hex | String | 16진수 색상 문자열입니다. |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
setBackgroundColor(color)
텍스트의 배경색을 지정된 ThemeColorType로 설정합니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
color | Theme | 테마 색상 유형입니다. |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
setBackgroundColorTransparent()
setBaselineOffset(offset)
일반 위치를 기준으로 텍스트의 세로 오프셋을 설정합니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
offset | Text | 설정할 기준 오프셋입니다. |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
setBold(bold)
setFontFamily(fontFamily)
setFontFamilyAndWeight(fontFamily, fontWeight)
setFontSize(fontSize)
setForegroundColor(foregroundColor)
setForegroundColor(red, green, blue)
텍스트의 전경색을 0~255의 지정된 RGB 값으로 설정합니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
red | Integer | 색상의 빨간색 구성요소입니다. |
green | Integer | 색상의 녹색 구성요소입니다. |
blue | Integer | 색상의 파란색 구성요소입니다. |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
setForegroundColor(hexColor)
텍스트의 전경색을 지정된 16진수 색상 문자열로 설정합니다.
16진수 문자열은 '#RRGGBB' 형식이어야 합니다. 예를 들어 분홍색은 다음과 같이 표현됩니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
hex | String | 16진수 색상 문자열입니다. |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
setForegroundColor(color)
텍스트의 전경색을 지정된 ThemeColorType로 설정합니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
color | Theme | 테마 색상 유형입니다. |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
setItalic(italic)
setLinkSlide(slideIndex)
슬라이드의 0 기반 색인을 사용하여 지정된 Slide에 Link을 설정합니다.
링크를 설정하면 텍스트 스타일이 밑줄이 그어지고 ThemeColorType.HYPERLINK 전경색이 적용되도록 변경됩니다. 이는 setForegroundColor(hexColor) 및 setUnderline(underline)을 통해 변경할 수 있습니다.
링크는 줄바꿈 문자에 설정할 수 없으므로 TextRange의 줄바꿈 문자는 무시됩니다.
// 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
setLinkSlide(slide)
Link을 지정된 Slide로 설정합니다. 링크는 지정된 슬라이드 ID로 설정됩니다.
링크를 설정하면 텍스트 스타일이 밑줄이 그어지고 ThemeColorType.HYPERLINK 전경색이 적용되도록 변경됩니다. 이는 setForegroundColor(hexColor) 및 setUnderline(underline)을 통해 변경할 수 있습니다.
링크는 줄바꿈 문자에 설정할 수 없으므로 TextRange의 줄바꿈 문자는 무시됩니다.
// 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
setLinkSlide(slidePosition)
슬라이드의 상대적 위치를 사용하여 지정된 Slide에 Link를 설정합니다.
링크를 설정하면 텍스트 스타일이 밑줄이 그어지고 ThemeColorType.HYPERLINK 전경색이 적용되도록 변경됩니다. 이는 setForegroundColor(hexColor) 및 setUnderline(underline)을 통해 변경할 수 있습니다.
링크는 줄바꿈 문자에 설정할 수 없으므로 TextRange의 줄바꿈 문자는 무시됩니다.
// 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
setLinkUrl(url)
Link를 지정된 비어 있지 않은 URL 문자열로 설정합니다.
링크를 설정하면 텍스트 스타일이 밑줄이 그어지고 ThemeColorType.HYPERLINK 전경색이 적용되도록 변경됩니다. 이는 setForegroundColor(hexColor) 및 setUnderline(underline)을 통해 변경할 수 있습니다.
링크는 줄바꿈 문자에 설정할 수 없으므로 TextRange의 줄바꿈 문자는 무시됩니다.
// 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