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

Class Shape

PageElement đại diện cho một hình dạng chung không có cách phân loại cụ thể hơn. Bao gồm các hộp văn bản, hình chữ nhật và các hình dạng được xác định trước khác.

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
`alignOnPage(alignmentPosition)`	`Shape`	Căn chỉnh phần tử theo vị trí căn chỉnh được chỉ định trên trang.
`bringForward()`	`Shape`	Đưa phần tử trang lên phía trước trên trang bằng một phần tử.
`bringToFront()`	`Shape`	Đưa phần tử trang lên đầu trang.
`duplicate()`	`PageElement`	Sao chép phần tử trang.
`getAutofit()`	`Autofit`	Trả về `Autofit` của văn bản trong hình dạng này.
`getBorder()`	`Border`	Trả về `Border` của hình dạng.
`getConnectionSites()`	`ConnectionSite[]`	Trả về danh sách `ConnectionSite` trên phần tử trang hoặc một danh sách trống nếu phần tử trang không có trang web kết nối nào.
`getContentAlignment()`	`ContentAlignment`	Trả về `ContentAlignment` của văn bản trong hình dạng.
`getDescription()`	`String`	Trả về nội dung mô tả văn bản thay thế của phần tử trang.
`getFill()`	`Fill`	Trả về `Fill` của hình dạng.
`getHeight()`	`Number`	Lấy chiều cao của phần tử theo điểm. Đây là chiều cao hộp giới hạn của phần tử khi phần tử không có chế độ xoay.
`getInherentHeight()`	`Number`	Trả về chiều cao vốn có của phần tử theo điểm.
`getInherentWidth()`	`Number`	Trả về chiều rộng vốn có của phần tử theo điểm.
`getLeft()`	`Number`	Trả về vị trí ngang của phần tử tính theo điểm, được đo từ góc trên bên trái của trang khi phần tử không xoay.
`getLink()`	`Link`	Trả về `Link` hoặc `null` nếu không có đường liên kết.
`getObjectId()`	`String`	Trả về mã nhận dạng duy nhất cho đối tượng này.
`getPageElementType()`	`PageElementType`	Trả về loại của phần tử trang, được biểu thị dưới dạng enum `PageElementType`.
`getParentGroup()`	`Group`	Trả về nhóm chứa phần tử trang này hoặc `null` nếu phần tử không nằm trong một nhóm.
`getParentPage()`	`Page`	Trả về trang có phần tử trang này.
`getParentPlaceholder()`	`PageElement`	Trả về phần tử trang mẹ của phần giữ chỗ.
`getPlaceholderIndex()`	`Integer`	Trả về chỉ mục phần giữ chỗ của hình dạng.
`getPlaceholderType()`	`PlaceholderType`	Trả về loại phần giữ chỗ của hình dạng hoặc `PlaceholderType.NONE` nếu hình dạng đó không phải là phần giữ chỗ.
`getRotation()`	`Number`	Trả về góc xoay theo chiều kim đồng hồ của phần tử quanh tâm của phần tử đó, tính bằng độ, trong đó 0 độ có nghĩa là không xoay.
`getShapeType()`	`ShapeType`	Trả về loại hình dạng.
`getText()`	`TextRange`	Trả về nội dung văn bản của hình dạng.
`getTitle()`	`String`	Trả về tiêu đề văn bản thay thế của phần tử trang.
`getTop()`	`Number`	Lấy vị trí theo chiều dọc của phần tử tính bằng các điểm, được đo từ góc trên bên trái của trang khi phần tử không xoay.
`getTransform()`	`AffineTransform`	Trả về biến đổi của phần tử trang.
`getWidth()`	`Number`	Trả về chiều rộng của phần tử theo điểm. Đây là chiều rộng của hộp giới hạn của phần tử khi phần tử không xoay.
`preconcatenateTransform(transform)`	`Shape`	Liên kết trước phép biến đổi đã cung cấp với phép biến đổi hiện có của phần tử trang.
`remove()`	`void`	Xoá phần tử trang.
`removeLink()`	`void`	Xoá `Link`.
`replaceWithImage(blobSource)`	`Image`	Thay thế hình dạng này bằng hình ảnh do `BlobSource` cung cấp.
`replaceWithImage(blobSource, crop)`	`Image`	Thay thế hình dạng này bằng hình ảnh do `BlobSource` cung cấp.
`replaceWithImage(imageUrl)`	`Image`	Thay thế hình dạng này bằng một hình ảnh.
`replaceWithImage(imageUrl, crop)`	`Image`	Thay thế hình dạng này bằng một hình ảnh.
`replaceWithSheetsChart(sourceChart)`	`SheetsChart`	Thay thế hình này bằng biểu đồ trên Google Trang tính.
`replaceWithSheetsChartAsImage(sourceChart)`	`Image`	Thay thế hình dạng này bằng hình ảnh của biểu đồ trên Google Trang tính.
`scaleHeight(ratio)`	`Shape`	Điều chỉnh chiều cao của phần tử theo tỷ lệ đã chỉ định.
`scaleWidth(ratio)`	`Shape`	Điều chỉnh chiều rộng của phần tử theo tỷ lệ đã chỉ định.
`select()`	`void`	Chỉ chọn `PageElement` trong bản trình bày đang hoạt động và xoá mọi lựa chọn trước đó.
`select(replace)`	`void`	Chọn `PageElement` trong bản trình bày đang hoạt động.
`sendBackward()`	`Shape`	Đưa phần tử trang về phía sau trên trang bằng một phần tử.
`sendToBack()`	`Shape`	Đưa phần tử trang đến cuối trang.
`setContentAlignment(contentAlignment)`	`Shape`	Đặt `ContentAlignment` của văn bản trong hình dạng.
`setDescription(description)`	`Shape`	Đặt nội dung mô tả văn bản thay thế của phần tử trang.
`setHeight(height)`	`Shape`	Đặt chiều cao của phần tử theo điểm. Đây là chiều cao hộp giới hạn của phần tử khi phần tử không có chế độ xoay.
`setLeft(left)`	`Shape`	Đặt vị trí theo chiều ngang của thành phần theo điểm, được đo từ góc trên bên trái của trang khi phần tử không xoay.
`setLinkSlide(slideIndex)`	`Link`	Đặt `Link` thành `Slide` đã cho bằng cách sử dụng chỉ mục gốc 0 của trang trình bày.
`setLinkSlide(slide)`	`Link`	Thiết lập `Link` thành `Slide` cho trước, đường liên kết sẽ được đặt theo mã trang trình bày cho trước.
`setLinkSlide(slidePosition)`	`Link`	Đặt `Link` thành `Slide` đã cho bằng cách sử dụng vị trí tương đối của trang trình bày.
`setLinkUrl(url)`	`Link`	Đặt `Link` thành chuỗi URL không trống đã cho.
`setRotation(angle)`	`Shape`	Đặt góc xoay theo chiều kim đồng hồ của phần tử quanh tâm của phần tử đó theo độ.
`setTitle(title)`	`Shape`	Đặt tiêu đề văn bản thay thế cho phần tử trang.
`setTop(top)`	`Shape`	Đặt vị trí theo chiều dọc của phần tử tính bằng các điểm, được đo từ góc trên bên trái của trang khi phần tử không xoay.
`setTransform(transform)`	`Shape`	Đặt phép biến đổi của phần tử trang bằng phép biến đổi đã cho.
`setWidth(width)`	`Shape`	Đặt chiều rộng của phần tử theo điểm. Đây là chiều rộng của hộp giới hạn của phần tử khi phần tử không có chế độ xoay.

