本頁面由 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\|null`	搜尋元素內容，找出指定型別的後代。
`findElement(elementType, from)`	`RangeElement\|null`	從指定 `RangeElement` 開始，在元素內容中搜尋指定型別的後代。
`findText(searchPattern)`	`RangeElement\|null`	使用規則運算式在元素內容中搜尋指定的文字模式。
`findText(searchPattern, from)`	`RangeElement\|null`	從指定的搜尋結果開始，在元素內容中搜尋特定文字模式。
`getAttributes()`	`Object`	擷取元素的屬性。
`getBackgroundColor()`	`String\|null`	擷取背景顏色。
`getChild(childIndex)`	`Element`	擷取指定子項索引處的子項元素。
`getChildIndex(child)`	`Integer`	擷取指定子項元素的子項索引。
`getColSpan()`	`Integer`	擷取欄跨度，也就是這個儲存格跨越的表格儲存格欄數。
`getLinkUrl()`	`String\|null`	擷取連結網址。
`getNextSibling()`	`Element\|null`	擷取元素的下一個同層級元素。
`getNumChildren()`	`Integer`	擷取子項數量。
`getPaddingBottom()`	`Number\|null`	以點為單位擷取底部邊框間距。
`getPaddingLeft()`	`Number\|null`	以點為單位擷取左側邊框間距。
`getPaddingRight()`	`Number\|null`	以點為單位擷取右側邊框間距。
`getPaddingTop()`	`Number\|null`	以點為單位擷取頂端邊框間距。
`getParent()`	`ContainerElement\|null`	擷取元素的父項元素。
`getParentRow()`	`TableRow\|null`	擷取包含目前 `TableCell` 的 `TableRow`。
`getParentTable()`	`Table\|null`	擷取包含目前 `TableCell` 的 `Table`。
`getPreviousSibling()`	`Element\|null`	擷取元素的前一個同層級元素。
`getRowSpan()`	`Integer`	擷取列跨度，也就是這個儲存格跨越的表格儲存格列數。
`getText()`	`String`	以文字字串形式擷取元素內容。
`getTextAlignment()`	`TextAlignment\|null`	取得文字對齊方式。
`getType()`	`ElementType`	擷取元素的 `ElementType`。
`getVerticalAlignment()`	`VerticalAlignment\|null`	擷取 `VerticalAlignment`。
`getWidth()`	`Number\|null`	以點為單位，擷取含有儲存格的資料欄寬度。
`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\|null`	將元素與相同類型的前一個同層級元素合併。
`removeChild(child)`	`TableCell`	移除指定的子項元素。
`removeFromParent()`	`TableCell\|null`	從父項移除元素。
`replaceText(searchPattern, replacement)`	`Element`	使用規則運算式，將指定文字模式的所有例項替換為指定替代字串。
`setAttributes(attributes)`	`TableCell`	設定元素的屬性。
`setBackgroundColor(color)`	`TableCell`	設定背景顏色。
`setLinkUrl(url)`	`TableCell`	設定連結網址。
`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：新的水平線

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`appendImage(image)`

從指定的圖片 Blob 建立並附加新的 InlineImage。

InlineImage 會包含在新的 Paragraph 中。

參數

名稱	類型	說明
`image`	`BlobSource`	圖片資料

回攻員

InlineImage - 新圖片

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`appendImage(image)`

附加指定的 InlineImage。

InlineImage 會包含在新的 Paragraph 中。

參數

名稱	類型	說明
`image`	`InlineImage`	圖片資料

回攻員

InlineImage：附加的圖片

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`appendListItem(listItem)`

附加指定的 ListItem。

參數

名稱	類型	說明
`listItem`	`ListItem`	要附加的清單項目

回攻員

ListItem：附加的清單項目

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`appendListItem(text)`

建立並附加新的 ListItem。

參數

名稱	類型	說明
`text`	`String`	文字內容

回攻員

ListItem：新的清單項目

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`appendParagraph(paragraph)`

附加指定的 Paragraph。

參數

名稱	類型	說明
`paragraph`	`Paragraph`	要附加的段落

