Class TextStyle

TextStyle

テキストのスタイル。

このクラスの読み取りメソッドは、対応する TextRange が複数のテキスト実行にまたがり、それらの実行で呼び出される読み取りメソッドの値が異なる場合、null を返します。これを回避するには、TextRange.getRuns() メソッドから返された TextRange を使用してテキスト スタイルをクエリします。

テキストが図形内に収まるように編集する方法を使用すると、テキスト スタイルに適用されている自動調整の設定は無効になります。

メソッド

メソッド戻り値の型概要
getBackgroundColor()Color|nullテキストの背景色を返します。テキストに複数のスタイルがある場合は null を返します。
getBaselineOffset()TextBaselineOffset|nullテキストの通常の位置からの垂直方向のオフセットを返します。テキストに複数のスタイルがある場合は null を返します。
getFontFamily()String|nullテキストのフォント ファミリーを返します。テキストに複数のスタイルがある場合は null を返します。
getFontSize()Number|nullテキストのフォントサイズをポイント単位で返します。テキストに複数のスタイルがある場合は null を返します。
getFontWeight()Integer|nullテキストのフォントの太さを返します。テキストに複数のスタイルがある場合は null を返します。
getForegroundColor()Color|nullテキストの前景色を返します。テキストに複数のスタイルがある場合は null を返します。
getLink()Link|nullテキストの Link を返します。リンクがない場合、リンクがテキストの一部にある場合、または複数のリンクがある場合は、null を返します。
hasLink()Boolean|nullテキストにリンクがある場合は true、ない場合は false、テキストの一部にリンクがある場合や複数のリンクがある場合は null を返します。
isBackgroundTransparent()Boolean|nullテキストの背景が透明な場合は true、透明でない場合は false、テキストに複数のスタイルがある場合は null を返します。
isBold()Boolean|nullテキストが太字でレンダリングされる場合は true、そうでない場合は false、テキストに複数のスタイルがある場合は null を返します。
isItalic()Boolean|nullテキストが斜体の場合 true、そうでない場合 false、テキストに複数のスタイルがある場合 null を返します。
isSmallCaps()Boolean|nullテキストがスモール キャップの場合は true、そうでない場合は false、テキストに複数のスタイルがある場合は null を返します。
isStrikethrough()Boolean|nullテキストに取り消し線が引かれている場合は true、引かれていない場合は false、テキストに複数のスタイルが適用されている場合は null を返します。
isUnderline()Boolean|nullテキストに下線が引かれている場合は 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)TextStyleスライドのゼロベースのインデックスを使用して、指定された Slide に Link を設定します。
setLinkSlide(slide)TextStyle指定された Slide に Link を設定します。リンクは指定されたスライド ID によって設定されます。
setLinkSlide(slidePosition)TextStyleスライドの相対位置を使用して、指定された Slide に Link を設定します。
setLinkUrl(url)TextStyleLink を指定された空でない URL 文字列に設定します。
setSmallCaps(smallCaps)TextStyleテキストをスモール キャップでレンダリングするかどうかを設定します。
setStrikethrough(strikethrough)TextStyleテキストに取り消し線が引かれているかどうかを設定します。
setUnderline(underline)TextStyleテキストに下線を引くかどうかを設定します。

詳細なドキュメント

getBackgroundColor()

テキストの背景色を返します。テキストに複数のスタイルがある場合は null を返します。

戻る

Color|null

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getBaselineOffset()

テキストの通常の位置からの垂直方向のオフセットを返します。テキストに複数のスタイルがある場合は null を返します。

戻る

TextBaselineOffset|null

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getFontFamily()

テキストのフォント ファミリーを返します。テキストに複数のスタイルがある場合は null を返します。

戻る

String|null

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getFontSize()

テキストのフォントサイズをポイント単位で返します。テキストに複数のスタイルがある場合は null を返します。

戻る

Number|null

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • 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

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getForegroundColor()

テキストの前景色を返します。テキストに複数のスタイルがある場合は null を返します。

戻る

Color|null

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

テキストの 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

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

テキストにリンクがある場合は true、ない場合は false、テキストの一部にリンクがある場合や複数のリンクがある場合は null を返します。

改行文字にリンクを設定することはできません。したがって、TextRange に改行文字が含まれている場合、このメソッドは常に null または false を返します。

戻る

Boolean|null

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

isBackgroundTransparent()

テキストの背景が透明な場合は true、透明でない場合は false、テキストに複数のスタイルがある場合は null を返します。

戻る

Boolean|null

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

isBold()

