Trang này được dịch bởi Cloud Translation API.

Class TableCell

Một phần tử đại diện cho một ô trong bảng. TableCell luôn nằm trong TableRow và có thể chứa các phần tử ListItem, Paragraph hoặc Table. Để biết thêm thông tin về cấu trúc tài liệu, hãy xem hướng dẫn mở rộng Google Tài liệu.

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`appendHorizontalRule()`	`HorizontalRule`	Tạo và nối một `HorizontalRule` mới.
`appendImage(image)`	`InlineImage`	Tạo và nối một `InlineImage` mới từ blob hình ảnh đã chỉ định.
`appendImage(image)`	`InlineImage`	Thêm `InlineImage` đã cho.
`appendListItem(listItem)`	`ListItem`	Thêm `ListItem` đã cho.
`appendListItem(text)`	`ListItem`	Tạo và nối một `ListItem` mới.
`appendParagraph(paragraph)`	`Paragraph`	Thêm `Paragraph` đã cho.
`appendParagraph(text)`	`Paragraph`	Tạo và nối một `Paragraph` mới.
`appendTable()`	`Table`	Tạo và nối một `Table` mới.
`appendTable(cells)`	`Table`	Thêm một `Table` mới chứa các ô được chỉ định.
`appendTable(table)`	`Table`	Thêm `Table` đã cho.
`clear()`	`TableCell`	Xoá nội dung của phần tử.
`copy()`	`TableCell`	Trả về một bản sao sâu, tách biệt của phần tử hiện tại.
`editAsText()`	`Text`	Lấy phiên bản `Text` của phần tử hiện tại để chỉnh sửa.
`findElement(elementType)`	`RangeElement`	Tìm kiếm nội dung của phần tử cho một phần tử con thuộc loại đã chỉ định.
`findElement(elementType, from)`	`RangeElement`	Tìm kiếm nội dung của phần tử cho một phần tử con của loại đã chỉ định, bắt đầu từ `RangeElement` đã chỉ định.
`findText(searchPattern)`	`RangeElement`	Tìm kiếm nội dung của phần tử theo mẫu văn bản đã chỉ định bằng biểu thức chính quy.
`findText(searchPattern, from)`	`RangeElement`	Tìm kiếm nội dung của phần tử theo mẫu văn bản đã chỉ định, bắt đầu từ một kết quả tìm kiếm nhất định.
`getAttributes()`	`Object`	Truy xuất các thuộc tính của phần tử.
`getBackgroundColor()`	`String`	Truy xuất màu nền.
`getChild(childIndex)`	`Element`	Truy xuất phần tử con tại chỉ mục con được chỉ định.
`getChildIndex(child)`	`Integer`	Truy xuất chỉ mục con cho phần tử con được chỉ định.
`getColSpan()`	`Integer`	Truy xuất span cột, tức là số cột của các ô trong bảng mà ô này trải dài.
`getLinkUrl()`	`String`	Truy xuất URL của đường liên kết.
`getNextSibling()`	`Element`	Truy xuất phần tử đồng cấp tiếp theo của phần tử.
`getNumChildren()`	`Integer`	Truy xuất số lượng phần tử con.
`getPaddingBottom()`	`Number`	Truy xuất khoảng đệm dưới cùng, tính bằng điểm.
`getPaddingLeft()`	`Number`	Truy xuất khoảng đệm bên trái, tính bằng điểm.
`getPaddingRight()`	`Number`	Truy xuất khoảng đệm bên phải, tính bằng điểm.
`getPaddingTop()`	`Number`	Truy xuất khoảng đệm trên cùng, tính bằng điểm.
`getParent()`	`ContainerElement`	Truy xuất phần tử mẹ của phần tử.
`getParentRow()`	`TableRow`	Truy xuất `TableRow` chứa `TableCell` hiện tại.
`getParentTable()`	`Table`	Truy xuất `Table` chứa `TableCell` hiện tại.
`getPreviousSibling()`	`Element`	Truy xuất phần tử đồng cấp trước đó của phần tử.
`getRowSpan()`	`Integer`	Truy xuất span hàng, tức là số hàng của các ô trong bảng mà ô này trải dài.
`getText()`	`String`	Truy xuất nội dung của phần tử dưới dạng chuỗi văn bản.
`getTextAlignment()`	`TextAlignment`	Lấy chế độ căn chỉnh văn bản.
`getType()`	`ElementType`	Truy xuất `ElementType` của phần tử.
`getVerticalAlignment()`	`VerticalAlignment`	Truy xuất `VerticalAlignment`.
`getWidth()`	`Number`	Truy xuất chiều rộng của cột chứa ô, tính bằng điểm.
`insertHorizontalRule(childIndex)`	`HorizontalRule`	Tạo và chèn một `HorizontalRule` mới tại chỉ mục đã chỉ định.
`insertImage(childIndex, image)`	`InlineImage`	Tạo và chèn `InlineImage` từ blob hình ảnh đã chỉ định, tại chỉ mục đã chỉ định.
`insertImage(childIndex, image)`	`InlineImage`	Chèn `InlineImage` đã cho vào chỉ mục đã chỉ định.
`insertListItem(childIndex, listItem)`	`ListItem`	Chèn `ListItem` đã cho vào chỉ mục đã chỉ định.
`insertListItem(childIndex, text)`	`ListItem`	Tạo và chèn một `ListItem` mới tại chỉ mục đã chỉ định.
`insertParagraph(childIndex, paragraph)`	`Paragraph`	Chèn `Paragraph` đã cho vào chỉ mục đã chỉ định.
`insertParagraph(childIndex, text)`	`Paragraph`	Tạo và chèn một `Paragraph` mới tại chỉ mục đã chỉ định.
`insertTable(childIndex)`	`Table`	Tạo và chèn một `Table` mới tại chỉ mục đã chỉ định.
`insertTable(childIndex, cells)`	`Table`	Tạo và chèn một `Table` mới chứa các ô đã chỉ định, tại chỉ mục đã chỉ định.
`insertTable(childIndex, table)`	`Table`	Chèn `Table` đã cho vào chỉ mục đã chỉ định.
`isAtDocumentEnd()`	`Boolean`	Xác định xem phần tử có ở cuối `Document` hay không.
`merge()`	`TableCell`	Hợp nhất phần tử với phần tử đồng cấp trước đó có cùng loại.
`removeChild(child)`	`TableCell`	Xoá phần tử con được chỉ định.
`removeFromParent()`	`TableCell`	Xoá phần tử khỏi phần tử mẹ.
`replaceText(searchPattern, replacement)`	`Element`	Thay thế tất cả các lần xuất hiện của một mẫu văn bản nhất định bằng một chuỗi thay thế nhất định, bằng cách sử dụng biểu thức chính quy.
`setAttributes(attributes)`	`TableCell`	Đặt thuộc tính của phần tử.
`setBackgroundColor(color)`	`TableCell`	Đặt màu nền.
`setLinkUrl(url)`	`TableCell`	Đặt URL đường liên kết.
`setPaddingBottom(paddingBottom)`	`TableCell`	Đặt khoảng đệm dưới cùng, tính bằng điểm.
`setPaddingLeft(paddingLeft)`	`TableCell`	Đặt khoảng đệm bên trái, tính bằng điểm.
`setPaddingRight(paddingRight)`	`TableCell`	Đặt khoảng đệm bên phải, tính bằng điểm.
`setPaddingTop(paddingTop)`	`TableCell`	Đặt khoảng đệm trên cùng, tính bằng điểm.
`setText(text)`	`TableCell`	Đặt nội dung dưới dạng văn bản thuần tuý.
`setTextAlignment(textAlignment)`	`TableCell`	Đặt chế độ căn chỉnh văn bản.
`setVerticalAlignment(alignment)`	`TableCell`	Đặt cách căn chỉnh dọc.
`setWidth(width)`	`TableCell`	Đặt chiều rộng của cột chứa ô hiện tại, tính bằng điểm.