回攻員

Paragraph - 附加的段落

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`appendParagraph(text)`

建立並附加新的 Paragraph。

參數

名稱	類型	說明
`text`	`String`	文字內容

回攻員

Paragraph：新段落

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`appendTable()`

建立並附加新的 Table。

回攻員

Table：新資料表

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`appendTable(cells)`

附加包含指定儲存格的新 Table。

參數

名稱	類型	說明
`cells`	`String[][]`	要新增至新表格的表格儲存格文字內容

回攻員

Table：附加的資料表

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`appendTable(table)`

附加指定的 Table。

參數

名稱	類型	說明
`table`	`Table`	要附加的資料表

回攻員

Table：附加的資料表

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`clear()`

清除元素內容。

回攻員

TableCell：目前的元素。

`copy()`

傳回目前元素的深層副本，且該副本已分離。

元素中的任何子項元素也會一併複製。新元素沒有父項。

回攻員

TableCell：新副本。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`editAsText()`

取得目前元素的 Text 版本，以供編輯。

使用 editAsText 將元素內容當做 RTF 文字來操控。editAsText 模式會忽略非文字元素 (例如 InlineImage 和 HorizontalRule)。

如果子項元素完全包含在已刪除的文字範圍內，系統會從元素中移除這些子項元素。

const 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|null：搜尋結果，指出搜尋元素的所在位置。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`findElement(elementType, from)`

從指定的 RangeElement 開始，在元素內容中搜尋指定型別的後代。

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

// Define the search parameters.

let searchResult = null;

// Search until the paragraph is found.
while (
    (searchResult = body.findElement(
         DocumentApp.ElementType.PARAGRAPH,
         searchResult,
         ))) {
  const par = searchResult.getElement().asParagraph();
  if (par.getHeading() === DocumentApp.ParagraphHeading.HEADING1) {
    // Found one, update and stop.
    par.setText('This is the first header.');
    break;
  }
}

參數

名稱	類型	說明
`elementType`	`ElementType`	要搜尋的元素類型。
`from`	`RangeElement`	要從中搜尋的搜尋結果。

回攻員

RangeElement|null：搜尋結果，指出搜尋元素的下一個位置。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`findText(searchPattern)`

使用規則運算式在元素內容中搜尋指定的文字模式。

系統不完全支援部分 JavaScript 規則運算式功能，例如擷取群組和模式修飾符。

系統會針對目前元素中包含的每個文字區塊，分別比對所提供的規則運算式模式。

參數

名稱	類型	說明
`searchPattern`	`String`	要搜尋的模式

回攻員

RangeElement|null：搜尋結果，指出搜尋文字的位置；如果沒有相符項目，則為空值

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`findText(searchPattern, from)`

從指定的搜尋結果開始，在元素內容中搜尋特定文字模式。

系統不完全支援部分 JavaScript 規則運算式功能，例如擷取群組和模式修飾符。

系統會針對目前元素中包含的每個文字區塊，分別比對所提供的規則運算式模式。

參數

名稱	類型	說明
`searchPattern`	`String`	要搜尋的模式
`from`	`RangeElement`	要從哪個搜尋結果開始搜尋

回攻員

RangeElement|null：搜尋結果，指出搜尋文字的下一個位置；如果沒有相符項目，則為空值

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getAttributes()`

擷取元素的屬性。

結果會是物件，其中包含每個有效元素屬性的屬性，且每個屬性名稱都對應至 DocumentApp.Attribute 列舉中的項目。

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

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

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

// Log the paragraph attributes.
for (const att in atts) {
  Logger.log(`${att}:${atts[att]}`);
}

回攻員

Object：元素的屬性。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getBackgroundColor()`

擷取背景顏色。

回攻員

String|null：背景顏色，格式為 CSS 標記 (例如 '#ffffff')

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getChild(childIndex)`

擷取指定子項索引處的子項元素。

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

// Obtain the first element in the tab.
const 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：指定索引的子項元素。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getChildIndex(child)`

擷取指定子項元素的子項索引。

參數

名稱	類型	說明
`child`	`Element`	要擷取索引的子項元素。