Tài liệu chi tiết

`alignOnPage(alignmentPosition)`

Căn chỉnh phần tử theo vị trí căn chỉnh được chỉ định trên trang.

Các tham số

Tên	Loại	Nội dung mô tả
`alignmentPosition`	`AlignmentPosition`	Vị trí để căn chỉnh phần tử trang này cho phù hợp trên trang.

Cầu thủ trả bóng

Shape – Phần tử trang này để tạo chuỗi.

`bringForward()`

Đưa phần tử trang lên phía trước trên trang bằng một phần tử.

Phần tử trang không được ở trong nhóm.

Cầu thủ trả bóng

Shape – Phần tử trang này để tạo chuỗ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`bringToFront()`

Đưa phần tử trang lên đầu trang.

Phần tử trang không được ở trong nhóm.

Cầu thủ trả bóng

Shape – Phần tử trang này để tạo chuỗ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`duplicate()`

Sao chép phần tử trang.

Phần tử trang trùng lặp được đặt trên cùng một trang tại cùng một vị trí với trang gốc.

Cầu thủ trả bóng

PageElement — Bản sao mới của phần tử trang này.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getAutofit()`

Trả về Autofit của văn bản trong hình dạng này. Đây là null nếu hình dạng không cho phép văn bản.

Cầu thủ trả bóng

Autofit – Tự động điều chỉnh văn bản trong hình dạng này.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getBorder()`

