Class TextStyle

TextStyle

テキストのスタイル。

このクラスの read メソッドは、対応する TextRange スパンがある場合に null を返します。 複数のテキストが実行され、それらの実行によって呼び出される read メソッドの値は異なります。宛先 これを回避するには、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)TextStyleLink を指定された Slide に設定します。リンクは指定されたスライド ID で設定されます。
setLinkSlide(slidePosition)TextStyleスライドの相対位置を使用して、Link を指定された Slide に設定します。
setLinkUrl(url)TextStyleLink を指定された空でない URL 文字列に設定します。
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 ～ 900 の 100 の倍数です。この範囲は 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() を呼び出して、 テキストにはリンクがありません。 

var 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 を削除します。

リンクを削除すると、テキストからハイパーリンクの前景色と下線のスタイルが削除されます。条件 これらのスタイルは、リンクの前のテキストに合わせて適用されます。 

text.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)

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

リンクを設定すると、テキストのスタイルが下線付きで、ThemeColorType.HYPERLINK の前景色に変更されます。これは setForegroundColor(hexColor) と setUnderline(underline) で変更できます。

改行文字にはリンクを設定できないため、TextRange 内の改行文字は は無視されます。 

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

パラメータ

名前型説明
slideIndexIntegerスライドに対するゼロベースのインデックス。

戻る

TextStyle

承認

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

  • 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

承認

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

  • 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

承認

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