Tài liệu chi tiết

`appendHorizontalRule()`

Tạo và nối một HorizontalRule mới.

HorizontalRule sẽ nằm trong một Paragraph mới.

Cầu thủ trả bóng

HorizontalRule – dòng kẻ ngang mới

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`appendImage(image)`

Tạo và nối một InlineImage mới từ blob hình ảnh đã chỉ định.

InlineImage sẽ nằm trong một Paragraph mới.

Tham số

Tên	Loại	Mô tả
`image`	`BlobSource`	dữ liệu hình ảnh

Cầu thủ trả bóng

InlineImage – hình ảnh mới

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`appendImage(image)`

Thêm InlineImage đã cho.

InlineImage sẽ nằm trong một Paragraph mới.

Tham số

Tên	Loại	Mô tả
`image`	`InlineImage`	dữ liệu hình ảnh

Cầu thủ trả bóng

InlineImage – hình ảnh được thêm vào

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`appendListItem(listItem)`

Thêm ListItem đã cho.

Tham số

Tên	Loại	Mô tả
`listItem`	`ListItem`	mục danh sách cần thêm vào

Cầu thủ trả bóng

ListItem – mục danh sách được thêm vào

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`appendListItem(text)`

Tạo và nối một ListItem mới.

Tham số

Tên	Loại	Mô tả
`text`	`String`	nội dung văn bản