Trả về Border của hình dạng.

Cầu thủ trả bóng

Border – Chế độ cài đặt đường viền của hình này.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getConnectionSites()`

Trả về danh sách ConnectionSite trên phần tử trang hoặc một danh sách trống nếu phần tử trang không có trang web kết nối nào.

Cầu thủ trả bóng

ConnectionSite[] – Danh sách trang web kết nối. Danh sách này có thể trống nếu phần tử này không có trang web kết nố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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getContentAlignment()`

Trả về ContentAlignment của văn bản trong hình dạng.

Cầu thủ trả bóng

ContentAlignment – Căn chỉnh văn bản trong hình này.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getDescription()`

Trả về nội dung mô tả văn bản thay thế của phần tử trang. Nội dung mô tả được kết hợp với tiêu đề để hiển thị và đọc văn bản thay thế.

Cầu thủ trả bóng

String – Nội dung mô tả văn bản thay thế của phần tử trang.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getFill()`

Trả về Fill của hình dạng.

Cầu thủ trả bóng

Fill – Chế độ cài đặt tô màu nền của hình dạng này.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getHeight()`

Lấy chiều cao của phần tử theo điểm. Đây là chiều cao hộp giới hạn của phần tử khi phần tử không có chế độ xoay.

Phương thức này không tương thích với tất cả các phần tử trang. Để tìm hiểu các phần tử trang không tương thích với phương pháp này, hãy tham khảo giới hạn về kích thước và vị trí.

Cầu thủ trả bóng

Number – Chiều cao vốn có của phần tử trang tính theo điểm, hoặc null nếu phần tử trang không có chiều cao.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getInherentHeight()`

Trả về chiều cao vốn có của phần tử theo điểm.

Sự biến đổi của phần tử trang tương ứng với kích thước vốn có của nó. Sử dụng kích thước vốn có kết hợp với sự biến đổi của thành phần để xác định giao diện hình ảnh cuối cùng của thành phần đó.

Cầu thủ trả bóng

Number – Chiều cao vốn có của phần tử trang tính theo điểm, hoặc null nếu phần tử trang không có chiều cao.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getInherentWidth()`

Trả về chiều rộng vốn có của phần tử theo điểm.

Cầu thủ trả bóng

Number – Chiều rộng vốn có của phần tử trang tính theo điểm, hoặc null nếu phần tử trang không có chiều rộ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getLeft()`

Trả về vị trí ngang của phần tử tính theo điểm, được đo từ góc trên bên trái của trang khi phần tử không xoay.

Cầu thủ trả bóng

Number – Vị trí đường chân trời của phần tử này theo các điểm, tính từ góc trên bên trái của trang.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getLink()`

Trả về Link hoặc null nếu không có đường liên kết.

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

Cầu thủ trả bóng

Link

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getObjectId()`

