此页面由 Cloud Translation API 翻译。

Class TableRow

表示表格行的一个元素。TableRow 始终包含在 Table 中，并且只能包含 TableCell 元素。如需详细了解文档结构，请参阅扩展 Google 文档指南。

方法

方法	返回类型	简介
`appendTableCell()`	`TableCell`	创建并附加新的 `TableCell`。
`appendTableCell(textContents)`	`TableCell`	附加包含指定文本的给定 `TableCell`。
`appendTableCell(tableCell)`	`TableCell`	附加给定的 `TableCell`。
`clear()`	`TableRow`	清除元素的内容。
`copy()`	`TableRow`	返回当前元素的已分离深层副本。
`editAsText()`	`Text`	获取当前元素的 `Text` 版本以进行修改。
`findElement(elementType)`	`RangeElement\|null`	在元素的内容中搜索指定类型的后代。
`findElement(elementType, from)`	`RangeElement\|null`	从指定的 `RangeElement` 开始，在元素的内容中搜索指定类型的后代。
`findText(searchPattern)`	`RangeElement\|null`	使用正则表达式在元素的内容中搜索指定的文本模式。
`findText(searchPattern, from)`	`RangeElement\|null`	从给定的搜索结果开始，在元素的内容中搜索指定的文本模式。
`getAttributes()`	`Object`	检索元素的属性。
`getCell(cellIndex)`	`TableCell\|null`	检索指定单元格索引处的 `TableCell`。
`getChild(childIndex)`	`Element`	检索指定子索引处的子元素。
`getChildIndex(child)`	`Integer`	检索指定子元素的子级索引。
`getLinkUrl()`	`String\|null`	检索链接网址。
`getMinimumHeight()`	`Number\|null`	检索最小高度（以点为单位）。
`getNextSibling()`	`Element\|null`	检索元素的下一个同级元素。
`getNumCells()`	`Integer`	检索行中的单元格数量。
`getNumChildren()`	`Integer`	检索子项的数量。
`getParent()`	`ContainerElement\|null`	检索元素的父元素。
`getParentTable()`	`Table\|null`	检索包含当前行的 `Table`。
`getPreviousSibling()`	`Element\|null`	检索元素的前一个同级元素。
`getText()`	`String`	以文本字符串形式检索元素的内容。
`getTextAlignment()`	`TextAlignment\|null`	获取文本对齐方式。
`getType()`	`ElementType`	检索元素的 `ElementType`。
`insertTableCell(childIndex)`	`TableCell`	在指定索引处创建并插入新的 `TableCell`。
`insertTableCell(childIndex, textContents)`	`TableCell`	在指定索引处插入包含指定文本的指定 `TableCell`。
`insertTableCell(childIndex, tableCell)`	`TableCell`	在指定索引处插入给定的 `TableCell`。
`isAtDocumentEnd()`	`Boolean`	确定元素是否位于 `Document` 的末尾。
`merge()`	`TableRow\|null`	将元素与同一类型的前一个同级元素合并。
`removeCell(cellIndex)`	`TableCell`	移除指定单元格索引处的 `TableCell`。
`removeChild(child)`	`TableRow`	移除指定的子元素。
`removeFromParent()`	`TableRow\|null`	从其父级中移除元素。
`replaceText(searchPattern, replacement)`	`Element`	使用正则表达式将指定文本模式的所有匹配项替换为指定的替换字符串。
`setAttributes(attributes)`	`TableRow`	设置元素的属性。
`setLinkUrl(url)`	`TableRow`	设置链接网址。
`setMinimumHeight(minHeight)`	`TableRow`	设置最小高度（以点为单位）。
`setTextAlignment(textAlignment)`	`TableRow`	设置文本对齐方式。

详细文档

`appendTableCell()`

创建并附加新的 TableCell。

TableCell - 新的表格单元格

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`appendTableCell(textContents)`

附加包含指定文本的给定 TableCell。

参数

名称	类型	说明
`textContents`	`String`	单元格的文本内容

TableCell - 附加的表格单元格元素

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`appendTableCell(tableCell)`

附加给定的 TableCell。

参数

名称	类型	说明
`tableCell`	`TableCell`	要附加的表格单元格

TableCell - 附加的表格单元格

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`clear()`

清除元素的内容。

TableRow - 当前元素。

`copy()`

返回当前元素的已分离深层副本。

元素中包含的所有子元素也会被复制。新元素没有父元素。

TableRow - 新文案。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`editAsText()`

获取当前元素的 Text 版本以进行修改。

使用 editAsText 将元素内容作为富文本进行操作。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 - 指示搜索文本位置的搜索结果，如果没有匹配项，则为 null

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`findText(searchPattern, from)`

从给定的搜索结果开始，在元素的内容中搜索指定的文本模式。

部分 JavaScript 正则表达式功能不受完全支持，例如捕获组和模式修饰符。