Cầu thủ trả bóng

ListItem – mục danh sách mới

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`appendParagraph(paragraph)`

Thêm Paragraph đã cho.

Tham số

Tên	Loại	Mô tả
`paragraph`	`Paragraph`	đoạn văn bản cần thêm vào

Cầu thủ trả bóng

Paragraph – đoạn văn được thêm vào

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`appendParagraph(text)`

Tạo và nối một Paragraph mới.

Tham số

Tên	Loại	Mô tả
`text`	`String`	nội dung văn bản

Cầu thủ trả bóng

Paragraph – đoạn văn mới

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`appendTable()`

Tạo và nối một Table mới.

Cầu thủ trả bóng

Table – bảng mới

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`appendTable(cells)`

Thêm một Table mới chứa các ô được chỉ định.

Tham số

Tên	Loại	Mô tả
`cells`	`String[][]`	nội dung văn bản của các ô trong bảng cần thêm vào bảng mới

Cầu thủ trả bóng

Table – bảng được thêm vào

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`appendTable(table)`

Thêm Table đã cho.

Tham số

Tên	Loại	Mô tả
`table`	`Table`	bảng cần nối

Cầu thủ trả bóng

Table – bảng được thêm vào

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`clear()`

Xoá nội dung của phần tử.

Cầu thủ trả bóng

TableCell – Phần tử hiện tại.

`copy()`

Trả về một bản sao sâu, tách biệt của phần tử hiện tại.

Mọi phần tử con có trong phần tử cũng được sao chép. Phần tử mới không có phần tử mẹ.

Cầu thủ trả bóng

TableCell – Bản sao mới.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`editAsText()`

Lấy phiên bản Text của phần tử hiện tại để chỉnh sửa.

Sử dụng editAsText để thao tác với nội dung của các phần tử dưới dạng văn bản đa dạng thức. Chế độ editAsText bỏ qua các phần tử không phải văn bản (chẳng hạn như InlineImage và HorizontalRule).

Các phần tử con nằm hoàn toàn trong một dải văn bản đã xoá sẽ bị xoá khỏi phần tử.

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

Cầu thủ trả bóng

Text – phiên bản văn bản của phần tử hiện tại

`findElement(elementType)`

Tìm kiếm nội dung của phần tử cho một phần tử con thuộc loại đã chỉ định.

Tham số

Tên	Loại	Mô tả
`elementType`	`ElementType`	Loại phần tử cần tìm kiếm.

Cầu thủ trả bóng

RangeElement – Kết quả tìm kiếm cho biết vị trí của phần tử tìm kiếm.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`findElement(elementType, from)`

Tìm kiếm nội dung của phần tử cho một phần tử con của loại đã chỉ định, bắt đầu từ RangeElement đã chỉ định.

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

Tham số

Tên	Loại	Mô tả
`elementType`	`ElementType`	Loại phần tử cần tìm kiếm.
`from`	`RangeElement`	Kết quả tìm kiếm để tìm kiếm.

Cầu thủ trả bóng

