이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class TextStyle

텍스트 스타일입니다.

이 클래스의 읽기 메서드는 해당 TextRange가 여러 텍스트 실행에 걸쳐 있고 이러한 실행이 호출되는 읽기 메서드에 다른 값을 갖는 경우 null를 반환합니다. 이를 방지하려면 TextRange.getRuns() 메서드에서 반환된 TextRange를 사용하여 텍스트 스타일을 쿼리하세요.

텍스트가 도형에 들어가는 방식을 수정하는 메서드를 사용하면 텍스트 스타일에 적용된 자동 맞춤 설정이 비활성화됩니다.

방법

메서드	반환 유형	간략한 설명
`getBackgroundColor()`	`Color`	텍스트의 배경색을 반환하거나 텍스트에 여러 스타일이 있다면 `null`를 반환합니다.
`getBaselineOffset()`	`TextBaselineOffset`	법선 위치에서 텍스트의 세로 오프셋을 반환하거나 텍스트에 여러 스타일이 있다면 `null`를 반환합니다.
`getFontFamily()`	`String`	텍스트의 글꼴 모음을 반환하거나 텍스트에 여러 스타일이 있는 경우 `null`를 반환합니다.
`getFontSize()`	`Number`	포인트 단위의 텍스트의 글꼴 크기를 반환하거나 텍스트에 여러 스타일이 있다면 `null`를 반환합니다.
`getFontWeight()`	`Integer`	텍스트의 글꼴 두께를 반환하거나 텍스트에 여러 스타일이 있는 경우 `null`를 반환합니다.
`getForegroundColor()`	`Color`	텍스트의 포그라운드 색상을 반환하거나 텍스트에 여러 스타일이 있다면 `null`를 반환합니다.
`getLink()`	`Link`	텍스트에 `Link`를 반환하거나 링크가 없거나 링크가 텍스트 일부에 있거나 링크가 여러 개인 경우 `null`를 반환합니다.
`hasLink()`	`Boolean`	텍스트에 링크가 있으면 `true`, 링크가 없으면 `false`, 링크가 텍스트 일부에 있거나 링크가 여러 개 있는 경우 `null`를 반환합니다.
`isBackgroundTransparent()`	`Boolean`	텍스트의 배경이 투명하면 `true`, 그렇지 않으면 `false`, 텍스트에 여러 스타일이 있으면 `null`를 반환합니다.
`isBold()`	`Boolean`	텍스트가 굵게 렌더링되면 `true`, 그렇지 않으면 `false`, 텍스트에 여러 스타일이 있다면 `null`를 반환합니다.
`isItalic()`	`Boolean`	텍스트가 기울임꼴이면 `true`, 그렇지 않으면 `false`, 텍스트에 여러 스타일이 있다면 `null`를 반환합니다.
`isSmallCaps()`	`Boolean`	텍스트가 작은 대문자이면 `true`, 그렇지 않으면 `false`, 텍스트에 여러 스타일이 있으면 `null`를 반환합니다.
`isStrikethrough()`	`Boolean`	텍스트가 취소선으로 표시된 경우 `true`, 그렇지 않으면 `false`, 텍스트에 여러 스타일이 있는 경우 `null`를 반환합니다.
`isUnderline()`	`Boolean`	텍스트에 밑줄이 그어진 경우 `true`, 그렇지 않으면 `false`, 텍스트에 여러 스타일이 있는 경우 `null`를 반환합니다.
`removeLink()`	`TextStyle`	`Link`를 삭제합니다.
`setBackgroundColor(color)`	`TextStyle`	텍스트의 배경색을 설정합니다.
`setBackgroundColor(red, green, blue)`	`TextStyle`	텍스트의 배경색을 지정된 RGB 값(0~255)으로 설정합니다.
`setBackgroundColor(hexColor)`	`TextStyle`	텍스트의 배경색을 지정된 16진수 색상 문자열로 설정합니다.
`setBackgroundColor(color)`	`TextStyle`	텍스트의 배경색을 지정된 `ThemeColorType`로 설정합니다.
`setBackgroundColorTransparent()`	`TextStyle`	텍스트의 배경색을 투명으로 설정합니다.
`setBaselineOffset(offset)`	`TextStyle`	표준 위치를 기준으로 텍스트의 세로 오프셋을 설정합니다.
`setBold(bold)`	`TextStyle`	텍스트를 굵게 렌더링할지 여부를 설정합니다.
`setFontFamily(fontFamily)`	`TextStyle`	텍스트의 글꼴 모음을 설정합니다 .
`setFontFamilyAndWeight(fontFamily, fontWeight)`	`TextStyle`	글꼴 모음과 텍스트의 두께를 설정합니다.
`setFontSize(fontSize)`	`TextStyle`	텍스트의 글꼴 크기를 포인트 단위로 설정합니다.
`setForegroundColor(foregroundColor)`	`TextStyle`	텍스트의 전경색을 설정합니다.
`setForegroundColor(red, green, blue)`	`TextStyle`	텍스트의 전경색을 지정된 RGB 값(0~255)으로 설정합니다.
`setForegroundColor(hexColor)`	`TextStyle`	텍스트의 전경색을 지정된 16진수 색상 문자열로 설정합니다.
`setForegroundColor(color)`	`TextStyle`	텍스트의 전경색을 지정된 `ThemeColorType`로 설정합니다.
`setItalic(italic)`	`TextStyle`	텍스트를 기울임꼴로 표시할지 여부를 설정합니다.
`setLinkSlide(slideIndex)`	`TextStyle`	슬라이드의 0부터 시작하는 색인을 사용하여 `Link`를 지정된 `Slide`로 설정합니다.
`setLinkSlide(slide)`	`TextStyle`	`Link`를 지정된 `Slide`로 설정합니다. 링크는 지정된 슬라이드 ID로 설정됩니다.
`setLinkSlide(slidePosition)`	`TextStyle`	슬라이드의 상대 위치를 사용하여 `Link`를 지정된 `Slide`로 설정합니다.
`setLinkUrl(url)`	`TextStyle`	`Link`을 비어 있지 않은 지정된 URL 문자열로 설정합니다.
`setSmallCaps(smallCaps)`	`TextStyle`	텍스트를 작은 대문자로 렌더링할지 여부를 설정합니다.
`setStrikethrough(strikethrough)`	`TextStyle`	텍스트를 취소선 처리할지 여부를 설정합니다.
`setUnderline(underline)`	`TextStyle`	텍스트에 밑줄을 표시할지를 설정합니다.

