Class TextStyle

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()TextStyleLink를 삭제합니다.
setBackgroundColor(color)TextStyle텍스트의 배경 색상을 설정합니다.
setBackgroundColor(red, green, blue)TextStyle텍스트의 배경색을 0에서 255 사이의 지정된 RGB 값으로 설정합니다.
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텍스트의 전경색을 0~255 사이의 지정된 RGB 값으로 설정합니다.
setForegroundColor(hexColor)TextStyle텍스트의 전경색을 지정된 16진수 색상 문자열로 설정합니다.
setForegroundColor(color)TextStyle텍스트의 전경색을 지정된 ThemeColorType로 설정합니다.
setItalic(italic)TextStyle텍스트를 기울임꼴로 표시할지 여부를 설정합니다.
setLinkSlide(slideIndex)TextStyle0부터 시작하는 슬라이드 색인을 사용하여 Link를 지정된 Slide로 설정합니다.
setLinkSlide(slide)TextStyleLink를 지정된 Slide로 설정합니다. 링크는 지정된 슬라이드 ID로 설정됩니다.
setLinkSlide(slidePosition)TextStyle슬라이드의 상대 위치를 사용하여 Link를 지정된 Slide로 설정합니다.
setLinkUrl(url)TextStyleLink를 비어 있지 않은 지정된 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입니다. ('정상')을 지정합니다.

리턴

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

텍스트의 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

텍스트에 링크가 있으면 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

Link를 삭제합니다.

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

text.getTextStyle().removeLink();

리턴

TextStyle

setBackgroundColor(color)

텍스트의 배경 색상을 설정합니다.

매개변수

이름유형설명
colorColor

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setBackgroundColor(red, green, blue)

텍스트의 배경색을 0에서 255 사이의 지정된 RGB 값으로 설정합니다.

매개변수

이름유형설명
redInteger
greenInteger
blueInteger

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setBackgroundColor(hexColor)

텍스트의 배경색을 지정된 16진수 색상 문자열로 설정합니다.

16진수 문자열은 '#RRGGBB' 형식이어야 합니다. 예를 들어 분홍색은 '#FFC0CB'

매개변수

이름유형설명
hexColorString

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setBackgroundColor(color)

텍스트의 배경색을 지정된 ThemeColorType로 설정합니다.

매개변수

이름유형설명
colorThemeColorType

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setBackgroundColorTransparent()

텍스트의 배경색을 투명으로 설정합니다.

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setBaselineOffset(offset)

법선 위치를 기준으로 텍스트의 세로 오프셋을 설정합니다.

매개변수

이름유형설명
offsetTextBaselineOffset

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setBold(bold)

텍스트를 굵게 렌더링할지 여부를 설정합니다.

텍스트의 굵기를 변경하면 텍스트를 렌더링하는 데 사용되는 글꼴 두께가 업데이트됩니다.

매개변수

이름유형설명
boldBoolean

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFontFamily(fontFamily)

텍스트의 글꼴 모음을 설정합니다 .

매개변수

이름유형설명
fontFamilyString

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFontFamilyAndWeight(fontFamily, fontWeight)

텍스트의 글꼴 모음과 두께를 설정합니다.

가중치는 100과 900 사이 100의 배수입니다. 이 범위는 CSS 2.1 사양 섹션 15.6에 설명된 숫자 값 숫자가 아닌 값은 허용되지 않습니다. 700 이상의 가중치는 굵게 표시되며 이 경우 isBold()는 true를 반환합니다. 기본값은 400입니다. ('정상')을 지정합니다.

매개변수

이름유형설명
fontFamilyString
fontWeightInteger

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setFontSize(fontSize)

텍스트의 글꼴 크기를 포인트 단위로 설정합니다.

매개변수

이름유형설명
fontSizeNumber

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setForegroundColor(foregroundColor)

텍스트의 전경 색상을 설정합니다.

매개변수

이름유형설명
foregroundColorColor

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setForegroundColor(red, green, blue)

텍스트의 전경색을 0~255 사이의 지정된 RGB 값으로 설정합니다.

매개변수

이름유형설명
redInteger
greenInteger
blueInteger

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setForegroundColor(hexColor)

텍스트의 전경색을 지정된 16진수 색상 문자열로 설정합니다.

16진수 문자열은 '#RRGGBB' 형식이어야 합니다. 예를 들어 분홍색은 '#FFC0CB'

매개변수

이름유형설명
hexColorString

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setForegroundColor(color)

텍스트의 전경색을 지정된 ThemeColorType로 설정합니다.

매개변수

이름유형설명
colorThemeColorType

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setItalic(italic)

텍스트를 기울임꼴로 표시할지 여부를 설정합니다.

매개변수

이름유형설명
italicBoolean

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setLinkSlide(slideIndex)

0부터 시작하는 슬라이드 색인을 사용하여 Link를 지정된 Slide로 설정합니다.

링크를 설정하면 밑줄이 그어진 텍스트 스타일이 ThemeColorType.HYPERLINK 포그라운드 색상으로 변경됩니다. 이는 setForegroundColor(hexColor) 및 setUnderline(underline)를 통해 변경할 수 있습니다.

줄바꿈 문자에는 링크를 설정할 수 없으므로 TextRange의 줄바꿈 문자는 무시됩니다. 

// Set a link to the first slide of the presentation.
text.getTextStyle().setLinkSlide(0);

매개변수

이름유형설명
slideIndexInteger0부터 시작하는 슬라이드 색인입니다.

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • 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.
var slide = presentation.getSlides()[0];
text.getTextStyle().setLinkSlide(slide);

매개변수

이름유형설명
slideSlide연결할 Slide입니다.

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setLinkSlide(slidePosition)

슬라이드의 상대 위치를 사용하여 Link를 지정된 Slide로 설정합니다.

링크를 설정하면 밑줄이 그어진 텍스트 스타일이 ThemeColorType.HYPERLINK 포그라운드 색상으로 변경됩니다. 이는 setForegroundColor(hexColor) 및 setUnderline(underline)를 통해 변경할 수 있습니다.

줄바꿈 문자에는 링크를 설정할 수 없으므로 TextRange의 줄바꿈 문자는 무시됩니다. 

// Set a link to the first slide of the presentation.
text.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

매개변수

이름유형설명
slidePositionSlidePosition상대 SlidePosition입니다.

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • 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.
text.getTextStyle().setLinkUrl("https://slides.google.com");

매개변수

이름유형설명
urlStringURL 문자열입니다.

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setSmallCaps(smallCaps)

텍스트를 작은 대문자로 렌더링할지 여부를 설정합니다.

매개변수

이름유형설명
smallCapsBoolean

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setStrikethrough(strikethrough)

텍스트 취소 여부를 설정합니다.

매개변수

이름유형설명
strikethroughBoolean

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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

setUnderline(underline)

텍스트에 밑줄을 표시할지 여부를 설정합니다.

매개변수

이름유형설명
underlineBoolean

리턴

TextStyle

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

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