RangeElement – Kết quả tìm kiếm cho biết vị trí tiếp theo của phần tử tìm kiếm.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`findText(searchPattern)`

Tìm kiếm nội dung của phần tử theo mẫu văn bản đã chỉ định bằng biểu thức chính quy.

Một số tính năng của biểu thức chính quy JavaScript không được hỗ trợ đầy đủ, chẳng hạn như nhóm thu thập và đối tượng sửa đổi chế độ.

Mẫu biểu thức chính quy được cung cấp được so khớp độc lập với từng khối văn bản có trong phần tử hiện tại.

Tham số

Tên	Loại	Mô tả
`searchPattern`	`String`	mẫu cần tìm kiếm

Cầu thủ trả bóng

RangeElement – kết quả tìm kiếm cho biết vị trí của văn bản tìm kiếm hoặc giá trị rỗng nếu không có kết quả nào khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`findText(searchPattern, from)`

Tìm kiếm nội dung của phần tử theo mẫu văn bản đã chỉ định, bắt đầu từ một kết quả tìm kiếm nhất định.

Một số tính năng của biểu thức chính quy JavaScript không được hỗ trợ đầy đủ, chẳng hạn như nhóm thu thập và đối tượng sửa đổi chế độ.

Mẫu biểu thức chính quy được cung cấp được so khớp độc lập với từng khối văn bản có trong phần tử hiện tại.

Tham số

Tên	Loại	Mô tả
`searchPattern`	`String`	mẫu cần tìm kiếm
`from`	`RangeElement`	kết quả tìm kiếm để tìm kiếm

Cầu thủ trả bóng

RangeElement – một kết quả tìm kiếm cho biết vị trí tiếp theo của văn bản tìm kiếm hoặc giá trị rỗng nếu không có kết quả khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getAttributes()`

Truy xuất các thuộc tính của phần tử.

Kết quả là một đối tượng chứa một thuộc tính cho mỗi thuộc tính phần tử hợp lệ, trong đó mỗi tên thuộc tính tương ứng với một mục trong enum 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]}`);
}

Cầu thủ trả bóng

Object – Các thuộc tính của phần tử.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getBackgroundColor()`

Truy xuất màu nền.

Cầu thủ trả bóng

String – màu nền, được định dạng theo ký hiệu CSS (như '#ffffff')

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getChild(childIndex)`

Truy xuất phần tử con tại chỉ mục con được chỉ định.

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.');
}

Tham số

Tên	Loại	Mô tả
`childIndex`	`Integer`	Chỉ mục của phần tử con cần truy xuất.

Cầu thủ trả bóng

Element – Phần tử con tại chỉ mục được chỉ định.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getChildIndex(child)`

Truy xuất chỉ mục con cho phần tử con được chỉ định.

Tham số

Tên	Loại	Mô tả
`child`	`Element`	Phần tử con để truy xuất chỉ mục.

Cầu thủ trả bóng

Integer – Chỉ mục con.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getColSpan()`

Truy xuất span cột, tức là số cột của các ô trong bảng mà ô này trải dài. Các ô không được hợp nhất có span cột là 1.

Cầu thủ trả bóng

Integer – span cột hoặc 0 đối với một ô được hợp nhất với một ô khác

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getLinkUrl()`

Truy xuất URL của đường liên kết.

Cầu thủ trả bóng

String – URL của đường liên kết hoặc giá trị rỗng nếu phần tử chứa nhiều giá trị cho thuộc tính này

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getNextSibling()`

Truy xuất phần tử đồng cấp tiếp theo của phần tử.

Phần tử đồng cấp tiếp theo có cùng phần tử mẹ và theo sau phần tử hiện tại.

Cầu thủ trả bóng

Element – Phần tử đồng cấp tiếp theo.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getNumChildren()`

Truy xuất số lượng phần tử con.

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.`);

Cầu thủ trả bóng

Integer – Số lượng phần tử con.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getPaddingBottom()`

Truy xuất khoảng đệm dưới cùng, tính bằng điểm.

Cầu thủ trả bóng

Number – khoảng đệm dưới cùng, tính bằng điểm

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getPaddingLeft()`

Truy xuất khoảng đệm bên trái, tính bằng điểm.