Trả về mã nhận dạng duy nhất cho đối tượng này. Mã đối tượng được các trang và phần tử trang sử dụng có cùng một không gian tên.

Cầu thủ trả bóng

String – Mã nhận dạng duy nhất cho đối tượng này.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPageElementType()`

Trả về loại của phần tử trang, được biểu thị dưới dạng enum PageElementType.

Cầu thủ trả bóng

PageElementType – Loại của phần tử trang.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParentGroup()`

Trả về nhóm chứa phần tử trang này hoặc null nếu phần tử không nằm trong một nhóm.

Cầu thủ trả bóng

Group – Nhóm chứa phần tử trang này, hoặc null.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParentPage()`

Trả về trang có phần tử trang này.

Cầu thủ trả bóng

Page – Trang chứa phần tử này.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParentPlaceholder()`

Trả về phần tử trang mẹ của phần giữ chỗ. Trả về null nếu hình dạng đó không phải là phần giữ chỗ hoặc không có phần giữ chỗ.

Cầu thủ trả bóng

PageElement – Phần tử trang mẹ của phần giữ chỗ cho hình dạng này hoặc null nếu hình dạng này không phải là phần giữ chỗ hoặc không có 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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPlaceholderIndex()`

Trả về chỉ mục phần giữ chỗ của hình dạng. Nếu hai hoặc nhiều thực thể của cùng một loại phần giữ chỗ xuất hiện trên cùng một trang, thì mỗi bản sao sẽ có giá trị chỉ mục riêng. Trả về null nếu hình dạng không phải là một phần giữ chỗ.

Cầu thủ trả bóng

Integer — Chỉ mục phần giữ chỗ của hình dạng này hoặc null nếu hình dạng không phải là một phần giữ chỗ.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPlaceholderType()`

Trả về loại phần giữ chỗ của hình dạng hoặc PlaceholderType.NONE nếu hình dạng đó không phải là phần giữ chỗ.

Cầu thủ trả bóng

PlaceholderType – Loại phần giữ chỗ của hình dạng này.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getRotation()`

Trả về góc xoay theo chiều kim đồng hồ của phần tử quanh tâm của phần tử đó, tính bằng độ, trong đó 0 độ có nghĩa là không xoay.

Cầu thủ trả bóng

Number – Góc xoay tính bằng độ trong khoảng từ 0 (bao gồm) đến 360 (loại trừ).

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getShapeType()`

Trả về loại hình dạng.

Cầu thủ trả bóng

ShapeType – Loại của hình dạng này.

`getText()`

Trả về nội dung văn bản của hình dạng.

Văn bản trong một hình dạng luôn kết thúc bằng một ký tự dòng mới.

Cầu thủ trả bóng

TextRange – Nội dung văn bản của hình này.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getTitle()`

Trả về tiêu đề văn bản thay thế của phần tử trang. Tiêu đề được kết hợp với nội dung mô tả để hiển thị và đọc văn bản thay thế.

Cầu thủ trả bóng

String – Tiêu đề văn bản thay thế của phần tử trang.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getTop()`

Lấy vị trí theo chiều dọc của phần tử tính bằng các điểm, được đo từ góc trên bên trái của trang khi phần tử không xoay.

Cầu thủ trả bóng

Number – Vị trí dọc của phần tử này theo điểm, tính từ góc trên bên trái của trang.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getTransform()`

Trả về biến đổi của phần tử trang.

Giao diện hình ảnh của phần tử trang được xác định bằng biến đổi tuyệt đối của phần tử đó. Để tính toán mức biến đổi tuyệt đối, hãy nối trước phép biến đổi của một phần tử trang với các phép biến đổi của tất cả các nhóm mẹ của phần tử đó. Nếu phần tử trang không nằm trong một nhóm, thì phép biến đổi tuyệt đối của phần tử đó giống với giá trị trong trường này.

Cầu thủ trả bóng

AffineTransform — Biến đổi các phần tử trang.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getWidth()`

