Class TableCell

TableCell

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ứcLoại dữ liệu trả vềMô tả ngắn
appendHorizontalRule()HorizontalRuleTạo và thêm HorizontalRule mới.
appendImage(image)InlineImageTạo và nối một InlineImage mới từ blob hình ảnh được chỉ định.
appendImage(image)InlineImageThêm InlineImage đã cho.
appendListItem(listItem)ListItemThêm ListItem đã cho.
appendListItem(text)ListItemTạo và thêm ListItem mới.
appendParagraph(paragraph)ParagraphThêm Paragraph đã cho.
appendParagraph(text)ParagraphTạo và thêm Paragraph mới.
appendTable()TableTạo và thêm Table mới.
appendTable(cells)TableThêm một Table mới chứa các ô được chỉ định.
appendTable(table)TableThêm Table đã cho.
clear()TableCellXoá nội dung của phần tử.
copy()TableCellTrả về một bản sao sâu, tách biệt của phần tử hiện tại.
editAsText()TextLấy phiên bản Text của phần tử hiện tại để chỉnh sửa.
findElement(elementType)RangeElementTì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)RangeElementTì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)RangeElementTì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)RangeElementTì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()ObjectTruy xuất các thuộc tính của phần tử.
getBackgroundColor()StringTruy xuất màu nền.
getChild(childIndex)ElementTruy xuất phần tử con tại chỉ mục con đã chỉ định.
getChildIndex(child)IntegerTruy xuất chỉ mục con cho phần tử con được chỉ định.
getColSpan()IntegerTruy 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()StringTruy xuất URL của đường liên kết.
getNextSibling()ElementTruy xuất phần tử đồng cấp tiếp theo của phần tử đó.
getNumChildren()IntegerTruy xuất số phần tử con.
getPaddingBottom()NumberTruy xuất khoảng đệm dưới cùng, tính bằng điểm.
getPaddingLeft()NumberTruy xuất khoảng đệm bên trái, tính bằng điểm.
getPaddingRight()NumberTruy xuất khoảng đệm phù hợp, tính bằng điểm.
getPaddingTop()NumberTruy xuất khoảng đệm trên cùng, tính bằng điểm.
getParent()ContainerElementTruy xuất phần tử mẹ của phần tử đó.
getParentRow()TableRowTruy xuất TableRow chứa TableCell hiện tại.
getParentTable()TableTruy xuất Table chứa TableCell hiện tại.
getPreviousSibling()ElementTruy xuất phần tử đồng cấp trước đó của phần tử.
getRowSpan()IntegerTruy xuất khoảng hàng. Đây là số hàng của ô trong bảng mà ô này mở rộng.
getText()StringTruy xuất nội dung của phần tử dưới dạng chuỗi văn bản.
getTextAlignment()TextAlignmentXem cách căn chỉnh văn bản.
getType()ElementTypeTruy xuất ElementType của phần tử.
getVerticalAlignment()VerticalAlignmentTruy xuất VerticalAlignment.
getWidth()NumberTruy xuất chiều rộng của cột chứa ô, tính bằng điểm.
insertHorizontalRule(childIndex)HorizontalRuleTạo và chèn một HorizontalRule mới tại chỉ mục đã chỉ định.
insertImage(childIndex, image)InlineImageTạ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)InlineImageChèn InlineImage đã cho vào chỉ mục được chỉ định.
insertListItem(childIndex, listItem)ListItemChèn ListItem đã cho vào chỉ mục được chỉ định.
insertListItem(childIndex, text)ListItemTạo và chèn một ListItem mới tại chỉ mục đã chỉ định.
insertParagraph(childIndex, paragraph)ParagraphChèn Paragraph đã cho vào chỉ mục được chỉ định.
insertParagraph(childIndex, text)ParagraphTạo và chèn một Paragraph mới tại chỉ mục đã chỉ định.
insertTable(childIndex)TableTạo và chèn một Table mới tại chỉ mục đã chỉ định.
insertTable(childIndex, cells)TableTạ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)TableChèn Table đã cho vào chỉ mục được chỉ định.
isAtDocumentEnd()BooleanXác định xem phần tử có nằm ở cuối Document hay không.
merge()TableCellHợp nhất phần tử với phần tử đồng cấp trước đó thuộc cùng loại.
removeChild(child)TableCellXoá phần tử con đã chỉ định.
removeFromParent()TableCellXoá phần tử khỏi phần tử mẹ.
replaceText(searchPattern, replacement)ElementThay 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)TableCellThiế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ênLoạiMô tả
imageBlobSourcedữ 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ênLoạiMô tả
imageInlineImagedữ 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ênLoạiMô tả
listItemListItemmụ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ênLoạiMô tả
textStringnộ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ênLoạiMô tả
paragraphParagraphđ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)

