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

Class Person

(Người)

Một phần tử thể hiện đường liên kết đến một người. Đường liên kết đến hồ sơ người dùng là một địa chỉ email và có thể có tên liên kết với địa chỉ email (không bắt buộc). Nếu tên được thiết lập, tên sẽ là nội dung hiển thị trong phần nội dung tài liệu.

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
`copy()`	`Person`	Trả về một bản sao sâu đã tách rời của phần tử hiện tại.
`getAttributes()`	`Object`	Truy xuất các thuộc tính của phần tử.
`getEmail()`	`String`	Trả về địa chỉ email của người đó.
`getName()`	`String`	Trả về tên hiển thị của người đó, nếu được đặt.
`getNextSibling()`	`Element`	Truy xuất phần tử phụ tiếp theo của phần tử.
`getParent()`	`ContainerElement`	Truy xuất phần tử mẹ của phần tử.
`getPreviousSibling()`	`Element`	Truy xuất phần tử phụ trước đó của phần tử.
`getType()`	`ElementType`	Truy xuất `ElementType` của phần tử.
`isAtDocumentEnd()`	`Boolean`	Xác định xem phần tử này có nằm ở cuối `Document` hay không.
`merge()`	`Person`	Hợp nhất phần tử với phần tử phụ thuộc cùng một loại trước đó.
`removeFromParent()`	`Person`	Xoá phần tử khỏi phần tử mẹ.
`setAttributes(attributes)`	`Person`	Thiết lập các thuộc tính của phần tử.

Tài liệu chi tiết

`copy()`

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

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

Cầu thủ trả bóng

Person – Bản sao mới.

Ủy quyền

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

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

`getAttributes()`

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

Kết quả là một đối tượng chứa thuộc tính cho mỗi thuộc tính phần tử hợp lệ, trong đó mỗi tên thuộc tính tương ứng với một mục trong bảng liệt kê DocumentApp.Attribute.

var body = DocumentApp.getActiveDocument().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 cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`getEmail()`

Trả về địa chỉ email của người đó.

Cầu thủ trả bóng

String – Địa chỉ email của người đó.

Ủy quyền

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

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

`getName()`

Trả về tên hiển thị của người đó, nếu được đặt.

Cầu thủ trả bóng

String – Tên hiển thị của đường liên kết người dùng hoặc null nếu phần tử này hiển thị địa chỉ email.

Ủy quyền

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

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

`getNextSibling()`

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

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

Cầu thủ trả bóng

Element – Phần tử phụ tiếp theo.

Ủy quyền

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

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

`getParent()`

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

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

Cầu thủ trả bóng

ContainerElement – Phần tử mẹ.

Ủy quyền

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

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

`getPreviousSibling()`

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

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

Cầu thủ trả bóng

Element – Phần tử phụ trước đó.

Ủy quyền

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

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

`getType()`

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

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

var body = DocumentApp.getActiveDocument().getBody();

// Obtain the first element in the document 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 cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`isAtDocumentEnd()`

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

Cầu thủ trả bóng

Boolean – Liệu phần tử có nằm ở cuối tài liệu hay không.

Ủy quyền

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

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

`merge()`

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

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

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

var body = DocumentApp.getActiveDocument().getBody();
// Example 1: Merge paragraphs
// Append two paragraphs to the document.
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

Person — Phần tử đã hợp nhất.

Ủy quyền

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

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

`removeFromParent()`

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

var body = DocumentApp.getActiveDocument().getBody();

// Remove all images in the document body.
var imgs = body.getImages();
for (var i = 0; i < imgs.length; i++) {
  imgs[i].removeFromParent();
}

Cầu thủ trả bóng

Person – Phần tử đã bị xoá.

Ủy quyền

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

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

`setAttributes(attributes)`

Thiết lập các thuộc tính của phần tử.

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

var body = DocumentApp.getActiveDocument().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);

Các tham số

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

Cầu thủ trả bóng

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

Ủy quyền

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

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