Trả về chiều rộng của phần tử theo điểm. Đây là chiều rộng của hộp giới hạn của phần tử khi phần tử không xoay.

Cầu thủ trả bóng

Number – Chiều rộng vốn có của phần tử trang tính theo điểm, hoặc null nếu phần tử trang không có chiều rộ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`preconcatenateTransform(transform)`

Liên kết trước phép biến đổi đã cung cấp với phép biến đổi hiện có của phần tử trang.

newTransform = argument * existingTransform

Ví dụ: để di chuyển một phần tử trang 36 điểm sang trái:

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

Bạn cũng có thể thay thế phép biến đổi của phần tử trang bằng setTransform(transform).

Các tham số

Tên	Loại	Nội dung mô tả
`transform`	`AffineTransform`	Phép biến đổi để nối trước vào phép biến đổi của phần tử trang này.

Cầu thủ trả bóng

Shape – Phần tử trang này để tạo chuỗ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`remove()`

Xoá phần tử trang.

Nếu sau khi xoá, Group chỉ chứa một hoặc không chứa phần tử trang nào, thì nhóm đó cũng sẽ bị xoá.

Nếu bạn xoá phần giữ chỗ PageElement trên bản cái hoặc bố cục, thì mọi phần giữ chỗ kế thừa trống cũng sẽ 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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`removeLink()`

Xoá Link.

shape.removeLink();

`replaceWithImage(blobSource)`

Thay thế hình dạng này bằng hình ảnh do BlobSource cung cấp.

Hình ảnh được tìm nạp từ BlobSource đã cung cấp một lần tại thời điểm chèn và một bản sao được lưu trữ để hiển thị trong bản trình bày. Hình ảnh phải có kích thước nhỏ hơn 50 MB, không được vượt quá 25 megapixel và phải ở định dạng PNG, JPEG hoặc GIF.

Để duy trì tỷ lệ khung hình của hình ảnh, hình ảnh được điều chỉnh theo tỷ lệ và căn giữa tương ứng với kích thước của hình dạng hiện tại.

var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
shape.replaceWithImage(driveImage);

Các tham số

Tên	Loại	Nội dung mô tả
`blobSource`	`BlobSource`	Dữ liệu về hình ảnh.

Cầu thủ trả bóng

Image – Image thay thế hình dạ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replaceWithImage(blobSource, crop)`

Thay thế hình dạng này bằng hình ảnh do BlobSource cung cấp.

Việc chèn hình ảnh sẽ tìm nạp hình ảnh đó từ BlobSource một lần và một bản sao được lưu trữ để hiển thị bên trong bản trình bày. Hình ảnh phải có kích thước nhỏ hơn 50 MB, không được vượt quá 25 megapixel và phải ở định dạng PNG, JPEG hoặc GIF.

var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
// Replace and crop the replaced image.
shape.replaceWithImage(driveImage, true);

Các tham số

Tên	Loại	Nội dung mô tả
`blobSource`	`BlobSource`	Dữ liệu về hình ảnh.
`crop`	`Boolean`	Nếu giá trị là `true`, hãy cắt hình ảnh cho vừa với kích thước của hình dạng hiện tại. Nếu không, hình ảnh sẽ được điều chỉnh theo tỷ lệ và căn giữa.

Cầu thủ trả bóng

Image – Image thay thế hình dạ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replaceWithImage(imageUrl)`

Thay thế hình dạng này bằng một hình ảnh.

Việc chèn hình ảnh sẽ tìm nạp hình ảnh đó từ URL một lần và một bản sao được lưu trữ để hiển thị bên trong bản trình bày. Hình ảnh phải có kích thước nhỏ hơn 50 MB, không được vượt quá 25 megapixel và phải ở định dạng PNG, JPEG hoặc GIF.