テキストが太字でレンダリングされる場合は true、そうでない場合は false、テキストに複数のスタイルがある場合は null を返します。

戻る

Boolean|null

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

isItalic()

テキストが斜体の場合 true、そうでない場合 false、テキストに複数のスタイルがある場合 null を返します。

戻る

Boolean|null

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

isSmallCaps()

テキストがスモール キャップの場合は true、そうでない場合は false、テキストに複数のスタイルがある場合は null を返します。

戻る

Boolean|null

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

isStrikethrough()

テキストに取り消し線が引かれている場合は true、引かれていない場合は false、テキストに複数のスタイルが適用されている場合は null を返します。

戻る

Boolean|null

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

isUnderline()

テキストに下線が引かれている場合は true、引かれていない場合は false、テキストに複数のスタイルが適用されている場合は null を返します。

戻る

Boolean|null

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

Link を削除します。

リンクを削除すると、テキストのハイパーリンクの前景色と下線スタイルが削除されます。可能な場合は、これらのスタイルが適用され、リンクの前のテキストと一致します。

const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().removeLink();

戻る

TextStyle

setBackgroundColor(color)

テキストの背景色を設定します。

パラメータ

名前型説明
colorColor

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setBackgroundColor(red, green, blue)

テキストの背景色を、0 ～ 255 の RGB 値で指定します。

パラメータ

名前型説明
redInteger
greenInteger
blueInteger

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setBackgroundColor(hexColor)

テキストの背景色を指定された 16 進数の色文字列に設定します。

16 進数文字列は「#RRGGBB」の形式にする必要があります。たとえば、ピンクは「#FFC0CB」と表されます。

パラメータ

名前型説明
hexColorString

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setBackgroundColor(color)

テキストの背景色を指定された ThemeColorType に設定します。

パラメータ

名前型説明
colorThemeColorType

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setBackgroundColorTransparent()

テキストの背景色を透明に設定します。

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setBaselineOffset(offset)

テキストの垂直方向のオフセットを通常の位置を基準に設定します。

パラメータ

名前型説明
offsetTextBaselineOffset

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setBold(bold)

テキストを太字でレンダリングするかどうかを設定します。

テキストの太さを変更すると、テキストのレンダリングに使用されるフォントの太さが更新されます。

パラメータ

名前型説明
boldBoolean

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setFontFamily(fontFamily)

テキストのフォント ファミリーを設定します。

パラメータ

名前型説明
fontFamilyString

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • 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（「normal」）です。

パラメータ

名前型説明
fontFamilyString
fontWeightInteger

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setFontSize(fontSize)

テキストのフォントサイズをポイント単位で設定します。

パラメータ

名前型説明
fontSizeNumber

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setForegroundColor(foregroundColor)

テキストの前景色を設定します。

パラメータ

名前型説明
foregroundColorColor

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setForegroundColor(red, green, blue)

テキストの前景色を、0 ～ 255 の指定された RGB 値に設定します。

パラメータ

名前型説明
redInteger
greenInteger
blueInteger

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setForegroundColor(hexColor)

テキストの前景色を指定された 16 進数の色文字列に設定します。

16 進数文字列は「#RRGGBB」の形式にする必要があります。たとえば、ピンクは「#FFC0CB」と表されます。

パラメータ

名前型説明
hexColorString

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setForegroundColor(color)

テキストの前景色を指定された ThemeColorType に設定します。

パラメータ

名前型説明
colorThemeColorType

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setItalic(italic)

テキストを斜体にするかどうかを設定します。

パラメータ

名前型説明
italicBoolean

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setLinkSlide(slideIndex)

スライドのゼロベースのインデックスを使用して、指定された 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);

パラメータ

名前型説明
slideIndexIntegerスライドのゼロから始まるインデックス。

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setLinkSlide(slide)

指定された Slide に Link を設定します。リンクは指定されたスライド 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);

パラメータ

名前型説明
slideSlideリンクする Slide。

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • 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);

パラメータ

名前型説明
slidePositionSlidePosition相対的な SlidePosition。

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • 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');

パラメータ

名前型説明
urlStringURL 文字列。

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setSmallCaps(smallCaps)

テキストをスモール キャップでレンダリングするかどうかを設定します。

パラメータ

名前型説明
smallCapsBoolean

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setStrikethrough(strikethrough)

テキストに取り消し線が引かれているかどうかを設定します。

パラメータ

名前型説明
strikethroughBoolean

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setUnderline(underline)

テキストに下線を引くかどうかを設定します。

パラメータ

名前型説明
underlineBoolean

戻る

TextStyle

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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