系统会针对当前元素中包含的每个文本块独立匹配所提供的正则表达式模式。

参数

名称	类型	说明
`searchPattern`	`String`	要搜索的模式
`from`	`RangeElement`	要开始搜索的搜索结果

RangeElement|null - 指示搜索文本的下一个位置的搜索结果，如果没有匹配项，则为 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

`getCell(cellIndex)`

检索指定单元格索引处的 TableCell。

参数

名称	类型	说明
`cellIndex`	`Integer`	要检索的单元格的索引

TableCell|null - 表格单元格

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`getLinkUrl()`

检索链接网址。

String|null - 链接网址，如果元素包含此属性的多个值，则为 null

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`getMinimumHeight()`

检索最小高度（以点为单位）。

Number|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

`getNumCells()`

检索行中的单元格数量。

Integer - 单元格数量

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`getParent()`

检索元素的父元素。

父元素包含当前元素。

ContainerElement|null - 父元素。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`getParentTable()`

检索包含当前行的 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

`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

`insertTableCell(childIndex)`

在指定索引处创建并插入新的 TableCell。

参数

名称	类型	说明
`childIndex`	`Integer`	要插入元素的索引

TableCell - 新的表格单元格

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`insertTableCell(childIndex, textContents)`

在指定索引处插入包含指定文本的指定 TableCell。

参数

名称	类型	说明
`childIndex`	`Integer`	要插入元素的索引
`textContents`	`String`	单元格的文本内容

TableCell - 插入的表格单元格

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`insertTableCell(childIndex, tableCell)`

在指定索引处插入给定的 TableCell。

参数

名称	类型	说明
`childIndex`	`Integer`	要插入元素的索引
`tableCell`	`TableCell`	要插入的表格单元格

TableCell - 插入的表格单元格

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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();

TableRow|null - 合并后的元素。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`removeCell(cellIndex)`

移除指定单元格索引处的 TableCell。

参数

名称	类型	说明
`cellIndex`	`Integer`	要移除的单元格的索引

TableCell - 已移除的单元格

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`removeChild(child)`

移除指定的子元素。

参数

名称	类型	说明
`child`	`Element`	要移除的子元素

TableRow - 当前元素

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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();
}

TableRow|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)`

设置元素的属性。

指定的 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`	元素的属性。

TableRow - 当前元素。

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`setLinkUrl(url)`

设置链接网址。

参数

名称	类型	说明
`url`	`String`	链接网址

TableRow - 当前元素

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

`setMinimumHeight(minHeight)`

设置最小高度（以点为单位）。

参数

名称	类型	说明
`minHeight`	`Number`	最小高度（以点为单位）

TableRow - 当前元素

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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`	要应用的文字对齐类型

TableRow - 当前元素

授权

使用此方法的脚本需要获得以下一项或多项范围的授权：

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

Class TableRow 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

方法

详细文档

appendTableCell()

返回

授权

appendTableCell(textContents)

参数

返回

授权

appendTableCell(tableCell)

参数

返回

授权

clear()

返回

copy()

返回

授权

editAsText()

返回

findElement(elementType)

参数

返回

授权

findElement(elementType, from)

参数

返回

授权

findText(searchPattern)

参数

返回

授权

findText(searchPattern, from)

参数

返回

授权

getAttributes()

返回

授权

getCell(cellIndex)

参数

返回

授权

getChild(childIndex)

参数

返回

授权

getChildIndex(child)

参数

返回

授权

getLinkUrl()

返回

授权

getMinimumHeight()

返回

授权

getNextSibling()

返回

授权

getNumCells()

返回

授权

getNumChildren()

返回

授权

getParent()

返回

授权

getParentTable()

返回

授权

getPreviousSibling()

返回

授权

getText()

返回

授权

getTextAlignment()

Class TableRow

`appendTableCell()`

`appendTableCell(textContents)`

`appendTableCell(tableCell)`

`clear()`

`copy()`

`editAsText()`

`findElement(elementType)`

`findElement(elementType, from)`

`findText(searchPattern)`

`findText(searchPattern, from)`

`getAttributes()`

`getCell(cellIndex)`

`getChild(childIndex)`

`getChildIndex(child)`

`getLinkUrl()`

`getMinimumHeight()`

`getNextSibling()`

`getNumCells()`

`getNumChildren()`

`getParent()`

`getParentTable()`

`getPreviousSibling()`

`getText()`

`getTextAlignment()`

`getType()`

`insertTableCell(childIndex)`

`insertTableCell(childIndex, textContents)`

`insertTableCell(childIndex, tableCell)`

`isAtDocumentEnd()`

`merge()`

`removeCell(cellIndex)`

`removeChild(child)`

`removeFromParent()`

`replaceText(searchPattern, replacement)`

`setAttributes(attributes)`

`setLinkUrl(url)`

`setMinimumHeight(minHeight)`

`setTextAlignment(textAlignment)`