URL được cung cấp phải truy cập được công khai và không lớn hơn 2kB. Bản thân URL được lưu cùng với hình ảnh và hiển thị thông qua Image.getSourceUrl().

Để duy trì tỷ lệ khung hình của hình ảnh, hình ảnh được điều chỉnh theo tỷ lệ và căn giữa tương ứng với kích thước của hình dạng hiện tại.

Các tham số

Tên	Loại	Nội dung mô tả
`imageUrl`	`String`	URL của hình ảnh để tải hình ảnh xuống.

Cầu thủ trả bóng

Image – Image thay thế hình dạ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replaceWithImage(imageUrl, crop)`

Thay thế hình dạng này bằng một hình ảnh.

URL đã cung cấp không được lớn hơn 2kB. Bản thân URL được lưu cùng với hình ảnh và hiển thị qua Image.getSourceUrl().

Các tham số

Tên	Loại	Nội dung mô tả
`imageUrl`	`String`	URL của hình ảnh để tải hình ảnh xuống.
`crop`	`Boolean`	Nếu giá trị là `true`, hãy cắt hình ảnh cho vừa với kích thước của hình dạng hiện tại. Nếu không, hình ảnh sẽ được điều chỉnh theo tỷ lệ và căn giữa.

Cầu thủ trả bóng

Image – Image thay thế hình dạ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replaceWithSheetsChart(sourceChart)`

Thay thế hình này bằng biểu đồ trên Google Trang tính.

Biểu đồ này được liên kết với biểu đồ nguồn trên Google Trang tính để có thể cập nhật biểu đồ. Các cộng tác viên khác có thể thấy đường liên kết đến bảng tính nguồn.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChart(chart);

Các tham số

Tên	Loại	Nội dung mô tả
`sourceChart`	`EmbeddedChart`	Biểu đồ trong bảng tính thay thế hình dạng.

Cầu thủ trả bóng

