このページは Cloud Translation API によって翻訳されました。

Class TableCell

表のセルを表す要素。TableCell は常に TableRow 内に含まれ、ListItem 要素、Paragraph 要素、Table 要素を含めることができます。対象ドキュメント構造について詳しくは、Google ドキュメントの拡張ガイドをご覧ください。

メソッド

メソッド	戻り値の型	概要
`appendHorizontalRule()`	`HorizontalRule`	新しい `HorizontalRule` を作成して追加します。
`appendImage(image)`	`InlineImage`	指定された画像 blob から新しい `InlineImage` を作成して追加します。
`appendImage(image)`	`InlineImage`	指定された `InlineImage` を追加します。
`appendListItem(listItem)`	`ListItem`	指定された `ListItem` を追加します。
`appendListItem(text)`	`ListItem`	新しい `ListItem` を作成して追加します。
`appendParagraph(paragraph)`	`Paragraph`	指定された `Paragraph` を追加します。
`appendParagraph(text)`	`Paragraph`	新しい `Paragraph` を作成して追加します。
`appendTable()`	`Table`	新しい `Table` を作成して追加します。
`appendTable(cells)`	`Table`	指定されたセルを含む新しい `Table` を追加します。
`appendTable(table)`	`Table`	指定された `Table` を追加します。
`clear()`	`TableCell`	要素の内容をクリアします。
`copy()`	`TableCell`	現在の要素の分離されたディープコピーを返します。
`editAsText()`	`Text`	編集用に、現在の要素の `Text` バージョンを取得します。
`findElement(elementType)`	`RangeElement`	要素のコンテンツで、指定された型の子孫を検索します。
`findElement(elementType, from)`	`RangeElement`	要素のコンテンツで、指定された型の子孫を（`RangeElement` が指定されている）。
`findText(searchPattern)`	`RangeElement`	正規表現を使用して、指定されたテキストパターンの要素のコンテンツを検索します。
`findText(searchPattern, from)`	`RangeElement`	要素の内容の中から、指定したテキストパターンから始まるものを検索します。表示されます。
`getAttributes()`	`Object`	要素の属性を取得します。
`getBackgroundColor()`	`String`	背景色を取得します。
`getChild(childIndex)`	`Element`	指定された子インデックスの子要素を取得します。
`getChildIndex(child)`	`Integer`	指定された子要素の子インデックスを取得します。
`getColSpan()`	`Integer`	列スパン（このセルがまたがっているテーブルセルの列数）を取得します。
`getLinkUrl()`	`String`	リンクの URL を取得します。
`getNextSibling()`	`Element`	要素の次の兄弟要素を取得します。
`getNumChildren()`	`Integer`	子の数を取得します。
`getPaddingBottom()`	`Number`	下部のパディングをポイント単位で取得します。
`getPaddingLeft()`	`Number`	左側のパディングをポイント単位で取得します。
`getPaddingRight()`	`Number`	右側のパディングをポイント単位で取得します。
`getPaddingTop()`	`Number`	上部のパディングをポイント単位で取得します。
`getParent()`	`ContainerElement`	要素の親要素を取得します。
`getParentRow()`	`TableRow`	現在の `TableCell` を含む `TableRow` を取得します。
`getParentTable()`	`Table`	現在の `TableCell` を含む `Table` を取得します。
`getPreviousSibling()`	`Element`	要素の前の兄弟要素を取得します。
`getRowSpan()`	`Integer`	行スパン（このセルがカバーするテーブルセルの行数）を取得します。
`getText()`	`String`	要素のコンテンツをテキスト文字列として取得します。
`getTextAlignment()`	`TextAlignment`	テキストの配置を取得します。
`getType()`	`ElementType`	要素の `ElementType` を取得します。
`getVerticalAlignment()`	`VerticalAlignment`	`VerticalAlignment` を取得します。
`getWidth()`	`Number`	セルを含む列の幅をポイント単位で取得します。
`insertHorizontalRule(childIndex)`	`HorizontalRule`	新しい `HorizontalRule` を作成して指定されたインデックスに挿入します。
`insertImage(childIndex, image)`	`InlineImage`	指定された画像 blob から `InlineImage` を作成して、指定された場所に挿入します。あります。
`insertImage(childIndex, image)`	`InlineImage`	指定された `InlineImage` を指定されたインデックスに挿入します。
`insertListItem(childIndex, listItem)`	`ListItem`	指定された `ListItem` を指定されたインデックスに挿入します。
`insertListItem(childIndex, text)`	`ListItem`	新しい `ListItem` を作成して指定されたインデックスに挿入します。
`insertParagraph(childIndex, paragraph)`	`Paragraph`	指定された `Paragraph` を指定されたインデックスに挿入します。
`insertParagraph(childIndex, text)`	`Paragraph`	新しい `Paragraph` を作成して指定されたインデックスに挿入します。
`insertTable(childIndex)`	`Table`	新しい `Table` を作成して指定されたインデックスに挿入します。
`insertTable(childIndex, cells)`	`Table`	指定されたセルを含む新しい `Table` を作成して、指定されたインデックスに挿入します。
`insertTable(childIndex, table)`	`Table`	指定された `Table` を指定されたインデックスに挿入します。
`isAtDocumentEnd()`	`Boolean`	要素が `Document` の最後にあるかどうかを決定します。
`merge()`	`TableCell`	要素を、先行する同じ型の兄弟要素と結合します。
`removeChild(child)`	`TableCell`	指定した子要素を削除します。
`removeFromParent()`	`TableCell`	要素を親から削除します。
`replaceText(searchPattern, replacement)`	`Element`	通常の文字列を使用して、指定したテキストパターンをすべて、指定した置換文字列に置き換えます。表します。
`setAttributes(attributes)`	`TableCell`	要素の属性を設定します。
`setBackgroundColor(color)`	`TableCell`	背景色を設定します。
`setLinkUrl(url)`	`TableCell`	リンク URL を設定します。
`setPaddingBottom(paddingBottom)`	`TableCell`	下部のパディングをポイント単位で設定します。
`setPaddingLeft(paddingLeft)`	`TableCell`	左パディングをポイント単位で設定します。
`setPaddingRight(paddingRight)`	`TableCell`	右パディングをポイント単位で設定します。
`setPaddingTop(paddingTop)`	`TableCell`	上部のパディングをポイント単位で設定します。
`setText(text)`	`TableCell`	コンテンツを書式なしテキストとして設定します。
`setTextAlignment(textAlignment)`	`TableCell`	テキストの配置を設定します。
`setVerticalAlignment(alignment)`	`TableCell`	垂直方向の配置を設定します。
`setWidth(width)`	`TableCell`	現在のセルを含む列の幅をポイント単位で設定します。

詳細なドキュメント

`appendHorizontalRule()`

新しい HorizontalRule を作成して追加します。

HorizontalRule は新しい Paragraph に含まれます。

戻る

HorizontalRule - 新しい横方向のルール

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendImage(image)`

指定された画像 blob から新しい InlineImage を作成して追加します。

InlineImage は新しい Paragraph に含まれます。

パラメータ

名前	型	説明
`image`	`BlobSource`	画像データ

戻る

InlineImage - 新しいイメージ

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendImage(image)`

指定された InlineImage を追加します。

InlineImage は新しい Paragraph に含まれます。

パラメータ

名前	型	説明
`image`	`InlineImage`	画像データ

戻る

InlineImage - 追加された画像

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendListItem(listItem)`

指定された ListItem を追加します。

パラメータ

名前	型	説明
`listItem`	`ListItem`	追加するリストアイテム

戻る

ListItem - 追加のリストアイテム

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendListItem(text)`

新しい ListItem を作成して追加します。

パラメータ

名前	型	説明
`text`	`String`	テキストコンテンツ

戻る

ListItem - 新しいリストアイテム

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendParagraph(paragraph)`

指定された Paragraph を追加します。

パラメータ

名前	型	説明
`paragraph`	`Paragraph`	追加する段落

戻る

Paragraph - 追加の段落

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendParagraph(text)`

新しい Paragraph を作成して追加します。

パラメータ

名前	型	説明
`text`	`String`	テキストコンテンツ

戻る

Paragraph - 新しい段落

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendTable()`

新しい Table を作成して追加します。

戻る

Table - 新しいテーブル

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendTable(cells)`

指定されたセルを含む新しい Table を追加します。

パラメータ

名前	型	説明
`cells`	`String[][]`	新しい表に追加する表のセルのテキストコンテンツ

戻る

Table - 追加されたテーブル

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`appendTable(table)`

指定された Table を追加します。

パラメータ

名前	型	説明
`table`	`Table`	追加するテーブル

戻る

Table - 追加されたテーブル

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`clear()`

要素の内容をクリアします。

戻る

TableCell - 現在の要素。

`copy()`

現在の要素の分離されたディープコピーを返します。

その要素に含まれている子要素もすべてコピーされます。新しい要素にはできます。

戻る

TableCell - 新しいコピー。

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`editAsText()`

編集用に、現在の要素の Text バージョンを取得します。

editAsText を使用して、要素のコンテンツをリッチテキストとして操作します。editAsText モードでは、テキスト以外の要素（InlineImage や HorizontalRule など）は無視されます。

削除されたテキスト範囲に完全に含まれている子要素は要素から削除されます。

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Insert two paragraphs separated by a paragraph containing an
// horizontal rule.
body.insertParagraph(0, "An editAsText sample.");
body.insertHorizontalRule(0);
body.insertParagraph(0, "An example.");

// Delete " sample.\n\n An" removing the horizontal rule in the process.
body.editAsText().deleteText(14, 25);

戻る

Text - 現在の要素のテキストバージョン

`findElement(elementType)`

要素のコンテンツで、指定された型の子孫を検索します。

パラメータ

名前	型	説明
`elementType`	`ElementType`	検索する要素のタイプ。

戻る

RangeElement - 検索要素の位置を示す検索結果。

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`findElement(elementType, from)`

要素のコンテンツで、指定された型の子孫を（RangeElement が指定されている）。

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Define the search parameters.
var searchType = DocumentApp.ElementType.PARAGRAPH;
var searchHeading = DocumentApp.ParagraphHeading.HEADING1;
var searchResult = null;

// Search until the paragraph is found.
while (searchResult = body.findElement(searchType, searchResult)) {
  var par = searchResult.getElement().asParagraph();
  if (par.getHeading() == searchHeading) {
    // Found one, update and stop.
    par.setText('This is the first header.');
    return;
  }
}

パラメータ

名前	型	説明
`elementType`	`ElementType`	検索する要素のタイプ。
`from`	`RangeElement`	検索元の検索結果。

戻る

RangeElement - 検索要素の次の位置を示す検索結果。

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`findText(searchPattern)`

正規表現を使用して、指定されたテキストパターンの要素のコンテンツを検索します。

以下の JavaScript 正規表現機能の一部は、完全にはサポートされていません。キャプチャグループとモード修飾子を使用します。

指定した正規表現のパターンが、テキストブロックごとに個別に照合される返されます。

パラメータ

名前	型	説明
`searchPattern`	`String`	検索するパターン

戻る

RangeElement - 検索テキストの位置を示す検索結果。テキストがない場合は null マッチ

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`findText(searchPattern, from)`

要素の内容の中から、指定したテキストパターンから始まるものを検索します。表示されます。

以下の JavaScript 正規表現機能の一部は、完全にはサポートされていません。キャプチャグループとモード修飾子を使用します。

指定した正規表現のパターンが、テキストブロックごとに個別に照合される返されます。

パラメータ

名前	型	説明
`searchPattern`	`String`	検索するパターン
`from`	`RangeElement`	検索元の検索結果

戻る

RangeElement - 検索テキストの次の位置を示す検索結果。それ以外の場合は null マッチ

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getAttributes()`

要素の属性を取得します。

その結果は、各有効な要素属性のプロパティを含むオブジェクトとなり、プロパティ名は、DocumentApp.Attribute 列挙型の項目に対応しています。

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Append a styled paragraph.
var par = body.appendParagraph('A bold, italicized paragraph.');
par.setBold(true);
par.setItalic(true);

// Retrieve the paragraph's attributes.
var atts = par.getAttributes();

// Log the paragraph attributes.
for (var att in atts) {
  Logger.log(att + ":" + atts[att]);
}

戻る

Object - 要素の属性。

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getBackgroundColor()`

背景色を取得します。

戻る

String - CSS 表記（'#ffffff' など）形式の背景色

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getChild(childIndex)`

指定された子インデックスの子要素を取得します。

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Obtain the first element in the tab.
var firstChild = body.getChild(0);

// If it's a paragraph, set its contents.
if (firstChild.getType() == DocumentApp.ElementType.PARAGRAPH) {
  firstChild.asParagraph().setText("This is the first paragraph.");
}

パラメータ

名前	型	説明
`childIndex`	`Integer`	取得する子要素のインデックス。

戻る

Element - 指定されたインデックスの子要素。

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getChildIndex(child)`

指定された子要素の子インデックスを取得します。

パラメータ

名前	型	説明
`child`	`Element`	インデックスを取得する子要素。

戻る

Integer - 子インデックス。

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getColSpan()`

列スパン（このセルがまたがっているテーブルセルの列数）を取得します。結合されていないセルの列スパンは 1 です。

戻る

Integer - 列スパン、または別のセルと結合されたセルの場合は 0

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getLinkUrl()`

リンクの URL を取得します。

戻る

String - リンク URL、または要素にこの属性に複数の値が含まれている場合は null

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getNextSibling()`

要素の次の兄弟要素を取得します。

次の兄弟要素は同じ親を持ち、現在の要素に従います。

戻る

Element - 次の兄弟要素。

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getNumChildren()`

子の数を取得します。

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Log the number of elements in the tab.
Logger.log("There are " + body.getNumChildren() +
    " elements in the tab's body.");

戻る

Integer - 子の数。

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getPaddingBottom()`

下部のパディングをポイント単位で取得します。

戻る

Number - 下部のパディング（ポイント単位）

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getPaddingLeft()`

左側のパディングをポイント単位で取得します。

戻る

Number - 左側のパディング（ポイント単位）

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getPaddingRight()`

右側のパディングをポイント単位で取得します。

戻る

Number - 右パディング（ポイント単位）

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getPaddingTop()`

上部のパディングをポイント単位で取得します。

戻る

Number - 上部のパディング（ポイント単位）

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getParent()`

要素の親要素を取得します。

親要素には現在の要素が含まれます。

戻る

ContainerElement - 親要素。

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getParentRow()`

現在の TableCell を含む TableRow を取得します。

戻る

TableRow - 現在のセルを含む表の行

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getParentTable()`

現在の TableCell を含む Table を取得します。

戻る

Table - 現在のセルを含むテーブル

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getPreviousSibling()`

要素の前の兄弟要素を取得します。

前の兄弟要素は、同じ親を持ち、現在の要素の前に配置されます。

戻る

Element - 前の兄弟要素。

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getRowSpan()`

行スパン（このセルがカバーするテーブルセルの行数）を取得します。結合なしセルの行スパンは 1 です。

戻る

Integer - 行スパン、または別のセルと結合されたセルの場合は 0

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getText()`

要素のコンテンツをテキスト文字列として取得します。

戻る

String - テキスト文字列としての要素の内容

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getTextAlignment()`

テキストの配置を取得します。使用できるアライメントのタイプは、DocumentApp.TextAlignment.NORMAL、DocumentApp.TextAlignment.SUBSCRIPT、DocumentApp.TextAlignment.SUPERSCRIPT です。

戻る

TextAlignment - テキストの配置のタイプ。テキストに複数の種類のテキストが含まれている場合は null またはテキストの配置が設定されていない場合は、

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getType()`

要素の ElementType を取得します。

getType() を使用して、指定された要素の正確な型を特定します。

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Obtain the first element in the active tab's body.

var firstChild = body.getChild(0);

// Use getType() to determine the element's type.
if (firstChild.getType() == DocumentApp.ElementType.PARAGRAPH) {
  Logger.log('The first element is a paragraph.');
} else {
  Logger.log('The first element is not a paragraph.');
}

戻る

ElementType - 要素のタイプ。

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getVerticalAlignment()`

VerticalAlignment を取得します。

戻る

VerticalAlignment - 垂直方向の配置

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getWidth()`

セルを含む列の幅をポイント単位で取得します。

戻る

Number - 列の幅（ポイント単位）

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertHorizontalRule(childIndex)`

新しい HorizontalRule を作成して指定されたインデックスに挿入します。

水平ルールは新しい Paragraph に含まれます。

パラメータ

名前	型	説明
`childIndex`	`Integer`	要素を挿入するインデックス

戻る

HorizontalRule - 新しい横方向のルール

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertImage(childIndex, image)`

