Class HeaderSection

HeaderSection

Một phần tử đại diện cho phần tiêu đề. Document thường chứa tối đa một HeaderSection. HeaderSection có thể chứa ListItem, Paragraph và Phần tử 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à nối một ListItem mới chứa nội dung văn bản được chỉ định.
appendParagraph(paragraph)ParagraphThêm Paragraph đã cho.
appendParagraph(text)ParagraphTạo và nối một Paragraph mới chứa nội dung văn bản được chỉ định.
appendTable()TableTạo và thêm Table mới.
appendTable(cells)TableThêm một Table mới có chứa TableCell cho từng giá trị chuỗi được chỉ định.
appendTable(table)TableThêm Table đã cho.
clear()HeaderSectionXoá nội dung của phần tử.
copy()HeaderSectionTrả 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ử.
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.
getImages()InlineImage[]Truy xuất tất cả InlineImages có trong phần đó.
getListItems()ListItem[]Truy xuất tất cả ListItems có trong phần đó.
getNumChildren()IntegerTruy xuất số phần tử con.
getParagraphs()Paragraph[]Truy xuất tất cả Paragraphs có trong phần đó (bao gồm cả ListItems).
getParent()ContainerElementTruy xuất phần tử mẹ của phần tử đó.
getTables()Table[]Truy xuất tất cả Tables có trong phần đó.
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ử.
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, chứa nội dung văn bản.
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, chứa nội dung văn bản.
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.
removeChild(child)HeaderSectionXoá phần tử con đã chỉ định.
removeFromParent()HeaderSectionXoá 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)HeaderSectionThiết lập các thuộc tính của phần tử.
setText(text)HeaderSectionĐặt nội dung ở dạng văn bản thuần tuý.
setTextAlignment(textAlignment)HeaderSectionĐặt căn chỉnh văn bản.

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 mới theo chiều ngang.

Ủ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.

Hình ảnh này sẽ được đưa vào 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 đượ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

appendImage(image)

Thêm InlineImage đã cho.

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

Sử dụng phiên bản appendImage này khi thêm bản sao của InlineImage hiện có.

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.

Sử dụng phiên bản appendListItem này khi thêm bản sao của ListItem hiện có.

Tham số

TênLoạiMô tả
listItemListItemMục danh sách cần bổ sung.

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à nối một ListItem mới chứa nội dung văn bản được chỉ định.

Các mục danh sách liên tiếp được thêm vào cùng một danh sách.

Tham số

TênLoạiMô tả
textStringNội dung văn bản của mục danh sách.

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.

Sử dụng phiên bản appendParagraph này khi thêm bản sao của Paragraph hiện có.

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à nối một Paragraph mới chứa nội dung văn bản được chỉ định.

Tham số

TênLoạiMô tả
textStringNội dung văn bản của đoạ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.

Phương thức này cũng sẽ thêm một đoạn trống sau bảng, vì các tài liệu trong Google Tài liệu không thể kết thúc bằng một bảng.

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 có chứa TableCell cho từng giá trị chuỗi được chỉ định.

Phương thức này cũng sẽ thêm một đoạn trống sau bảng, vì các tài liệu trong Google Tài liệu không thể kết thúc bằng một bảng.

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.

Sử dụng phiên bản appendTable này khi thêm bản sao của Table hiện có. Phương thức này cũng sẽ thêm một đoạn trống sau bảng, vì các tài liệu trong Google Tài liệu không thể kết thúc bằng một bảng.

Tham số

TênLoạiMô tả
tableTableBảng cần bổ sung.

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

HeaderSection — 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

HeaderSection — 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

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

getImages()

Truy xuất tất cả InlineImages có trong phần đó.

Cầu thủ trả bóng

InlineImage[] — Hình ảnh của phần 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

getListItems()

Truy xuất tất cả ListItems có trong phần đó.

Cầu thủ trả bóng

ListItem[] — Các mục trong danh sách của mụ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

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

getParagraphs()

Truy xuất tất cả Paragraphs có trong phần đó (bao gồm cả ListItems).

Cầu thủ trả bóng

Paragraph[] — Các đoạn trong mụ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

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

getTables()

Truy xuất tất cả Tables có trong phần đó.

Cầu thủ trả bóng

Table[] — Các bảng mụ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

insertHorizontalRule(childIndex)

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

HorizontalRule sẽ nằm trong một 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 mới theo chiều ngang.

Ủ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.

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 cần chèn.
listItemListItemMục danh sách cần chèn.

Cầu thủ trả bóng

ListItem — Mục danh sách đượ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

insertListItem(childIndex, text)

Tạo và chèn một ListItem mới tại chỉ mục đã chỉ định, chứa nội dung văn bản.

Tham số

TênLoạiMô tả
childIndexIntegerChỉ mục mà bạn cần chèn.
textStringNội dung văn bản của mục danh sách.

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 cần chèn.
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, chứa nội dung văn bản.

Tham số

TênLoạiMô tả
childIndexIntegerChỉ mục mà bạn cần chèn.
textStringNội dung văn bản của đoạ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 cần chèn.

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 mà bạn 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 cần chèn.
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

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

HeaderSection — 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

HeaderSection – 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

HeaderSection — 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

HeaderSection — 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

HeaderSection – 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

Các phương thức ngừng hoạt động