回攻員

Integer - 子項索引。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getColSpan()`

擷取欄跨度，也就是這個儲存格跨越的資料表儲存格欄數。未合併的儲存格的 col span 為 1。

回攻員

Integer：資料欄跨度，或 0 (如果儲存格是由另一個儲存格合併而來)

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getLinkUrl()`

擷取連結網址。

回攻員

String|null - 連結網址，如果元素包含這項屬性的多個值，則為空值

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getNextSibling()`

擷取元素的下一個同層級元素。

下一個同層級元素與目前元素具有相同的父項，且位於目前元素之後。

回攻員

Element|null：下一個同層級元素。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getNumChildren()`

擷取子項數量。

const 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：子項數量。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getPaddingBottom()`

以點為單位擷取底部邊框間距。

回攻員

Number|null：以點為單位的底部邊框間距

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getPaddingLeft()`

以點為單位擷取左側邊框間距。

回攻員

Number|null：左側邊框間距 (以點為單位)

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getPaddingRight()`

以點為單位擷取右側邊框間距。

回攻員

Number|null：右側邊框間距 (以點為單位)

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getPaddingTop()`

以點為單位擷取頂端邊框間距。

回攻員

Number|null：頂端邊框間距 (以點為單位)

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getParent()`

擷取元素的父項元素。

父項元素包含目前的元素。

回攻員

ContainerElement|null：父項元素。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getParentRow()`

擷取包含目前 TableCell 的 TableRow。

回攻員

TableRow|null：包含目前儲存格的表格列

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getParentTable()`

擷取包含目前 TableCell 的 Table。

回攻員

Table|null：包含目前儲存格的表格

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getPreviousSibling()`

擷取元素的前一個同層級元素。

前一個同層級元素與目前元素具有相同的父項，且位於目前元素之前。

回攻員

Element|null：上一個同層級元素。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getRowSpan()`

擷取列跨度，也就是這個儲存格跨越的表格儲存格列數。未合併的儲存格的列跨度為 1。

回攻員

Integer：資料列範圍，或儲存格的 0 (如果該儲存格是由另一個儲存格合併而來)

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getText()`

以文字字串形式擷取元素內容。

回攻員

String：元素內容 (文字字串)

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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：文字對齊類型，或 null (如果文字包含多種文字對齊類型，或從未設定文字對齊方式)

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getType()`

擷取元素的 ElementType。

使用 getType() 判斷指定元素的確切類型。

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

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

const 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：元素類型。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getVerticalAlignment()`

擷取 VerticalAlignment。

回攻員

VerticalAlignment|null - 垂直對齊

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`getWidth()`

以點為單位，擷取含有儲存格的資料欄寬度。

回攻員

Number|null：欄寬 (以點為單位)

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`insertHorizontalRule(childIndex)`

在指定索引建立並插入新的 HorizontalRule。

水平規則會包含在新的 Paragraph 中。

參數

名稱	類型	說明
`childIndex`	`Integer`	要插入元素的索引

回攻員

HorizontalRule：新的水平線

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`insertImage(childIndex, image)`

在指定索引處，從指定圖片 Blob 建立並插入 InlineImage。

圖片會包含在新的 Paragraph 中。

參數

名稱	類型	說明
`childIndex`	`Integer`	要插入元素的索引
`image`	`BlobSource`	圖片資料

回攻員

InlineImage：插入的內嵌圖片

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`insertImage(childIndex, image)`

在指定索引處插入指定 InlineImage。

圖片會包含在新的 Paragraph 中。

參數

名稱	類型	說明
`childIndex`	`Integer`	要插入元素的索引
`image`	`InlineImage`	要插入的圖片

回攻員

InlineImage：插入的內嵌圖片

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`insertListItem(childIndex, listItem)`

在指定索引處插入指定 ListItem。

參數

名稱	類型	說明
`childIndex`	`Integer`	要插入元素的索引
`listItem`	`ListItem`	要插入的清單項目

回攻員

ListItem：插入新的清單項目

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`insertListItem(childIndex, text)`

