テキストのスタイル。
対応する TextRange
が複数のテキスト実行にまたがっており、それらの実行が呼び出される読み取りメソッドに異なる値を持つ場合、このクラスの読み取りメソッドは null
を返します。これを回避するには、TextRange.getRuns()
メソッドから返された TextRange
を使用してテキスト スタイルをクエリします。
シェイプ内のテキストの配置を編集する方法を使用すると、テキスト スタイルに適用されている自動調整設定はすべて無効になります。
Methods
メソッド | 戻り値の型 | 概要 |
---|---|---|
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 | テキストの背景色を 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 | テキストのフォアグラウンドの色を、指定された RGB 値(0 ~ 255)に設定します。 |
setForegroundColor(hexColor) | TextStyle | テキストの前景の色を、指定された 16 進数色文字列に設定します。 |
setForegroundColor(color) | TextStyle | テキストのフォアグラウンドの色を、指定した ThemeColorType に設定します。 |
setItalic(italic) | TextStyle | テキストが斜体にするかどうかを設定します。 |
setLinkSlide(slideIndex) | TextStyle | スライドのゼロから始まるインデックスを使用して、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()
getBaselineOffset()
テキストの通常の位置からの垂直オフセットを返します。テキストに複数のスタイルがある場合は null
を返します。
リターン
承認
この方法を使用するスクリプトには、次の 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(「標準」)です。
リターン
Integer
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getForegroundColor()
getLink()
テキストの Link
を返します。リンクがない場合、リンクがテキストの一部か複数のリンクがある場合は null
を返します。hasLink()
を呼び出して、テキストにリンクがないかどうかを確認します。
var textLink = shape.getText().getTextStyle().getLink(); if (textLink != null) { Logger.log('Shape text has a link of type: ' + textLink.getLinkType()); }
リターン
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
hasLink()
テキストにリンクがある場合は 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
removeLink()
setBackgroundColor(color)
setBackgroundColor(red, green, blue)
setBackgroundColor(hexColor)
setBackgroundColor(color)
テキストの背景色を指定された ThemeColorType
に設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
color | ThemeColorType |
リターン
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setBackgroundColorTransparent()
setBaselineOffset(offset)
通常の位置に対するテキストの垂直オフセットを設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
offset | TextBaselineOffset |
リターン
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setBold(bold)
setFontFamily(fontFamily)
setFontFamilyAndWeight(fontFamily, fontWeight)
テキストのフォント ファミリーと太さを設定します。
重みは、100 以上 900 以下の 100 の倍数です。この範囲は CSS 2.1 仕様のセクション 15.6 に記載されている数値に対応していますが、数値以外の値は使用できません。700 以上の重みは太字とみなされ、isBold()
は true
を返します。デフォルト値は 400(「標準」)です。
パラメータ
名前 | 型 | 説明 |
---|---|---|
fontFamily | String | |
fontWeight | Integer |
リターン
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setFontSize(fontSize)
setForegroundColor(foregroundColor)
setForegroundColor(red, green, blue)
setForegroundColor(hexColor)
setForegroundColor(color)
テキストのフォアグラウンドの色を、指定した ThemeColorType
に設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
color | ThemeColorType |
リターン
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setItalic(italic)
setLinkSlide(slideIndex)
スライドのゼロから始まるインデックスを使用して、指定された Slide
に Link
を設定します。
リンクを設定すると、下線が引かれるテキストのスタイルと、前景の色が ThemeColorType.HYPERLINK
に変わります。これは setForegroundColor(hexColor)
と setUnderline(underline)
で変更できます。
改行文字にはリンクを設定できないため、TextRange
内の改行文字は無視されます。
// Set a link to the first slide of the presentation. text.getTextStyle().setLinkSlide(0);
パラメータ
名前 | 型 | 説明 |
---|---|---|
slideIndex | Integer | スライドのゼロから始まるインデックス。 |
リターン
承認
この方法を使用するスクリプトには、次の 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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
slide | Slide | リンクする Slide 。 |
リターン
承認
この方法を使用するスクリプトには、次の 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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
slidePosition | SlidePosition | 相対 SlidePosition 。 |
リターン
承認
この方法を使用するスクリプトには、次の 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");
パラメータ
名前 | 型 | 説明 |
---|---|---|
url | String | URL 文字列。 |
リターン
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations