Class TextRange

TextRange

Shape または TableCell のテキスト コンテンツのセグメント。

テキストがシェイプ内にどのように収まるかを編集する方法を使用する場合、 シェイプは無効になります。

メソッド

メソッド戻り値の型概要
appendParagraph(text)Paragraphテキスト範囲の末尾に段落を追加します。
appendRange(textRange)TextRange指定したテキスト範囲のコピーを現在のテキスト範囲の末尾に追加します。
appendRange(textRange, matchSourceFormatting)TextRange指定したテキスト範囲のコピーを現在のテキスト範囲の末尾に追加します。
appendText(text)TextRangeテキスト範囲の末尾にテキストを追加します。
asRenderedString()String関連するシェイプまたはテーブルのセルの範囲がこの範囲で囲まれたレンダリング テキストを返します。 適切な形式を指定します。
asString()String関連するシェイプまたは表のセルの範囲で囲まれた未加工テキストを返します。
clear()voidこの範囲で囲まれたテキストをクリアします。
clear(startOffset, endOffset)void範囲内の開始オフセットと終了オフセットで囲まれたテキストをクリアします。
find(pattern)TextRange[]現在のテキスト範囲で検索パターンに一致するすべての範囲を返します。
find(pattern, startOffset)TextRange[]現在のテキスト範囲に含まれる検索パターンに一致するすべての範囲を返します。 開始オフセット。
getAutoTexts()AutoText[]現在のテキスト範囲内の自動テキストを返します。
getEndIndex()Integerこの範囲の最後の文字の排他的 0 ベースのインデックスを返します。
getLength()Integerこの範囲の文字数を返します。
getLinks()TextRange[]現在のすべての Link に対応するテキスト範囲のコレクションを返します。 現在のテキスト範囲と重なっています。
getListParagraphs()Paragraph[]現在のテキスト範囲と重複するリスト内の段落を返します。
getListStyle()ListStyle現在のテキスト範囲の ListStyle を返します。
getParagraphStyle()ParagraphStyle現在のテキスト範囲の ParagraphStyle を返します。
getParagraphs()Paragraph[]現在のテキスト範囲と重なる段落を返します。
getRange(startOffset, endOffset)TextRange派生元の範囲の一部をカバーする新しい TextRange を返します。
getRuns()TextRange[]現在のテキスト範囲と重複するテキスト実行を返します。
getStartIndex()Integerこの範囲の最初の文字の包括的な 0 ベースのインデックスを返します。
getTextStyle()TextStyle範囲のテキスト スタイルを返します。範囲が空の場合は null を返します。
insertParagraph(startOffset, text)Paragraph開始オフセットに段落を挿入します。
insertRange(startOffset, textRange)TextRange指定されたテキスト範囲のコピーを開始オフセットに挿入します。
insertRange(startOffset, textRange, matchSourceFormatting)TextRange指定されたテキスト範囲のコピーを開始オフセットに挿入します。
insertText(startOffset, text)TextRange開始オフセットにテキストを挿入します。
isEmpty()Booleanこの範囲に文字がない場合は true を返し、false を返します できません。
replaceAllText(findText, replaceText)Integer検索テキストに一致するすべてのテキストを置換テキストに置き換えます。
replaceAllText(findText, replaceText, matchCase)Integer検索テキストに一致するすべてのテキストを置換テキストに置き換えます。
select()voidアクティブなプレゼンテーションの TextRange のみを選択し、前のプレゼンテーションを削除します 選択します。
setText(newText)TextRange関連するシェイプまたは表のセルのこの範囲で囲まれたテキストを設定します。

詳細なドキュメント

appendParagraph(text)

テキスト範囲の末尾に段落を追加します。この段落でスタイルが維持され、 現在のテキスト範囲の終わり。

指定したテキスト文字列を段落として追加するには、前後に 1 つ以上追加します。 改行文字を文字列に追加します。

提供されたテキスト文字列に改行文字（つまり、 最後の段落が返されます。

パラメータ

名前型説明
textString段落として連結する文字列。

戻る

Paragraph - 追加された Paragraph。

承認

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

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

appendRange(textRange)

指定したテキスト範囲のコピーを現在のテキスト範囲の末尾に追加します。

挿入するテキストの書式は、元のテキストの書式と一致します。

パラメータ

名前型説明
textRangeTextRange追加するテキスト範囲。

戻る

TextRange - 追加されたテキストを表すテキスト範囲

承認

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

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

appendRange(textRange, matchSourceFormatting)

指定したテキスト範囲のコピーを現在のテキスト範囲の末尾に追加します。

移動先テキストのフォーマットと一致するように設定されている場合、AutoText レンダリングされた値に置き換えられます。また、テキスト以外の要素も 指定したテキスト範囲は追加されません。

パラメータ

名前型説明
textRangeTextRange追加するテキスト範囲。
matchSourceFormattingBooleantrue の場合は、原文テキストの形式と一致させます。 false は、移動先のテキストの書式と一致させます。

戻る

TextRange - 追加されたテキストを表すテキスト範囲

承認

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

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

appendText(text)