SheetsChart – Biểu đồ thay thế hình dạ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replaceWithSheetsChartAsImage(sourceChart)`

Thay thế hình dạng này bằng hình ảnh của biểu đồ trên Google Trang tính.

Để duy trì tỷ lệ khung hình của biểu đồ trên Google Trang tính, hình ảnh biểu đồ được điều chỉnh theo tỷ lệ và căn giữa so với kích thước của hình dạng hiện có.

Hình ảnh của biểu đồ không được liên kết với biểu đồ nguồn trên Google Trang tính.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChartAsImage(chart);

Các tham số

Tên	Loại	Nội dung mô tả
`sourceChart`	`EmbeddedChart`	Biểu đồ trong bảng tính thay thế hình dạng.

Cầu thủ trả bóng

Image – Hình ảnh của biểu đồ thay thế hình dạ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`scaleHeight(ratio)`

Điều chỉnh chiều cao của phần tử theo tỷ lệ đã chỉ định. Chiều cao của phần tử là chiều cao của hộp giới hạn khi phần tử không có chế độ xoay.

Các tham số

Tên	Loại	Nội dung mô tả
`ratio`	`Number`	Tỷ lệ để điều chỉnh chiều cao của phần tử trang này theo tỷ lệ.

Cầu thủ trả bóng

Shape – Phần tử trang này để tạo chuỗ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`scaleWidth(ratio)`

Điều chỉnh chiều rộng của phần tử theo tỷ lệ đã chỉ định. Chiều rộng của phần tử là chiều rộng của hộp giới hạn khi phần tử không có chế độ xoay.

Các tham số

Tên	Loại	Nội dung mô tả
`ratio`	`Number`	Tỷ lệ để điều chỉnh tỷ lệ chiều rộng của phần tử trang này theo tỷ lệ.

Cầu thủ trả bóng

Shape – Phần tử trang này để tạo chuỗ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`select()`

Chỉ chọn PageElement trong bản trình bày đang hoạt động và xoá mọi lựa chọn trước đó. Thao tác này cũng giống như việc gọi select(replace) bằng true.

Một tập lệnh chỉ có thể truy cập vào lựa chọn của người dùng đang chạy tập lệnh và chỉ khi tập lệnh được liên kết với bản trình bày.

Thao tác này sẽ thiết lập Page mẹ của PageElement thành current page selection.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`select(replace)`

Chọn PageElement trong bản trình bày đang hoạt động.

Một tập lệnh chỉ có thể truy cập vào lựa chọn của người dùng đang chạy tập lệnh và chỉ khi tập lệnh được liên kết với bản trình bày.

Truyền true vào phương thức này để chỉ chọn PageElement và xoá mọi lựa chọn trước đó. Thao tác này cũng đặt Page mẹ của PageElement thành current page selection.

Truyền false để chọn nhiều đối tượng PageElement. Các đối tượng PageElement phải ở trong cùng một Page.

Bạn phải đáp ứng các điều kiện sau khi chọn một phần tử trang bằng tham số false:

Page mẹ của đối tượng PageElement phải là current page selection.
Không được có nhiều đối tượng Page được chọn.

Để đảm bảo trường hợp này, phương pháp ưu tiên là chọn thành phần mẹ Page trước bằng cách sử dụng Page.selectAsCurrentPage(), sau đó chọn các phần tử trang trên trang đó.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
var pageElements = slide.getPageElements();
for (var i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

Các tham số

Tên	Loại	Nội dung mô tả
`replace`	`Boolean`	Nếu là `true`, lựa chọn này sẽ thay thế mọi lựa chọn trước đó; nếu không, lựa chọn sẽ được thêm vào bất kỳ lựa chọn nào 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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`sendBackward()`

Đưa phần tử trang về phía sau trên trang bằng một phần tử.

Phần tử trang không được ở trong nhóm.

Cầu thủ trả bóng

Shape – Phần tử trang này để tạo chuỗ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`sendToBack()`

Đưa phần tử trang đến cuối trang.

Phần tử trang không được ở trong nhóm.

Cầu thủ trả bóng

Shape – Phần tử trang này để tạo chuỗ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setContentAlignment(contentAlignment)`

Đặt ContentAlignment của văn bản trong hình dạng.

Phương thức này tự động huỷ kích hoạt các thuộc tính tự động điều chỉnh văn bản trên hình dạng đã cập nhật.

Các tham số

Tên	Loại	Nội dung mô tả
`contentAlignment`	`ContentAlignment`	Căn chỉnh để đặt.

Cầu thủ trả bóng

Shape – Hình dạng này để tạo chuỗ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setDescription(description)`

Đặt nội dung mô tả văn bản thay thế của phần tử trang.

Phương thức này không được hỗ trợ cho các phần tử Group.

// Set the first page element's alt text description to "new alt text description".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

Các tham số

Tên	Loại	Nội dung mô tả
`description`	`String`	Chuỗi cần đặt nội dung mô tả văn bản thay thế.

Cầu thủ trả bóng

Shape – Phần tử trang này.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setHeight(height)`

Đặt chiều cao của phần tử theo điểm. Đây là chiều cao hộp giới hạn của phần tử khi phần tử không có chế độ xoay.

Các tham số

Tên	Loại	Nội dung mô tả
`height`	`Number`	Chiều cao mới của phần tử trang này để đặt, tính bằng điểm.

Cầu thủ trả bóng

Shape – Phần tử trang này để tạo chuỗ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLeft(left)`

Đặt vị trí theo chiều ngang của thành phần theo điểm, được đo từ góc trên bên trái của trang khi phần tử không xoay.

Các tham số

Tên	Loại	Nội dung mô tả
`left`	`Number`	Vị trí ngang mới để đặt, tính theo điểm.

Cầu thủ trả bóng

Shape – Phần tử trang này để tạo chuỗ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkSlide(slideIndex)`

Đặt Link thành Slide đã cho bằng cách sử dụng chỉ mục gốc 0 của trang trình bày.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(0);