指定された画像 blob から InlineImage を作成して、指定された場所に挿入します。あります。

この画像は新しい Paragraph に含まれます。

パラメータ

名前	型	説明
`childIndex`	`Integer`	要素を挿入するインデックス
`image`	`BlobSource`	画像データ

戻る

InlineImage - 挿入されるインライン画像

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertImage(childIndex, image)`

指定された InlineImage を指定されたインデックスに挿入します。

この画像は新しい Paragraph に含まれます。

パラメータ

名前	型	説明
`childIndex`	`Integer`	要素を挿入するインデックス
`image`	`InlineImage`	挿入する画像

戻る

InlineImage - 挿入されるインライン画像

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertListItem(childIndex, listItem)`

指定された ListItem を指定されたインデックスに挿入します。

パラメータ

名前	型	説明
`childIndex`	`Integer`	要素を挿入するインデックス
`listItem`	`ListItem`	挿入するリストアイテム

戻る

ListItem - 新しいリストアイテムを挿入しました

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertListItem(childIndex, text)`

新しい ListItem を作成して指定されたインデックスに挿入します。

パラメータ

名前	型	説明
`childIndex`	`Integer`	要素を挿入するインデックス
`text`	`String`	テキストコンテンツ

戻る

ListItem - 新しいリストアイテム

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertParagraph(childIndex, paragraph)`

指定された Paragraph を指定されたインデックスに挿入します。

パラメータ

名前	型	説明
`childIndex`	`Integer`	要素を挿入するインデックス
`paragraph`	`Paragraph`	挿入する段落

戻る

Paragraph - 挿入された段落

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertParagraph(childIndex, text)`

新しい Paragraph を作成して指定されたインデックスに挿入します。

パラメータ

名前	型	説明
`childIndex`	`Integer`	要素を挿入するインデックス
`text`	`String`	テキストコンテンツ

戻る

Paragraph - 新しい段落

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertTable(childIndex)`

新しい Table を作成して指定されたインデックスに挿入します。

パラメータ

名前	型	説明
`childIndex`	`Integer`	要素を挿入するインデックス

戻る

Table - 新しいテーブル

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertTable(childIndex, cells)`

指定されたセルを含む新しい Table を作成して、指定されたインデックスに挿入します。

パラメータ

名前	型	説明
`childIndex`	`Integer`	挿入するインデックス
`cells`	`String[][]`	新しい表に追加する表のセルのテキストコンテンツ

戻る

Table - 新しいテーブル

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertTable(childIndex, table)`

指定された Table を指定されたインデックスに挿入します。

パラメータ

名前	型	説明
`childIndex`	`Integer`	要素を挿入するインデックス
`table`	`Table`	挿入するテーブル

戻る

Table - 挿入されたテーブル

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`isAtDocumentEnd()`

要素が Document の最後にあるかどうかを決定します。

戻る

Boolean - 要素がタブの最後にあるかどうか。

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`merge()`

要素を、先行する同じ型の兄弟要素と結合します。

結合できるのは同じ ElementType の要素のみです。Deployment に含まれる子要素は、現在の要素は前の兄弟要素に移動されます。

現在の要素がドキュメントから削除されます。

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Example 1: Merge paragraphs
// Append two paragraphs to the document's active tab.
var par1 = body.appendParagraph('Paragraph 1.');
var par2 = body.appendParagraph('Paragraph 2.');
// Merge the newly added paragraphs into a single paragraph.
par2.merge();

// Example 2: Merge table cells
// Create a two-dimensional array containing the table's cell contents.
var cells = [
['Row 1, Cell 1', 'Row 1, Cell 2'],
['Row 2, Cell 1', 'Row 2, Cell 2']
];
// Build a table from the array.
var table = body.appendTable(cells);
// Get the first row in the table.
 var row = table.getRow(0);
// Get the two cells in this row.
var cell1 = row.getCell(0);
var cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
var merged = cell2.merge();

戻る

TableCell - マージされた要素。

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`removeChild(child)`

指定した子要素を削除します。

パラメータ

名前	型	説明
`child`	`Element`	削除する子要素です。

戻る

TableCell - 現在の要素

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`removeFromParent()`

要素を親から削除します。

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab()
var body = documentTab.getBody();