テキスト範囲の末尾にテキストを追加します。テキストは、スペースの端のスタイルを維持します。 テキストを入力します。

パラメータ

名前型説明
textString追加する文字列。

戻る

TextRange - 追加されたテキストを表すテキスト範囲。

承認

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

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

asRenderedString()

関連するシェイプまたはテーブルのセルの範囲がこの範囲で囲まれたレンダリング テキストを返します。 適切な形式を指定します。

生成されたスライド番号などの AutoText 要素は、レンダリングされた値で置き換えられます。 範囲内のテキスト以外の要素は省略されます。

戻る

String

承認

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

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

asString()

関連するシェイプまたは表のセルの範囲で囲まれた未加工テキストを返します。

生成されたスライド番号や範囲内のテキスト以外の要素などの定型テキスト要素は、 Unicode 文字 U+E907 に置き換えられます。

戻る

String

承認

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

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

clear()

この範囲で囲まれたテキストをクリアします。

Shape または TableCell のテキスト全体は改行で終わっているため、 削除されません。

承認

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

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

clear(startOffset, endOffset)

範囲内の開始オフセットと終了オフセットで囲まれたテキストをクリアします。

テキストは改行で終わる必要があるため、テキスト内の最後の改行は、改行があっても削除されません。 オフセットされます

パラメータ

名前型説明
startOffsetInteger現在使用されているテキスト範囲の開始インデックス以降の文字数 は、クリアする範囲の包括的な開始インデックスを決定します。開始オフセットは 0 以上 endOffset 以下。startOffset また、現在の範囲の長さよりも短くする必要があります。
endOffsetInteger現在使用されているテキスト範囲の開始インデックス以降の文字数 クリアする範囲の排他的終了インデックスを決定します。endOffset は startOffset 以上。endOffset は、次の値以下でなければなりません 現在の範囲と同じになります。

承認

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

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

find(pattern)

現在のテキスト範囲で検索パターンに一致するすべての範囲を返します。検索は 大文字と小文字を区別します。

パラメータ

名前型説明
patternString検索する正規表現パターン。パターンにバックスラッシュを エスケープされます。

戻る

TextRange[]

承認

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

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

find(pattern, startOffset)

現在のテキスト範囲に含まれる検索パターンに一致するすべての範囲を返します。 開始オフセット。検索では大文字と小文字が区別されます。

パラメータ

名前型説明
patternString検索する正規表現パターン。パターンにバックスラッシュを エスケープされます。
startOffsetInteger現在使用されているテキスト範囲の開始インデックス以降の文字数 検索する範囲の包括的な開始インデックスを決定します。startOffset の必須事項 最小であることがわかります。

戻る

TextRange[]

承認

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

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

getAutoTexts()

現在のテキスト範囲内の自動テキストを返します。

戻る

AutoText[]

承認

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

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

getEndIndex()

この範囲の最後の文字の排他的 0 ベースのインデックスを返します。開始時刻と終了時刻が インデックスが等しい場合、範囲は空とみなされます。

戻る

Integer

承認

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

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

getLength()

この範囲の文字数を返します。

戻る

Integer

承認

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

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

現在のすべての Link に対応するテキスト範囲のコレクションを返します。 現在のテキスト範囲と重なっています。

返される各範囲は、作成時に 1 つのリンクにまたがることが保証されます。テキストの変更 リンクが 1 つだけではなくなる可能性があります。

返された範囲の各 Link には、TextStyle.getLink() を介してアクセスできます。 

// Accesses the first link on a TextRange object.
var linkTextRange = textRange.getLinks()[0];
var textStyle = linkTextRange.getTextStyle();
Logger.log(textStyle.hasLink()); // logs 'true'
var link = textStyle.getLink();  // Link object

戻る

TextRange[]

承認

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

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

getListParagraphs()

現在のテキスト範囲と重複するリスト内の段落を返します。

戻る

Paragraph[]

承認

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

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

getListStyle()

現在のテキスト範囲の ListStyle を返します。

戻る

ListStyle

承認

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

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

getParagraphStyle()

現在のテキスト範囲の ParagraphStyle を返します。

戻る

ParagraphStyle

承認

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

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

getParagraphs()

現在のテキスト範囲と重なる段落を返します。

戻る

Paragraph[]

承認

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

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

getRange(startOffset, endOffset)

派生元の範囲の一部をカバーする新しい TextRange を返します。

パラメータ

名前型説明
startOffsetInteger現在使用されているテキスト範囲の開始インデックス以降の文字数 返される範囲の包括的な開始インデックスを決定します。開始オフセットは 0 以上 endOffset 以下。startOffset また、現在の範囲の長さよりも短くする必要があります。
endOffsetInteger現在使用されているテキスト範囲の開始インデックス以降の文字数 返される範囲の排他的な終了インデックスを決定します。endOffset は startOffset 以上。endOffset は、次の値以下でなければなりません 現在の範囲と同じになります。

戻る

TextRange

承認

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

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

getRuns()

現在のテキスト範囲と重複するテキスト実行を返します。テキストランはテキストのセグメントであり すべての文字の文字スタイルを統一します。

返される各範囲は、作成時に 1 つの実行にまたがってのみ保証されます。テキストまたはスタイル 実行が 1 回だけではなくなる可能性があります。

戻る

TextRange[]

承認

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

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

getStartIndex()

この範囲の最初の文字の包括的な 0 ベースのインデックスを返します。起動と 終了インデックスが等しい場合、範囲は空とみなされます。

戻る

Integer

承認

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

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

getTextStyle()

範囲のテキスト スタイルを返します。範囲が空の場合は null を返します。

戻る

TextStyle

承認

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

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

insertParagraph(startOffset, text)

開始オフセットに段落を挿入します。この段落では現在の テキスト範囲を指定します。

指定したテキスト文字列を、前後に少なくとも 1 つ追加して段落として挿入します。 改行文字を文字列に追加します。

提供されたテキスト文字列に改行文字（つまり、 最後の段落が返されます。

パラメータ

名前型説明
startOffsetInteger現在使用されているテキスト範囲の開始インデックス以降の文字数 挿入するテキストの包括的な開始インデックスを決定します。
textString挿入する文字列。

戻る

Paragraph - 挿入された Paragraph。

承認

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

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

insertRange(startOffset, textRange)

指定されたテキスト範囲のコピーを開始オフセットに挿入します。

挿入するテキストの書式は、元のテキストの書式と一致します。

パラメータ

名前型説明
startOffsetInteger現在使用されているテキスト範囲の開始インデックス以降の文字数 挿入するテキストの包括的な開始インデックスを決定します。
textRangeTextRange挿入するテキスト範囲。

戻る

TextRange - 挿入されたテキストを表すテキスト範囲

承認

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

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

insertRange(startOffset, textRange, matchSourceFormatting)

指定されたテキスト範囲のコピーを開始オフセットに挿入します。

移動先テキストのフォーマットと一致するように設定されている場合、AutoText レンダリングされた値に置き換えられます。また、テキスト以外の要素も 挿入されません。

パラメータ

名前型説明
startOffsetInteger現在使用されているテキスト範囲の開始インデックス以降の文字数 挿入するテキストの包括的な開始インデックスを決定します。
textRangeTextRange挿入するテキスト範囲。
matchSourceFormattingBooleantrue の場合は、原文テキストの形式と一致させます。 false は、移動先のテキストの書式と一致させます。

戻る

TextRange - 挿入されたテキストを表すテキスト範囲

承認

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

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

insertText(startOffset, text)

開始オフセットにテキストを挿入します。テキスト領域の既存のテキストのスタイルは維持され、 開始オフセット。

パラメータ

名前型説明
startOffsetInteger現在使用されているテキスト範囲の開始インデックス以降の文字数 挿入するテキストの包括的な開始インデックスを決定します。
textString挿入する文字列。

戻る

TextRange - 挿入されたテキストを表すテキスト範囲。

承認

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

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

isEmpty()

この範囲に文字がない場合は true を返し、false を返します できません。

戻る

Boolean

承認

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

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

replaceAllText(findText, replaceText)

検索テキストに一致するすべてのテキストを置換テキストに置き換えます。大文字と小文字を区別する 無神経です

パラメータ

名前型説明
findTextString検索するテキスト。
replaceTextString一致したテキストを置き換えるテキスト。

戻る

Integer - 変更された回数

承認

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

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

replaceAllText(findText, replaceText, matchCase)

検索テキストに一致するすべてのテキストを置換テキストに置き換えます。

パラメータ

名前型説明
findTextString検索するテキスト。
replaceTextString一致したテキストを置き換えるテキスト。
matchCaseBooleantrue の場合、検索では大文字と小文字が区別されます。false の場合、検索は 大文字と小文字は区別されません。

戻る

Integer - 変更された回数

承認

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

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

select()

アクティブなプレゼンテーションの TextRange のみを選択し、前のプレゼンテーションを削除します 選択します。

スクリプトがアクセスできるのは、スクリプトを実行しているユーザーが選択した場合のみです。 スクリプトはプレゼンテーションにバインドされます。

対応する Shape の親 Page または TableCell が設定されている current page selection として指定します。Shape または TableCell が selected page element として設定される。

    Selection には次の 2 種類があります。 <ph type="x-smartling-placeholder">
      </ph>
    • 1. テキストの範囲。空でない TextRange で選択を使用して、 あります。
    • 2. カーソル位置。空の TextRange を使用して、目的のインデックスにカーソルを配置します。 
      var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.getText().setText("Hello");
// Range selection: Select the text range "He".
shape.getText().getRange(0, 2).select();
// Cursor selection: Place the cursor after "H" like "H|ello".
shape.getText().getRange(1, 1).select();

      承認

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

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

    setText(newText)

    関連するシェイプまたは表のセルのこの範囲で囲まれたテキストを設定します。テキストは、 既存のテキストの開始位置のスタイル。

    パラメータ

    名前型説明
    newTextString新しいテキストとして設定する文字列。

    戻る

    TextRange - 設定されたテキストを表すテキスト範囲

    承認

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

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