자세한 문서

`getBackgroundColor()`

텍스트의 배경색을 반환하거나 텍스트에 여러 스타일이 있다면 null를 반환합니다.

리턴

Color

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getBaselineOffset()`

법선 위치에서 텍스트의 세로 오프셋을 반환하거나 텍스트에 여러 스타일이 있다면 null를 반환합니다.

리턴

TextBaselineOffset

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getFontFamily()`

텍스트의 글꼴 모음을 반환하거나 텍스트에 여러 스타일이 있는 경우 null를 반환합니다.

리턴

String

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getFontSize()`

포인트 단위의 텍스트의 글꼴 크기를 반환하거나 텍스트에 여러 스타일이 있다면 null를 반환합니다.

리턴

Number

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getForegroundColor()`

텍스트의 포그라운드 색상을 반환하거나 텍스트에 여러 스타일이 있다면 null를 반환합니다.

리턴

Color

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getLink()`

텍스트에 Link를 반환하거나 링크가 없거나 링크가 텍스트 일부에 있거나 링크가 여러 개인 경우 null를 반환합니다. hasLink()를 호출하여 텍스트에 링크가 없는지 확인합니다.

var textLink = shape.getText().getTextStyle().getLink();
if (textLink != null) {
  Logger.log('Shape text has a link of type: ' + textLink.getLinkType());
}

리턴

Link

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`hasLink()`

텍스트에 링크가 있으면 true, 링크가 없으면 false, 링크가 텍스트 일부에 있거나 링크가 여러 개 있는 경우 null를 반환합니다.

줄 바꿈 문자에는 링크를 설정할 수 없습니다. 따라서 TextRange에 줄바꿈 문자가 포함되어 있으면 이 메서드는 항상 null 또는 false을 반환합니다.

리턴

Boolean

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`isBackgroundTransparent()`

텍스트의 배경이 투명하면 true, 그렇지 않으면 false, 텍스트에 여러 스타일이 있으면 null를 반환합니다.

리턴

Boolean

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`isBold()`

텍스트가 굵게 렌더링되면 true, 그렇지 않으면 false, 텍스트에 여러 스타일이 있다면 null를 반환합니다.

리턴

Boolean

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`isItalic()`

텍스트가 기울임꼴이면 true, 그렇지 않으면 false, 텍스트에 여러 스타일이 있다면 null를 반환합니다.

리턴

Boolean

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`isSmallCaps()`

텍스트가 작은 대문자이면 true, 그렇지 않으면 false, 텍스트에 여러 스타일이 있으면 null를 반환합니다.

리턴

Boolean

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`isStrikethrough()`

텍스트가 취소선으로 표시된 경우 true, 그렇지 않으면 false, 텍스트에 여러 스타일이 있는 경우 null를 반환합니다.

리턴

Boolean

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`isUnderline()`

텍스트에 밑줄이 그어진 경우 true, 그렇지 않으면 false, 텍스트에 여러 스타일이 있는 경우 null를 반환합니다.

리턴

Boolean

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`removeLink()`

Link를 삭제합니다.

링크를 삭제하면 텍스트에서 하이퍼링크 전경 색상과 밑줄 스타일이 삭제됩니다. 가능한 경우 이러한 스타일은 링크 앞에 있는 텍스트와 일치하도록 적용됩니다.

text.getTextStyle().removeLink();

Class TextStyle

방법

자세한 문서

getBackgroundColor()

리턴

승인

getBaselineOffset()

리턴

승인

getFontFamily()

리턴

승인

getFontSize()

리턴

승인

getFontWeight()

리턴

승인

getForegroundColor()

리턴

승인

getLink()

리턴

승인

hasLink()

리턴

승인

isBackgroundTransparent()

리턴

승인

isBold()

리턴

승인

isItalic()

리턴

승인

isSmallCaps()

리턴

승인

isStrikethrough()

리턴

승인

isUnderline()

리턴

승인

removeLink()

리턴

setBackgroundColor(color)

매개변수

리턴

승인

setBackgroundColor(red, green, blue)

매개변수

리턴

승인

setBackgroundColor(hexColor)

매개변수

리턴

승인

setBackgroundColor(color)

매개변수

리턴

승인

setBackgroundColorTransparent()

리턴

승인

setBaselineOffset(offset)

매개변수

리턴

승인

setBold(bold)

매개변수

리턴

승인

setFontFamily(fontFamily)

매개변수

리턴

승인

setFontFamilyAndWeight(fontFamily, fontWeight)

매개변수

`getBackgroundColor()`

`getBaselineOffset()`

`getFontFamily()`

`getFontSize()`

`getFontWeight()`

`getForegroundColor()`

`getLink()`

`hasLink()`

`isBackgroundTransparent()`

`isBold()`

`isItalic()`

`isSmallCaps()`

`isStrikethrough()`

`isUnderline()`

`removeLink()`

`setBackgroundColor(color)`

`setBackgroundColor(red, green, blue)`

`setBackgroundColor(hexColor)`

`setBackgroundColor(color)`

`setBackgroundColorTransparent()`

`setBaselineOffset(offset)`

`setBold(bold)`

`setFontFamily(fontFamily)`

`setFontFamilyAndWeight(fontFamily, fontWeight)`

`setFontSize(fontSize)`

`setForegroundColor(foregroundColor)`

`setForegroundColor(red, green, blue)`

`setForegroundColor(hexColor)`

`setForegroundColor(color)`

`setItalic(italic)`

`setLinkSlide(slideIndex)`

`setLinkSlide(slide)`

`setLinkSlide(slidePosition)`

`setLinkUrl(url)`

`setSmallCaps(smallCaps)`

`setStrikethrough(strikethrough)`

`setUnderline(underline)`