Cầu thủ trả bóng

Number – khoảng đệm bên trái, tính bằng điểm

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getPaddingRight()`

Truy xuất khoảng đệm bên phải, tính bằng điểm.

Cầu thủ trả bóng

Number – khoảng đệm bên phải, tính bằng điểm

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getPaddingTop()`

Truy xuất khoảng đệm trên cùng, tính bằng điểm.

Cầu thủ trả bóng

Number – khoảng đệm trên cùng, tính bằng điểm

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getParent()`

Truy xuất phần tử mẹ của phần tử.

Phần tử mẹ chứa phần tử hiện tại.

Cầu thủ trả bóng

ContainerElement – Phần tử mẹ.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getParentRow()`

Truy xuất TableRow chứa TableCell hiện tại.

Cầu thủ trả bóng

TableRow – hàng trong bảng chứa ô hiện tại

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getParentTable()`

Truy xuất Table chứa TableCell hiện tại.

Cầu thủ trả bóng

Table – bảng chứa ô hiện tại

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getPreviousSibling()`

Truy xuất phần tử đồng cấp trước đó của phần tử.

Phần tử đồng cấp trước đó có cùng phần tử mẹ và đứng trước phần tử hiện tại.

Cầu thủ trả bóng

Element – Phần tử đồng cấp trước đó.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getRowSpan()`

Truy xuất span hàng, tức là số hàng của các ô trong bảng mà ô này trải dài. Các ô không được hợp nhất có span hàng là 1.

Cầu thủ trả bóng

Integer – span hàng hoặc 0 đối với ô được hợp nhất bởi một ô khác

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getText()`

Truy xuất nội dung của phần tử dưới dạng chuỗi văn bản.

Cầu thủ trả bóng

String – nội dung của phần tử dưới dạng chuỗi văn bản

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getTextAlignment()`

Lấy chế độ căn chỉnh văn bản. Các loại căn chỉnh có sẵn là DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT và DocumentApp.TextAlignment.SUPERSCRIPT.

Cầu thủ trả bóng

TextAlignment – loại căn chỉnh văn bản hoặc null nếu văn bản chứa nhiều loại căn chỉnh văn bản hoặc nếu bạn chưa bao giờ đặt căn chỉnh văn bản

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getType()`

Truy xuất ElementType của phần tử.

Sử dụng getType() để xác định chính xác loại của một phần tử nhất định.

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.');
}

Cầu thủ trả bóng

ElementType – Loại phần tử.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getVerticalAlignment()`

Truy xuất VerticalAlignment.

Cầu thủ trả bóng

VerticalAlignment – căn chỉnh theo chiều dọc

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getWidth()`

Truy xuất chiều rộng của cột chứa ô, tính bằng điểm.

Cầu thủ trả bóng

Number – chiều rộng cột, tính bằng điểm

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`insertHorizontalRule(childIndex)`

Tạo và chèn một HorizontalRule mới tại chỉ mục đã chỉ định.

Đường kẻ ngang sẽ nằm trong một Paragraph mới.

Tham số

Tên	Loại	Mô tả
`childIndex`	`Integer`	chỉ mục để chèn phần tử

Cầu thủ trả bóng

HorizontalRule – dòng kẻ ngang mới

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`insertImage(childIndex, image)`

Tạo và chèn InlineImage từ blob hình ảnh đã chỉ định, tại chỉ mục đã chỉ định.

Hình ảnh sẽ nằm trong một Paragraph mới.

Tham số

Tên	Loại	Mô tả
`childIndex`	`Integer`	chỉ mục để chèn phần tử
`image`	`BlobSource`	dữ liệu hình ảnh

Cầu thủ trả bóng

InlineImage – hình ảnh nội tuyến đã chèn

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`insertImage(childIndex, image)`

Chèn InlineImage đã cho vào chỉ mục đã chỉ định.

Hình ảnh sẽ nằm trong một Paragraph mới.

Tham số

Tên	Loại	Mô tả
`childIndex`	`Integer`	chỉ mục để chèn phần tử
`image`	`InlineImage`	hình ảnh cần chèn

Cầu thủ trả bóng

