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à thêm HorizontalRule mới. |
appendImage(image) | InlineImage | Tạo và nối một InlineImage mới từ blob hình ảnh được chỉ định. |
appendImage(image) | InlineImage | Thêm InlineImage đã cho. |
appendListItem(listItem) | ListItem | Thêm ListItem đã cho. |
appendListItem(text) | ListItem | Tạo và thêm ListItem mới. |
appendParagraph(paragraph) | Paragraph | Thêm Paragraph đã cho. |
appendParagraph(text) | Paragraph | Tạo và thêm Paragraph mới. |
appendTable() | Table | Tạo và thêm 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 thành phần con của loại đã chỉ định. |
findElement(elementType, from) | RangeElement | Tìm kiếm nội dung của phần tử cho thành phần con của loại đã chỉ định, bắt đầu từ
RangeElement được chỉ định. |
findText(searchPattern) | RangeElement | Tìm kiếm nội dung của phần tử cho mẫu văn bản được chỉ định bằng cách sử dụng biểu thức chính quy. |
findText(searchPattern, from) | RangeElement | Tìm kiếm nội dung của phần tử cho mẫu văn bản được chỉ định, bắt đầu từ một mẫu văn bản cho trước kết quả tìm kiếm. |
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 đã 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 khoảng cột. Đây là số lượng cột của các ô trong bảng mà ô này trải rộng. |
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ố 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 phù hợp, 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 khoảng hàng. Đây là số hàng của ô trong bảng mà ô này mở rộng. |
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 | Xem cá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 qua blob hình ảnh được chỉ định, tại vị trí được chỉ định
chỉ mục. |
insertImage(childIndex, image) | InlineImage | Chèn InlineImage đã cho vào chỉ mục được chỉ định. |
insertListItem(childIndex, listItem) | ListItem | Chèn ListItem đã cho vào chỉ mục đượ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 đượ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 được chỉ định. |
isAtDocumentEnd() | Boolean | Xác định xem phần tử có nằm ở 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 đó thuộc cùng loại. |
removeChild(child) | TableCell | Xoá phần tử con đã 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 cho trước bằng một chuỗi thay thế cho trước, sử dụng thông thường biểu thức. |
setAttributes(attributes) | TableCell | Thiết lập các thuộc tính của phần tử. |
setBackgroundColor(color) | TableCell | Đặt màu nền. |
setLinkUrl(url) | TableCell | Đặt URL của đườ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ạng văn bản thuần tuý. |
setTextAlignment(textAlignment) | TableCell | Đặt 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à thêm HorizontalRule
mới.
HorizontalRule
sẽ nằm trong một Paragraph
mới.
Cầu thủ trả bóng
HorizontalRule
— quy tắc ngang mới
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 được 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 |
Cầu thủ trả bóng
ListItem
— mục danh sách được thêm vào
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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à thêm 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 cần nối |
Cầu thủ trả bóng
Paragraph
— đoạn được thêm vào
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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)
appendTable()
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 đã nối thêm
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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)
clear()
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ó cha mẹ.
Cầu thủ trả bóng
TableCell
— Bản sao mới.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
để chỉnh sửa nội dung các phần tử ở 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 đã bị xoá sẽ bị xoá khỏi phần tử đó.
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);
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 thành phần con của 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
– Một kết quả tìm kiếm cho biết vị trí của phần tử tìm kiếm.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 thành phần con của loại đã chỉ định, bắt đầu từ
RangeElement
được chỉ định.
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; } }
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
– Một 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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ử cho mẫu văn bản được chỉ định bằng cách sử dụng biểu thức chính quy.
Một số tính năng trong 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 đã cho đượ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 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í của văn bản tìm kiếm hoặc rỗng nếu không có văn bản
khớp
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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ử cho mẫu văn bản được chỉ định, bắt đầu từ một mẫu văn bản cho trước kết quả tìm kiếm.
Một số tính năng trong 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 đã cho đượ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 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 rỗng nếu không có
khớp
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 từng thuộc tính phần tử hợp lệ, trong đó mỗi thuộc tính
tên thuộc tính tương ứng với một mục trong bản liệt kê 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]); }
Cầu thủ trả bóng
Object
– Các thuộc tính của phần tử.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 trong ký hiệu CSS (như '#ffffff'
)
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 đã chỉ định.
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."); }
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 trong chỉ mục đã chỉ định.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 khoảng cột. Đây là số lượng cột của các ô trong bảng mà ô này trải rộng. Các ô chưa hợp nhất có khoảng cột là 1.
Cầu thủ trả bóng
Integer
— khoảng cột hoặc 0 cho một ô được một ô khác hợp nhất đè lên
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 liên kết hoặc rỗng nếu phần tử chứa nhiều giá trị cho thuộc tính này
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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ố phần tử con.
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.");
Cầu thủ trả bóng
Integer
— Số lượng trẻ em.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 phù hợp, 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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()
getParentTable()
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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 khoảng hàng. Đây là số hàng của ô trong bảng mà ô này mở rộng. Chưa hợp nhất các ô có khoảng hàng là 1.
Cầu thủ trả bóng
Integer
— khoảng hàng hoặc 0 cho một ô được hợp nhất bởi một ô khác
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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()
Xem cách căn chỉnh văn bản. Các kiểu căn chỉnh hiện có thể dùng 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 văn bản
hoặc nếu căn chỉnh văn bản chưa bao giờ được đặt
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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ử.
Dùng getType()
để xác định loại chính xác của một phần tử nhất định.
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.'); }
Cầu thủ trả bóng
ElementType
— Loại phần tử.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dọc
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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.
Quy tắc ngang sẽ nằm trong Paragraph
mới.
Tham số
Tên | Loại | Mô tả |
---|---|---|
childIndex | Integer | chỉ mục mà bạn muốn chèn phần tử |
Cầu thủ trả bóng
HorizontalRule
— quy tắc ngang mới
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
qua blob hình ảnh được chỉ định, tại vị trí được chỉ định
chỉ mục.
Hình ảnh này sẽ được đưa vào một Paragraph
mới.
Tham số
Tên | Loại | Mô tả |
---|---|---|
childIndex | Integer | chỉ mục mà bạn muốn chèn phần tử |
image | BlobSource | dữ liệu hình ảnh |
Cầu thủ trả bóng
InlineImage
– hình ảnh cùng dòng đã chèn
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 được chỉ định.
Hình ảnh này sẽ được đưa vào một Paragraph
mới.
Tham số
Tên | Loại | Mô tả |
---|---|---|
childIndex | Integer | chỉ mục mà bạn muốn chèn phần tử |
image | InlineImage | hình ảnh cần chèn |
Cầu thủ trả bóng
InlineImage
– hình ảnh cùng dòng đã chèn
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 được chỉ định.
Tham số
Tên | Loại | Mô tả |
---|---|---|
childIndex | Integer | chỉ mục mà bạn muốn 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 mà bạn muốn 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 được chỉ định.
Tham số
Tên | Loại | Mô tả |
---|---|---|
childIndex | Integer | chỉ mục mà bạn muốn chèn phần tử |
paragraph | Paragraph | đoạn cần chèn |
Cầu thủ trả bóng
Paragraph
— đoạn được chèn
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 mà bạn muốn chèn phần tử |
text | String | nội dung văn bản |
Cầu thủ trả bóng
Paragraph
— đoạn mới
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 mà bạn muốn chèn phần tử |
Cầu thủ trả bóng
Table
– bảng mới
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 được chỉ định.
Tham số
Tên | Loại | Mô tả |
---|---|---|
childIndex | Integer | chỉ mục mà bạn muốn 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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ó nằm ở cuối Document
hay không.
Cầu thủ trả bóng
Boolean
– Liệu phần tử này có nằm ở cuối thẻ hay không.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 đó thuộc cùng loại.
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 di chuyển đến phần tử cùng cấp trước đó.
Phần tử hiện tại sẽ bị xoá khỏi tài liệu.
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();
Cầu thủ trả bóng
TableCell
– Phần tử đã hợp nhất.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 đã 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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ẹ.
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(); }
Cầu thủ trả bóng
TableCell
– Phần tử đã bị xoá.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 cho trước bằng một chuỗi thay thế cho trước, sử dụng thông thường biểu thức.
Mẫu tìm kiếm được chuyển dưới dạng chuỗi, không phải là đối tượng biểu thức chính quy JavaScript. Do đó, bạn cần thoát khỏi mọi dấu gạch chéo ngược trong mẫu.
Phương thức này sử dụng mã thông thường RE2 của Google thư viện biểu thức để giới hạn cú pháp được hỗ trợ.
Mẫu biểu thức chính quy đã cho đượ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.
var 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 để tìm kiếm |
replacement | String | văn bản để sử dụng để thay thế |
Cầu thủ trả bóng
Element
– phần tử hiện tại
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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)
Thiết lập các thuộc tính của phần tử.
Thông 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
bản liệt kê DocumentApp.Attribute
và mỗi giá trị thuộc tính là một giá trị mới
áp dụng.
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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
attributes | Object | Các 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 bằng ký hiệu CSS (như '#ffffff' ) |
Cầu thủ trả bóng
TableCell
– phần tử hiện tại
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 của đườ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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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ạng văn bản thuần tuý.
Lưu ý: các 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 căn chỉnh văn bản. Các kiểu căn chỉnh hiện có thể dùng là DocumentApp.TextAlignment.NORMAL
, DocumentApp.TextAlignment.SUBSCRIPT
và 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);
Tham số
Tên | Loại | Mô tả |
---|---|---|
textAlignment | TextAlignment | loại căn chỉnh văn bản sẽ áp dụng |
Cầu thủ trả bóng
TableCell
– phần tử hiện tại
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dọc |
Cầu thủ trả bóng
TableCell
– phần tử hiện tại
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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