テキストのスタイル。
このクラスの読み取りメソッドは、対応する Text が複数のテキスト実行にまたがり、それらの実行で呼び出される読み取りメソッドの値が異なる場合、null を返します。これを回避するには、Text メソッドから返された Text を使用してテキスト スタイルをクエリします。
テキストが図形内に収まるように編集する方法を使用すると、テキスト スタイルに適用されている自動調整の設定は無効になります。
メソッド
| メソッド | 戻り値の型 | 概要 |
|---|---|---|
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 | テキストに下線を引くかどうかを設定します。 |
詳細なドキュメント
get Background Color()
get Baseline Offset()
テキストの通常の位置からの垂直方向のオフセットを返します。テキストに複数のスタイルがある場合は null を返します。
戻る
Text - テキストの垂直方向のオフセット。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
get Font Family()
テキストのフォント ファミリーを返します。テキストに複数のスタイルがある場合は null を返します。
戻る
String|null - テキストのフォント ファミリー。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
get Font Size()
テキストのフォントサイズをポイント単位で返します。テキストに複数のスタイルがある場合は null を返します。
戻る
Number|null - テキストのフォントサイズ(ポイント)。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
get Font Weight()
テキストのフォントの太さを返します。テキストに複数のスタイルがある場合は null を返します。
重みは、100 以上 900 以下の 100 の倍数です。この範囲は、CSS 2.1 仕様のセクション 15.6 で説明されている数値に対応しており、数値以外の値は許可されません。重みが 700 以上の場合は太字と見なされ、is は true を返します。デフォルト値は 400(「normal」)です。
戻る
Integer|null - テキストのフォントの太さ。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
get Foreground Color()
get Link()
テキストの Link を返します。リンクがない場合、リンクがテキストの一部にある場合、または複数のリンクがある場合は、null を返します。has を呼び出して、テキストにリンクがないかどうかを判断します。
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
has Link()
テキストにリンクがある場合は true、ない場合は false、テキストの一部にリンクがある場合や複数のリンクがある場合は null を返します。
改行文字にリンクを設定することはできません。したがって、Text に改行文字が含まれている場合、このメソッドは常に null または false を返します。
戻る
Boolean|null - テキストにリンクがあるかどうか。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
is Background Transparent()
テキストの背景が透明な場合は true、透明でない場合は false、テキストに複数のスタイルがある場合は null を返します。
戻る
Boolean|null - テキストの背景が透明かどうか。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
is Bold()
テキストが太字でレンダリングされる場合は true、そうでない場合は false、テキストに複数のスタイルがある場合は null を返します。
戻る
Boolean|null - テキストが太字でレンダリングされるかどうか。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
is Italic()
テキストが斜体の場合 true、そうでない場合 false、テキストに複数のスタイルがある場合 null を返します。
戻る
Boolean|null - テキストが斜体かどうか。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
is Small Caps()
テキストがスモール キャップの場合は true、そうでない場合は false、テキストに複数のスタイルがある場合は null を返します。
戻る
Boolean|null - テキストがスモール キャップかどうか。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
is Strikethrough()
テキストに取り消し線が引かれている場合は true、引かれていない場合は false、テキストに複数のスタイルが適用されている場合は null を返します。
戻る
Boolean|null - テキストに取り消し線が引かれているかどうか。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
is Underline()
テキストに下線が引かれている場合は true、引かれていない場合は false、テキストに複数のスタイルが適用されている場合は null を返します。
戻る
Boolean|null - テキストに下線が引かれているかどうか。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
remove Link()
set Background Color(color)
set Background Color(red, green, blue)
set Background Color(hexColor)
set Background Color(color)
テキストの背景色を指定された Theme に設定します。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
color | Theme | テーマのカラータイプ。 |
戻る
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
set Background Color Transparent()
set Baseline Offset(offset)
テキストの垂直方向のオフセットを通常の位置に対して設定します。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
offset | Text | 設定するベースライン オフセット。 |
戻る
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
set Bold(bold)
set Font Family(fontFamily)
set Font Family And Weight(fontFamily, fontWeight)
set Font Size(fontSize)
set Foreground Color(foregroundColor)
set Foreground Color(red, green, blue)
set Foreground Color(hexColor)
set Foreground Color(color)
テキストの前景色を指定された Theme に設定します。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
color | Theme | テーマのカラータイプ。 |
戻る
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
set Italic(italic)
set Link Slide(slideIndex)
スライドのゼロベースのインデックスを使用して、指定された Slide に Link を設定します。
リンクを設定すると、テキストのスタイルが下線付きになり、前景色が Theme に変わります。これは set と set を介して変更できます。
リンクは改行文字に設定できないため、Text の改行文字は無視されます。
// 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
set Link Slide(slide)
指定された Slide に Link を設定します。リンクは指定されたスライド ID によって設定されます。
リンクを設定すると、テキストのスタイルが下線付きになり、前景色が Theme に変わります。これは set と set を介して変更できます。
リンクは改行文字に設定できないため、Text の改行文字は無視されます。
// 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
set Link Slide(slidePosition)
スライドの相対位置を使用して、指定された Slide に Link を設定します。
リンクを設定すると、テキストのスタイルが下線付きになり、前景色が Theme に変わります。これは set と set を介して変更できます。
リンクは改行文字に設定できないため、Text の改行文字は無視されます。
// 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
set Link Url(url)
Link を指定された空でない URL 文字列に設定します。
リンクを設定すると、テキストのスタイルが下線付きになり、前景色が Theme に変わります。これは set と set を介して変更できます。
リンクは改行文字に設定できないため、Text の改行文字は無視されます。
// 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