Các tham số

Tên	Loại	Nội dung mô tả
`slideIndex`	`Integer`	Chỉ mục dựa trên 0 cho trang trình bày.

Cầu thủ trả bóng

Link – Link đã được đặ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkSlide(slide)`

Thiết lập Link thành Slide cho trước, đường liên kết sẽ được đặt theo mã trang trình bày cho trước.

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

Các tham số

Tên	Loại	Nội dung mô tả
`slide`	`Slide`	`Slide` cần liên kết.

Cầu thủ trả bóng

Link – Link đã được đặ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkSlide(slidePosition)`

Đặt Link thành Slide đã cho bằng cách sử dụng vị trí tương đối của trang trình bày.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

Các tham số

Tên	Loại	Nội dung mô tả
`slidePosition`	`SlidePosition`	`SlidePosition` tương đối.

Cầu thủ trả bóng

Link – Link đã được đặ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkUrl(url)`

Đặt Link thành chuỗi URL không trống đã cho.

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

Các tham số

Tên	Loại	Nội dung mô tả
`url`	`String`	Chuỗi URL.

Cầu thủ trả bóng

Link – Link đã được đặ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setRotation(angle)`

Đặt góc xoay theo chiều kim đồng hồ của phần tử quanh tâm của phần tử đó theo độ.

Các tham số

Tên	Loại	Nội dung mô tả
`angle`	`Number`	Góc xoay mới theo chiều kim đồng hồ để đặt, tính bằng độ.

Cầu thủ trả bóng

Shape – Phần tử trang này để tạo chuỗ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setTitle(title)`

Đặt tiêu đề văn bản thay thế cho phần tử trang.

Phương thức này không được hỗ trợ cho các phần tử Group.

// Set the first page element's alt text title to "new alt text title".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Các tham số

Tên	Loại	Nội dung mô tả
`title`	`String`	Chuỗi cần đặt tiêu đề của văn bản thay thế.

Cầu thủ trả bóng

Shape – Phần tử trang này.

Ủ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setTop(top)`

Đặt vị trí theo chiều dọc của phần tử tính bằng các điểm, được đo từ góc trên bên trái của trang khi phần tử không xoay.

Các tham số

Tên	Loại	Nội dung mô tả
`top`	`Number`	Vị trí dọc mới để đặt, tính theo điểm.

Cầu thủ trả bóng

Shape – Phần tử trang này để tạo chuỗ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setTransform(transform)`

Đặt phép biến đổi của phần tử trang bằng phép biến đổi đã cho.

Việc cập nhật sự biến đổi của một nhóm sẽ làm thay đổi sự biến đổi tuyệt đối của các phần tử trang trong nhóm đó. Điều này có thể làm thay đổi giao diện của các phần tử đó.

Việc cập nhật sự biến đổi của một phần tử trang trong một nhóm chỉ làm thay đổi sự biến đổi của phần tử trang đó chứ không ảnh hưởng đến sự biến đổi của nhóm hoặc các phần tử trang khác trong nhóm đó.

Để biết thông tin chi tiết về tác động của việc biến đổi đối với giao diện trực quan của các phần tử trang, hãy xem getTransform().

Các tham số

Tên	Loại	Nội dung mô tả
`transform`	`AffineTransform`	Phép biến đổi được đặt cho phần tử trang này.

Cầu thủ trả bóng

Shape – Phần tử này để tạo chuỗ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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setWidth(width)`

Đặt chiều rộng của phần tử theo điểm. Đây là chiều rộng của hộp giới hạn của phần tử khi phần tử không có chế độ xoay.

Các tham số

Tên	Loại	Nội dung mô tả
`width`	`Number`	Chiều rộng mới của phần tử trang này để đặt, tính theo điểm.

Cầu thủ trả bóng

Shape – Phần tử trang này để tạo chuỗ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/presentations.currentonly
https://www.googleapis.com/auth/presentations