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()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スライドのゼロベースのインデックスを使用して、Link を指定された Slide に設定します。
setLinkSlide(slide)TextStyle指定された Slide に Link を設定します。リンクは指定されたスライド ID によって設定されます。
setLinkSlide(slidePosition)TextStyleスライドの相対位置を使用して、指定された Slide に Link を設定します。
setLinkUrl(url)TextStyle指定された空でない URL 文字列に Link を設定します。
setSmallCaps(smallCaps)TextStyleテキストを小文字でレンダリングするかどうかを設定します。
setStrikethrough(strikethrough)TextStyleテキストに取り消し線を引くかどうかを設定します。
setUnderline(underline)TextStyleテキストに下線を付けるかどうかを設定します。

詳細なドキュメント

getBackgroundColor()

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

戻る

Color

承認

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

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

getBaselineOffset()

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

戻る

TextBaselineOffset

承認

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

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

getFontFamily()

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

戻る

String

承認

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

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

getFontSize()

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

戻る

Number

承認

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

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

getFontWeight()

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

重みは 100 の倍数で、100 ～ 900 の範囲で指定します。この範囲は、CSS 2.1 仕様の セクション 15.6 で説明されている数値に対応しており、数値以外の値は使用できません。700 以上の重みは太字と見なされ、この場合 isBold() は true を返します。デフォルト値は 400（「normal」）です。

戻る

Integer

承認

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

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

getForegroundColor()

テキストのフォアグラウンド カラーを返します。テキストに複数のスタイルがある場合は null を返します。

戻る

Color

承認

このメソッドを使用するスクリプトには、次のスコープの 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

承認

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

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

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

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

戻る

Boolean

承認

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

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

isBackgroundTransparent()

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

戻る

Boolean

承認

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

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

isBold()

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

戻る

Boolean

承認

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

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

isItalic()

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

戻る

Boolean

承認

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

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

isSmallCaps()

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

戻る

Boolean

承認

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

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

isStrikethrough()

テキストが取り消し線付きの場合は true、そうでない場合は false、テキストに複数のスタイルがある場合は null を返します。

戻る

Boolean

承認

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

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

isUnderline()

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

戻る

Boolean

承認

このメソッドを使用するスクリプトには、次のスコープの 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 の倍数で、100 ～ 900 の範囲で指定します。この範囲は、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)

スライドのゼロベースのインデックスを使用して、Link を指定された Slide に設定します。

リンクを設定すると、テキストのスタイルが下線付きになり、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)

指定された空でない URL 文字列に Link を設定します。

リンクを設定すると、テキストのスタイルが下線付きになり、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