// Remove all images in the active tab's body.
var imgs = body.getImages();
for (var i = 0; i < imgs.length; i++) {
  imgs[i].removeFromParent();
}

戻る

TableCell - 削除された要素。

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`replaceText(searchPattern, replacement)`

通常の文字列を使用して、指定したテキストパターンをすべて、指定した置換文字列に置き換えます。表します。

検索パターンは、JavaScript 正規表現オブジェクトではなく、文字列として渡されます。そのため、パターン内でバックスラッシュをエスケープする必要があります。

このメソッドは、Google の RE2 標準版を使用します。式ライブラリを使用して、サポートされている構文を制限します。

指定した正規表現のパターンが、テキストブロックごとに個別に照合される返されます。

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Clear the text surrounding "Apps Script", with or without text.
body.replaceText("^.*Apps ?Script.*$", "Apps Script");

パラメータ

名前	型	説明
`searchPattern`	`String`	検索する正規表現パターン
`replacement`	`String`	置換として使用するテキスト

戻る

Element - 現在の要素

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setAttributes(attributes)`

要素の属性を設定します。

指定する属性パラメータは、各プロパティ名がアイテムのアイテムである DocumentApp.Attribute 列挙値。各プロパティ値は新しい値になります。適用されました。

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Define a custom paragraph style.
var style = {};
style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] =
    DocumentApp.HorizontalAlignment.RIGHT;
style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri';
style[DocumentApp.Attribute.FONT_SIZE] = 18;
style[DocumentApp.Attribute.BOLD] = true;

// Append a plain paragraph.
var par = body.appendParagraph('A paragraph with custom style.');

// Apply the custom style.
par.setAttributes(style);

パラメータ

名前	型	説明
`attributes`	`Object`	要素の属性。

戻る

TableCell - 現在の要素。

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setBackgroundColor(color)`

背景色を設定します。

パラメータ

名前	型	説明
`color`	`String`	CSS 表記の背景色（`'#ffffff'` など）

戻る

TableCell - 現在の要素

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setLinkUrl(url)`

リンク URL を設定します。

パラメータ

名前	型	説明
`url`	`String`	リンクの URL

戻る

TableCell - 現在の要素

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setPaddingBottom(paddingBottom)`

下部のパディングをポイント単位で設定します。

パラメータ

名前	型	説明
`paddingBottom`	`Number`	下部のパディング（ポイント単位）

戻る

TableCell - 現在の要素

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setPaddingLeft(paddingLeft)`

左パディングをポイント単位で設定します。

パラメータ

名前	型	説明
`paddingLeft`	`Number`	左パディング（ポイント単位）

戻る

TableCell - 現在の要素

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setPaddingRight(paddingRight)`

右パディングをポイント単位で設定します。

パラメータ

名前	型	説明
`paddingRight`	`Number`	右パディング（ポイント単位）。

戻る

TableCell - 現在の要素。

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setPaddingTop(paddingTop)`

上部のパディングをポイント単位で設定します。

パラメータ

名前	型	説明
`paddingTop`	`Number`	上部のパディング（ポイント単位）

戻る

TableCell - 現在の要素

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setText(text)`

コンテンツを書式なしテキストとして設定します。

注: 既存の内容は消去されます。

パラメータ

名前	型	説明
`text`	`String`	新しいテキストコンテンツを

戻る

TableCell - 現在の要素

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setTextAlignment(textAlignment)`

テキストの配置を設定します。使用できるアライメントのタイプは、DocumentApp.TextAlignment.NORMAL、DocumentApp.TextAlignment.SUBSCRIPT、DocumentApp.TextAlignment.SUPERSCRIPT です。

// Make the entire first paragraph in the active tab be superscript.
var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
var text = documentTab.getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);

パラメータ

名前	型	説明
`textAlignment`	`TextAlignment`	適用するテキスト配置のタイプ

戻る

TableCell - 現在の要素

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setVerticalAlignment(alignment)`

垂直方向の配置を設定します。

パラメータ

名前	型	説明
`alignment`	`VerticalAlignment`	垂直方向の配置

戻る

TableCell - 現在の要素

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setWidth(width)`

現在のセルを含む列の幅をポイント単位で設定します。

パラメータ

名前	型	説明
`width`	`Number`	列の幅（ポイント単位）

戻る

TableCell - 現在の要素

承認

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents