テキストのスタイル。
このクラスの読み取りメソッドは、対応する TextRange が複数のテキスト実行にまたがり、それらの実行で呼び出される読み取りメソッドの値が異なる場合、null を返します。これを回避するには、TextRange.getRuns() メソッドから返された TextRange を使用してテキスト スタイルをクエリします。
テキストが図形内に収まるように編集する方法を使用すると、テキスト スタイルに適用されている自動調整の設定は無効になります。
メソッド
| メソッド | 戻り値の型 | 概要 |
|---|---|---|
get | Color|null | テキストの背景色を返します。テキストに複数のスタイルがある場合は null を返します。 |
get | Text | テキストの垂直方向のオフセットを返します。テキストに複数のスタイルがある場合は null を返します。 |
get | String|null | テキストのフォント ファミリーを返します。テキストに複数のスタイルがある場合は null を返します。 |
get | Number|null | テキストのフォントサイズをポイント単位で返します。テキストに複数のスタイルがある場合は null を返します。 |
get | Integer|null | テキストのフォントの太さを返します。テキストに複数のスタイルがある場合は null を返します。 |
get | Color|null | テキストの前景色を返します。テキストに複数のスタイルがある場合は null を返します。 |
get | Link|null | テキストの Link を返します。リンクがない場合、リンクがテキストの一部にある場合、またはマルチリンクがある場合は、null を返します。 |
has | Boolean|null | テキストにリンクがある場合は true、ない場合は false、テキストの一部にリンクがある場合や複数のリンクがある場合は null を返します。 |
is | Boolean|null | テキストの背景が透明な場合は true、透明でない場合は false、テキストに複数のスタイルがある場合は null を返します。 |
is | Boolean|null | テキストが太字でレンダリングされる場合は true、そうでない場合は false、テキストに複数のスタイルがある場合は null を返します。 |
is | Boolean|null | テキストが斜体の場合 true、そうでない場合 false、テキストに複数のスタイルがある場合 null を返します。 |
is | Boolean|null | テキストがスモール キャップの場合は true、そうでない場合は false、テキストに複数のスタイルがある場合は null を返します。 |
is | Boolean|null | テキストに取り消し線が引かれている場合は true、引かれていない場合は false、テキストに複数のスタイルが適用されている場合は null を返します。 |
is | Boolean|null | テキストに下線が引かれている場合は true、引かれていない場合は false、テキストに複数のスタイルが適用されている場合は null を返します。 |
remove | Text | Link を削除します。 |
set | Text | テキストの背景色を設定します。 |
set | Text | テキストの背景色を、0 ~ 255 の指定された RGB 値に設定します。 |
set | Text | テキストの背景色を指定された 16 進数の色文字列に設定します。 |
set | Text | テキストの背景色を指定された Theme に設定します。 |
set | Text | テキストの背景色を透明に設定します。 |
set | Text | テキストの垂直方向のオフセットを通常の位置を基準に設定します。 |
set | Text | テキストを太字でレンダリングするかどうかを設定します。 |
set | Text | テキストのフォント ファミリーを設定します。 |
set | Text | テキストのフォント ファミリーとウェイトを設定します。 |
set | Text | テキストのフォントサイズをポイント単位で設定します。 |
set | Text | テキストの前景色を設定します。 |
set | Text | テキストの前景色を、0 ~ 255 の指定された RGB 値に設定します。 |
set | Text | テキストの前景色を指定された 16 進数色コード文字列に設定します。 |
set | Text | テキストの前景色を指定された Theme に設定します。 |
set | Text | テキストを斜体にするかどうかを設定します。 |
set | Text | スライドのゼロベースのインデックスを使用して、指定された Slide に Link を設定します。 |
set | Text | 指定された Slide に Link を設定します。リンクは指定されたスライド ID によって設定されます。 |
set | Text | スライドの相対位置を使用して、指定された Slide に Link を設定します。 |
set | Text | Link を指定された空でない URL 文字列に設定します。 |
set | Text | テキストをスモール キャップでレンダリングするかどうかを設定します。 |
set | Text | テキストに取り消し線を付けるかどうかを設定します。 |
set | Text | テキストに下線を引くかどうかを設定します。 |
詳細なドキュメント
getBackgroundColor()
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()
getLink()
テキストの 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
hasLink()
テキストにリンクがある場合は 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
removeLink()
setBackgroundColor(color)
setBackgroundColor(red, green, blue)
テキストの背景色を、0 ~ 255 の指定された RGB 値に設定します。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
red | Integer | 色の赤のコンポーネント。 |
green | Integer | 色の緑のコンポーネント。 |
blue | Integer | 色の青要素。 |
戻る
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
setBackgroundColor(hexColor)
setBackgroundColor(color)
テキストの背景色を指定された ThemeColorType に設定します。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
color | Theme | テーマのカラータイプ。 |
戻る
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
setBackgroundColorTransparent()
setBaselineOffset(offset)
テキストの垂直方向のオフセットを通常の位置を基準に設定します。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
offset | Text | 設定するベースライン オフセット。 |
戻る
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
setBold(bold)
setFontFamily(fontFamily)
setFontFamilyAndWeight(fontFamily, fontWeight)
setFontSize(fontSize)
setForegroundColor(foregroundColor)
setForegroundColor(red, green, blue)
テキストの前景色を、0 ~ 255 の指定された RGB 値に設定します。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
red | Integer | 色の赤のコンポーネント。 |
green | Integer | 色の緑のコンポーネント。 |
blue | Integer | 色の青要素。 |
戻る
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
setForegroundColor(hexColor)
setForegroundColor(color)
テキストの前景色を指定された ThemeColorType に設定します。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
color | Theme | テーマのカラータイプ。 |
戻る
承認
このメソッドを使用するスクリプトには、次の 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. const presentation = SlidesApp.getActivePresentation(); const slide = presentation.getSlides()[0]; const textRange = slide.getShapes()[0].getText(); textRange.getTextStyle().setLinkSlide(0);
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
slide | Integer | スライドのゼロから始まるインデックス。 |
戻る
承認
このメソッドを使用するスクリプトには、次の 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);
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
slide | Slide | リンクする Slide。 |
戻る
承認
このメソッドを使用するスクリプトには、次の 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);
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
slide | Slide | 相対的な Slide。 |
戻る
承認
このメソッドを使用するスクリプトには、次の 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');
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
url | String | URL 文字列。 |
戻る
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations