텍스트 스타일입니다.
이 클래스의 읽기 메서드는 해당 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