Tạo và thêm Paragraph mới.

Tham số

TênLoạiMô tả
textStringnộ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

appendTable()

Tạo và thêm Table 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

appendTable(cells)

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

Tham số

TênLoạiMô tả
cellsString[][]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)

Thêm Table đã cho.

Tham số

TênLoạiMô tả
tableTablebảng cần thêm

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

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ó 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ư InlineImageHorizontalRule).

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ênLoạiMô tả
elementTypeElementTypeLoạ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ênLoạiMô tả
elementTypeElementTypeLoại phần tử cần tìm kiếm.
fromRangeElementKế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ênLoạiMô tả
searchPatternStringmẫ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ênLoạiMô tả
searchPatternStringmẫu tìm kiếm
fromRangeElementkế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ênLoạiMô tả
childIndexIntegerChỉ 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ênLoạiMô tả
childElementPhầ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()

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

Cầu thủ trả bóng

TableRow — hàng trong bảng có chứa ô 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

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

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

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.SUBSCRIPTDocumentApp.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ênLoạiMô tả
childIndexIntegerchỉ 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ênLoạiMô tả
childIndexIntegerchỉ mục mà bạn muốn chèn phần tử
imageBlobSourcedữ 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ênLoạiMô tả
childIndexIntegerchỉ mục mà bạn muốn chèn phần tử
imageInlineImagehì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ênLoạiMô tả
childIndexIntegerchỉ mục mà bạn muốn chèn phần tử
listItemListItemmụ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ênLoạiMô tả
childIndexIntegerchỉ mục mà bạn muốn chèn phần tử
textStringnộ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ênLoạiMô tả
childIndexIntegerchỉ mục mà bạn muốn chèn phần tử
paragraphParagraphđ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ênLoạiMô tả
childIndexIntegerchỉ mục mà bạn muốn chèn phần tử
textStringnộ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ênLoạiMô tả
childIndexIntegerchỉ 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ênLoạiMô tả
childIndexIntegerchỉ mục cần chèn
cellsString[][]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ênLoạiMô tả
childIndexIntegerchỉ mục mà bạn muốn chèn phần tử
tableTablebả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ênLoạiMô tả
childElementphầ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ênLoạiMô tả
searchPatternStringmẫu biểu thức chính quy để tìm kiếm
replacementStringvă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ênLoạiMô tả
attributesObjectCá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ênLoạiMô tả
colorStringmà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ênLoạiMô tả
urlStringURL 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ênLoạiMô tả
paddingBottomNumberkhoả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ênLoạiMô tả
paddingLeftNumberkhoả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ênLoạiMô tả
paddingRightNumberKhoả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ênLoạiMô tả
paddingTopNumberkhoả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ênLoạiMô tả
textStringnộ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.SUBSCRIPTDocumentApp.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ênLoạiMô tả
textAlignmentTextAlignmentloạ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ênLoạiMô tả
alignmentVerticalAlignmentcă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ênLoạiMô tả
widthNumberchiề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