在指定索引處建立並插入新的 ListItem。

參數

名稱	類型	說明
`childIndex`	`Integer`	要插入元素的索引
`text`	`String`	文字內容

回攻員

ListItem：新的清單項目

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`insertParagraph(childIndex, paragraph)`

在指定索引處插入指定 Paragraph。

參數

名稱	類型	說明
`childIndex`	`Integer`	要插入元素的索引
`paragraph`	`Paragraph`	要插入的段落

回攻員

Paragraph：插入的段落

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`insertParagraph(childIndex, text)`

在指定索引處建立並插入新的 Paragraph。

參數

名稱	類型	說明
`childIndex`	`Integer`	要插入元素的索引
`text`	`String`	文字內容

回攻員

Paragraph：新段落

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`insertTable(childIndex)`

在指定索引處建立並插入新的 Table。

參數

名稱	類型	說明
`childIndex`	`Integer`	要插入元素的索引

回攻員

Table：新資料表

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`insertTable(childIndex, cells)`

建立並插入新的 Table，其中包含指定索引處的指定儲存格。

參數

名稱	類型	說明
`childIndex`	`Integer`	要插入的索引
`cells`	`String[][]`	要新增至新表格的表格儲存格文字內容

回攻員

Table：新資料表

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`insertTable(childIndex, table)`

在指定索引處插入指定 Table。

參數

名稱	類型	說明
`childIndex`	`Integer`	要插入元素的索引
`table`	`Table`	要插入的表格

回攻員

Table：插入的表格

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`isAtDocumentEnd()`

判斷元素是否位於 Document 的結尾。

回攻員

Boolean：元素是否位於分頁的結尾。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`merge()`

將元素與相同類型的前一個同層級元素合併。

只有相同 ElementType 的元素才能合併。目前元素中包含的所有子項元素都會移至前一個同層級元素。

目前元素會從文件中移除。

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

// Example 1: Merge paragraphs
// Append two paragraphs to the document's active tab.
const par1 = body.appendParagraph('Paragraph 1.');
const 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.
const cells = [
  ['Row 1, Cell 1', 'Row 1, Cell 2'],
  ['Row 2, Cell 1', 'Row 2, Cell 2'],
];
// Build a table from the array.
const table = body.appendTable(cells);
// Get the first row in the table.
const row = table.getRow(0);
// Get the two cells in this row.
const cell1 = row.getCell(0);
const cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
const merged = cell2.merge();

回攻員

TableCell|null：合併的元素。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`removeChild(child)`

移除指定的子項元素。

參數

名稱	類型	說明
`child`	`Element`	要移除的子元素

回攻員

TableCell：目前元素

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`removeFromParent()`

從父項移除元素。

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

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

回攻員

TableCell|null：已移除的元素。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`replaceText(searchPattern, replacement)`

使用規則運算式，將指定文字模式的所有例項替換為指定替代字串。

搜尋模式會以字串形式傳遞，而非 JavaScript 規則運算式物件。因此，您需要逸出模式中的任何反斜線。

這個方法使用 Google 的 RE2 規則運算式程式庫，因此支援的語法有限。

系統會針對目前元素中包含的每個文字區塊，獨立比對所提供的規則運算式模式。

const 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：目前元素

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`setAttributes(attributes)`

設定元素的屬性。

指定的屬性參數必須是物件，其中每個屬性名稱都是 DocumentApp.Attribute 列舉中的項目，每個屬性值都是要套用的新值。

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

// Define a custom paragraph style.
const 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.
const par = body.appendParagraph('A paragraph with custom style.');

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

參數

名稱	類型	說明
`attributes`	`Object`	元素的屬性。

回攻員

TableCell：目前的元素。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`setBackgroundColor(color)`

設定背景顏色。

參數

名稱	類型	說明
`color`	`String`	背景顏色，格式為 CSS 標記 (例如 `'#ffffff'`)

回攻員

TableCell：目前元素

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`setLinkUrl(url)`

設定連結網址。

參數

名稱	類型	說明
`url`	`String`	連結網址

回攻員

TableCell：目前元素

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`setPaddingBottom(paddingBottom)`