InlineImage – hình ảnh nội tuyến đã chèn

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`insertListItem(childIndex, listItem)`

Chèn ListItem đã cho vào chỉ mục đã chỉ định.

Tham số

Tên	Loại	Mô tả
`childIndex`	`Integer`	chỉ mục để chèn phần tử
`listItem`	`ListItem`	mục danh sách cần chèn

Cầu thủ trả bóng

ListItem – đã chèn mục danh sách mới

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`insertListItem(childIndex, text)`

Tạo và chèn một ListItem mới tại chỉ mục đã chỉ định.

Tham số

Tên	Loại	Mô tả
`childIndex`	`Integer`	chỉ mục để chèn phần tử
`text`	`String`	nội dung văn bản

Cầu thủ trả bóng

ListItem – mục danh sách mới

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`insertParagraph(childIndex, paragraph)`

Chèn Paragraph đã cho vào chỉ mục đã chỉ định.

Tham số

Tên	Loại	Mô tả
`childIndex`	`Integer`	chỉ mục để chèn phần tử
`paragraph`	`Paragraph`	đoạn văn bản cần chèn

Cầu thủ trả bóng

Paragraph – đoạn văn bản được chèn

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`insertParagraph(childIndex, text)`

Tạo và chèn một Paragraph mới tại chỉ mục đã chỉ định.

Tham số

Tên	Loại	Mô tả
`childIndex`	`Integer`	chỉ mục để chèn phần tử
`text`	`String`	nội dung văn bản

Cầu thủ trả bóng

Paragraph – đoạn văn mới

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`insertTable(childIndex)`

Tạo và chèn một Table mới tại chỉ mục đã chỉ định.

Tham số

Tên	Loại	Mô tả
`childIndex`	`Integer`	chỉ mục để chèn phần tử

Cầu thủ trả bóng

Table – bảng mới

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`insertTable(childIndex, cells)`

Tạo và chèn một Table mới chứa các ô đã chỉ định, tại chỉ mục đã chỉ định.

Tham số

Tên	Loại	Mô tả
`childIndex`	`Integer`	chỉ mục cần chèn
`cells`	`String[][]`	nội dung văn bản của các ô trong bảng cần thêm vào bảng mới

Cầu thủ trả bóng

Table – bảng mới

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`insertTable(childIndex, table)`

Chèn Table đã cho vào chỉ mục đã chỉ định.

Tham số

Tên	Loại	Mô tả
`childIndex`	`Integer`	chỉ mục để chèn phần tử
`table`	`Table`	bảng cần chèn

Cầu thủ trả bóng

Table – bảng đã chèn

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`isAtDocumentEnd()`

Xác định xem phần tử có ở cuối Document hay không.

Cầu thủ trả bóng

Boolean – Liệu phần tử có ở cuối thẻ hay không.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`merge()`

Hợp nhất phần tử với phần tử đồng cấp trước đó có cùng loại.

Bạn chỉ có thể hợp nhất các phần tử của cùng một ElementType. Mọi phần tử con có trong phần tử hiện tại sẽ được chuyển sang phần tử đồng cấp trước đó.

Phần tử hiện tại sẽ bị xoá khỏi tài liệu.

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

Cầu thủ trả bóng

TableCell – Phần tử được hợp nhất.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`removeChild(child)`

Xoá phần tử con được chỉ định.

Tham số

Tên	Loại	Mô tả
`child`	`Element`	phần tử con cần xoá

Cầu thủ trả bóng

TableCell – phần tử hiện tại

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`removeFromParent()`

Xoá phần tử khỏi phần tử mẹ.

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

Cầu thủ trả bóng

TableCell – Phần tử đã xoá.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`replaceText(searchPattern, replacement)`

Thay thế tất cả các lần xuất hiện của một mẫu văn bản nhất định bằng một chuỗi thay thế nhất định, bằng cách sử dụng biểu thức chính quy.

Mẫu tìm kiếm được truyền dưới dạng chuỗi, chứ không phải đối tượng biểu thức chính quy JavaScript. Do đó, bạn cần thoát mọi dấu gạch chéo ngược trong mẫu.

Phương thức này sử dụng thư viện biểu thức chính quy RE2 của Google, giới hạn cú pháp được hỗ trợ.

Mẫu biểu thức chính quy được cung cấp được so khớp độc lập với từng khối văn bản có trong phần tử hiện tại.

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

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

Tham số

Tên	Loại	Mô tả
`searchPattern`	`String`	mẫu biểu thức chính quy cần tìm kiếm
`replacement`	`String`	văn bản cần dùng để thay thế

Cầu thủ trả bóng

Element – phần tử hiện tại

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`setAttributes(attributes)`

Đặt thuộc tính của phần tử.

Tham số thuộc tính được chỉ định phải là một đối tượng, trong đó mỗi tên thuộc tính là một mục trong enumeration DocumentApp.Attribute và mỗi giá trị thuộc tính là giá trị mới sẽ được áp dụng.

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

Tham số

Tên	Loại	Mô tả
`attributes`	`Object`	Thuộc tính của phần tử.

Cầu thủ trả bóng

TableCell – Phần tử hiện tại.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`setBackgroundColor(color)`

Đặt màu nền.

Tham số

Tên	Loại	Mô tả
`color`	`String`	màu nền, được định dạng theo ký hiệu CSS (chẳng hạn như `'#ffffff'`)

Cầu thủ trả bóng

TableCell – phần tử hiện tại

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`setLinkUrl(url)`

Đặt URL đường liên kết.

Tham số

Tên	Loại	Mô tả
`url`	`String`	URL của đường liên kết

Cầu thủ trả bóng

TableCell – phần tử hiện tại

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`setPaddingBottom(paddingBottom)`

Đặt khoảng đệm dưới cùng, tính bằng điểm.

Tham số

Tên	Loại	Mô tả
`paddingBottom`	`Number`	khoảng đệm dưới cùng, tính bằng điểm

Cầu thủ trả bóng

TableCell – phần tử hiện tại

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`setPaddingLeft(paddingLeft)`

Đặt khoảng đệm bên trái, tính bằng điểm.

Tham số

Tên	Loại	Mô tả
`paddingLeft`	`Number`	khoảng đệm bên trái, tính bằng điểm

Cầu thủ trả bóng

TableCell – phần tử hiện tại

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`setPaddingRight(paddingRight)`

Đặt khoảng đệm bên phải, tính bằng điểm.

Tham số

Tên	Loại	Mô tả
`paddingRight`	`Number`	Khoảng đệm bên phải, tính bằng điểm.

Cầu thủ trả bóng

TableCell – Phần tử hiện tại.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`setPaddingTop(paddingTop)`

Đặt khoảng đệm trên cùng, tính bằng điểm.

Tham số

Tên	Loại	Mô tả
`paddingTop`	`Number`	khoảng đệm trên cùng, tính bằng điểm

Cầu thủ trả bóng

TableCell – phần tử hiện tại

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`setText(text)`

Đặt nội dung dưới dạng văn bản thuần tuý.

Lưu ý: nội dung hiện có sẽ bị xoá.

Tham số

Tên	Loại	Mô tả
`text`	`String`	nội dung văn bản mới

Cầu thủ trả bóng

TableCell – phần tử hiện tại

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`setTextAlignment(textAlignment)`

Đặt chế độ căn chỉnh văn bản. Các loại căn chỉnh có sẵn là DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT và 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);

Tham số

Tên	Loại	Mô tả
`textAlignment`	`TextAlignment`	loại căn chỉnh văn bản cần áp dụng

Cầu thủ trả bóng

TableCell – phần tử hiện tại

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`setVerticalAlignment(alignment)`

Đặt cách căn chỉnh dọc.

Tham số

Tên	Loại	Mô tả
`alignment`	`VerticalAlignment`	căn chỉnh theo chiều dọc

Cầu thủ trả bóng

TableCell – phần tử hiện tại

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`setWidth(width)`

Đặt chiều rộng của cột chứa ô hiện tại, tính bằng điểm.

Tham số

Tên	Loại	Mô tả
`width`	`Number`	chiều rộng cột, tính bằng điểm

Cầu thủ trả bóng

TableCell – phần tử hiện tại

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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