以點為單位設定底部邊框間距。

參數

名稱	類型	說明
`paddingBottom`	`Number`	底部邊框間距 (以點為單位)

回攻員

TableCell：目前元素

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`setPaddingLeft(paddingLeft)`

以點為單位設定左側邊框間距。

參數

名稱	類型	說明
`paddingLeft`	`Number`	左側邊框間距 (以點為單位)

回攻員

TableCell：目前元素

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`setPaddingRight(paddingRight)`

以點為單位設定右側邊框間距。

參數

名稱	類型	說明
`paddingRight`	`Number`	以點為單位的右側邊框間距。

回攻員

TableCell：目前的元素。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`setPaddingTop(paddingTop)`

設定上邊框間距 (以點為單位)。

參數

名稱	類型	說明
`paddingTop`	`Number`	頂端邊框間距 (以點為單位)

回攻員

TableCell：目前元素

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`setText(text)`

將內容設為純文字。

注意：現有內容會遭到清除。

參數

名稱	類型	說明
`text`	`String`	新文字內容

回攻員

TableCell：目前元素

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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.
const documentTab =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
const text = documentTab.getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);

參數

名稱	類型	說明
`textAlignment`	`TextAlignment`	要套用的文字對齊類型

回攻員

TableCell：目前元素

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`setVerticalAlignment(alignment)`

設定垂直對齊方式。

參數

名稱	類型	說明
`alignment`	`VerticalAlignment`	垂直對齊方式

回攻員

TableCell：目前元素

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

`setWidth(width)`

以點為單位，設定包含目前儲存格的資料欄寬度。

參數

名稱	類型	說明
`width`	`Number`	欄寬 (以點為單位)

回攻員

TableCell：目前元素

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

Class TableCell 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

方法

內容詳盡的說明文件

appendHorizontalRule()

回攻員

授權

appendImage(image)

參數

回攻員

授權

appendImage(image)

參數

回攻員

授權

appendListItem(listItem)

參數

回攻員

授權

appendListItem(text)

參數

回攻員

授權

appendParagraph(paragraph)

參數

回攻員

授權

appendParagraph(text)

參數

回攻員

授權

appendTable()

回攻員

授權

appendTable(cells)

參數

回攻員

授權

appendTable(table)

參數

回攻員

授權

clear()

回攻員

copy()

回攻員

授權

editAsText()

回攻員

findElement(elementType)

參數

回攻員

授權

findElement(elementType, from)

參數

回攻員

授權

findText(searchPattern)

參數

回攻員

授權

findText(searchPattern, from)

參數

回攻員

授權

getAttributes()

回攻員

授權

getBackgroundColor()

回攻員

授權

getChild(childIndex)

參數

回攻員

授權

getChildIndex(child)

參數

回攻員

授權

getColSpan()

回攻員

Class TableCell

`appendHorizontalRule()`

`appendImage(image)`

`appendImage(image)`

`appendListItem(listItem)`

`appendListItem(text)`

`appendParagraph(paragraph)`

`appendParagraph(text)`

`appendTable()`

`appendTable(cells)`

`appendTable(table)`

`clear()`

`copy()`

`editAsText()`

`findElement(elementType)`

`findElement(elementType, from)`

`findText(searchPattern)`

`findText(searchPattern, from)`

`getAttributes()`

`getBackgroundColor()`

`getChild(childIndex)`

`getChildIndex(child)`

`getColSpan()`

`getLinkUrl()`

`getNextSibling()`

`getNumChildren()`

`getPaddingBottom()`

`getPaddingLeft()`

`getPaddingRight()`

`getPaddingTop()`

`getParent()`

`getParentRow()`

`getParentTable()`

`getPreviousSibling()`

`getRowSpan()`

`getText()`

`getTextAlignment()`

`getType()`

`getVerticalAlignment()`

`getWidth()`

`insertHorizontalRule(childIndex)`

`insertImage(childIndex, image)`

`insertImage(childIndex, image)`

`insertListItem(childIndex, listItem)`

`insertListItem(childIndex, text)`