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 | Loại 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 đã chỉ định trên trang. |
bringForward() | Shape | Đưa phần tử trang lên 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 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ử tính bằng điểm. Đây là chiều cao của hộp giới hạn của phần tử khi phần tử không xoay. |
getInherentHeight() | Number | Trả về chiều cao vốn có của phần tử tính bằng điểm. |
getInherentWidth() | Number | Trả về chiều rộng vốn có của phần tử tính bằng điểm. |
getLeft() | Number | Trả về vị trí ngang 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. |
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 của đối tượng này. |
getPageElementType() | PageElementType | Trả về loại phần tử trang, được biểu thị dưới dạng enum PageElementType . |
getParentGroup() | Group | Trả về nhóm mà phần tử trang này thuộc về hoặc null nếu phần tử không nằm trong nhóm. |
getParentPage() | Page | Trả về trang có phần tử trang này. |
getParentPlaceholder() | PageElement | Trả về phần tử trang gốc 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ử xung quanh tâm của phần tử theo độ, trong đó 0 độ có nghĩa là không xoay. |
getShapeType() | ShapeType | Trả về loại của 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í 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ử tính bằng điểm, 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 biến đổi được cung cấp với biến đổi hiện có của phần tử trang. |
remove() | void | Xoá phần tử trang. |
removeLink() | void | Xoá một 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 này bằng một hình ảnh. |
replaceWithImage(imageUrl, crop) | Image | Thay thế hình 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 này bằng hình ảnh của một 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ệ được chỉ định. |
scaleWidth(ratio) | Shape | Điều chỉnh chiều rộng của phần tử theo tỷ lệ được 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 lùi lại trang bằng một phần tử. |
sendToBack() | Shape | Đưa phần tử trang ra sau trang. |
setContentAlignment(contentAlignment) | Shape | Thiết lập ContentAlignment của văn bản trong hình dạng. |
setDescription(description) | Shape | Thiết lập nội dung mô tả văn bản thay thế của phần tử trang. |
setHeight(height) | Shape | Thiết lập chiều cao của phần tử tính theo điểm, là chiều cao của hộp giới hạn của phần tử khi phần tử không xoay. |
setLeft(left) | Shape | Đặt vị trí theo chiều ngang 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. |
setLinkSlide(slideIndex) | Link | Đặt một Link thành Slide cho sẵn bằng cách sử dụng chỉ mục từ 0 của trang trình bày. |
setLinkSlide(slide) | Link | Đặt Link thành Slide cho sẵn. Đường liên kết sẽ do mã trang trình bày cụ thể đặt. |
setLinkSlide(slidePosition) | Link | Đặt Link thành Slide cho sẵn 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ử xung quanh tâm của phần tử theo độ. |
setTitle(title) | Shape | Đặt tiêu đề văn bản thay thế của 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 biến đổi của phần tử trang bằng biến đổi được cung cấp. |
setWidth(width) | Shape | Thiết lập chiều rộng của phần tử tính bằng điểm, tức 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. |
Tài liệu chi tiết
alignOnPage(alignmentPosition)
Căn chỉnh phần tử theo vị trí căn chỉnh đã chỉ định trên trang.
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 khớ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 trước trên trang bằng một phần tử.
Phần tử trang không được nằm trong một 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 yêu cầu ủy 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 nằm trong một 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 yêu cầu ủy 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 ở cùng vị trí với phần tử 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 yêu cầu ủy 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 yêu cầu ủy 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()
getConnectionSites()
Trả về danh sách ConnectionSite
trên phần tử trang hoặc 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, có thể bị 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 yêu cầu ủy 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 dạng 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/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ả 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ả dạng 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 yêu cầu ủy 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()
getHeight()
Lấy chiều cao của phần tử tính bằng điểm. Đây là chiều cao của hộp giới hạn của phần tử khi phần tử không 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 phần tử trang nào không tương thích với phương thức này, hãy tham khảo các giới hạn về kích thước và xác định vị trí.
Cầu thủ trả bóng
Number
– Chiều cao vốn có của phần tử trang tính bằng đ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 yêu cầu ủy 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ử tính bằng điểm.
Biến đổi của phần tử trang có liên quan đến kích thước vốn có của nó. Sử dụng kích thước vốn có khi kết hợp với phép biến đổi của phần tử để xác định giao diện hình ảnh cuối cùng của phần tử.
Cầu thủ trả bóng
Number
– Chiều cao vốn có của phần tử trang tính bằng đ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 yêu cầu ủy 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ử tính bằng điểm.
Biến đổi của phần tử trang có liên quan đến kích thước vốn có của nó. Sử dụng kích thước vốn có khi kết hợp với phép biến đổi của phần tử để xác định giao diện hình ảnh cuối cùng của phần tử.
Cầu thủ trả bóng
Number
– Chiều rộng vốn có của phần tử trang tính bằng đ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 yêu cầu ủy 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 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í ngang của phần tử này tính theo điểm, 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 yêu cầu ủy 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
Ủ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/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getObjectId()
Trả về mã nhận dạng duy nhất của đối tượng này. Mã đối tượng mà các trang và phần tử trang sử dụng sẽ 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 của đối tượng 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/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementType()
Trả về loại phần tử trang, được biểu thị dưới dạng enum PageElementType
.
Cầu thủ trả bóng
PageElementType
— Loại phần tử trang.
Ủ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/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentGroup()
Trả về nhóm mà phần tử trang này thuộc về hoặc null
nếu phần tử không nằm trong 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 yêu cầu ủy 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()
getParentPlaceholder()
Trả về phần tử trang gốc 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 tử mẹ.
Cầu thủ trả bóng
PageElement
– Phần tử trang gốc của phần giữ chỗ 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 yêu cầu ủy 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 phiên bản 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 phiên bản sẽ có giá trị chỉ mục riêng. Trả về null
nếu hình dạng không phải là 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à phần giữ chỗ.
Ủ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/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ỗ cho hình dạng 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/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ử xung quanh tâm của phần tử theo độ, trong đó 0 độ có nghĩa là không xoay.
Cầu thủ trả bóng
Number
– Góc xoay theo độ trong khoảng từ 0 (bao gồm) đến 360 (không bao gồ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/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getShapeType()
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 dạng 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/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 yêu cầu ủy 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í 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 tính theo điểm, 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 yêu cầu ủy 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 trực quan của phần tử trang được xác định bởi biến đổi tuyệt đối của phần tử đó. Để tính toán độ biến đổi tuyệt đối, hãy liên kết 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ì biến đổi tuyệt đối của phần tử đó sẽ giống với giá trị trong trường này.
Cầu thủ trả bóng
AffineTransform
— Biến đổi của phần tử trang.
Ủ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/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getWidth()
Trả về chiều rộng của phần tử tính bằng điểm, 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.
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 phần tử trang nào không tương thích với phương thức này, hãy tham khảo các giới hạn về kích thước và xác định vị trí.
Cầu thủ trả bóng
Number
– Chiều rộng vốn có của phần tử trang tính bằng đ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 yêu cầu ủy 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 biến đổi được cung cấp với biến đổi hiện có của phần tử trang.
newTransform = argument * existingTransform
Ví dụ: để di chuyển 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ế biến đổi của phần tử trang bằng setTransform(transform)
.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
transform | AffineTransform | Biến đổi để liên kết trước trên 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 yêu cầu ủy 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 thao tác 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 phần giữ chỗ PageElement
bị xoá trên một chính 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 yêu cầu ủy 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á một 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
được cung cấp một lần tại thời điểm chèn và một bản sao sẽ đượ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 dưới 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 sẽ được điều chỉnh theo tỷ lệ và căn giữa theo kích thước của hình dạng hiện có.
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);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
blobSource | BlobSource | Dữ liệu 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 yêu cầu ủy 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, sau đó một bản sao sẽ đượ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 dưới 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);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
blobSource | BlobSource | Dữ liệu hình ảnh. |
crop | Boolean | Nếu 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 có. 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 yêu cầu ủy 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 này bằng một hình ảnh.
Thao tác chèn hình ảnh sẽ tìm nạp hình ảnh từ URL một lần, sau đó một bản sao sẽ đượ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 dưới 50 MB, không được vượt quá 25 megapixel và phải ở định dạng PNG, JPEG hoặc GIF.
URL đã cung cấp phải truy cập được công khai và có kích thước không lớn hơn 2kB. 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 sẽ được điều chỉnh theo tỷ lệ và căn giữa theo kích thước của hình dạng hiện 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 yêu cầu ủy 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 này bằng một hình ảnh.
Thao tác chèn hình ảnh sẽ tìm nạp hình ảnh từ URL một lần, sau đó một bản sao sẽ đượ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 dưới 50 MB, không được vượt quá 25 megapixel và phải ở định dạng PNG, JPEG hoặc GIF.
URL đã cung cấp không được lớn hơn 2kB. URL đó được lưu cùng với hình ảnh và hiển thị thông qua Image.getSourceUrl()
.
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 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 có. 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 yêu cầu ủy 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 đồ được liên kết với biểu đồ nguồn trên Google Trang tính cho phép 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);
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 yêu cầu ủy 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 này bằng hình ảnh của một 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 theo 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);
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 yêu cầu ủy 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ệ được 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 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 phần tử trang nào không tương thích với phương thức này, hãy tham khảo các giới hạn về kích thước và xác định vị trí.
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 yêu cầu ủy 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ệ được 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 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 phần tử trang nào không tương thích với phương thức này, hãy tham khảo các giới hạn về kích thước và xác định vị trí.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
ratio | Number | Tỷ lệ điều chỉnh 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 yêu cầu ủy 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 đó. Việc này cũng giống như việc gọi select(replace)
bằng true
.
Tập lệnh chỉ có thể truy cập vào lựa chọn người dùng đang chạy tập lệnh và chỉ khi tập lệnh bị ràng buộc với bản trình bày.
Thao tác này sẽ thiết lập phần tử mẹ Page
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 yêu cầu ủy 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.
Tập lệnh chỉ có thể truy cập vào lựa chọn người dùng đang chạy tập lệnh và chỉ khi tập lệnh bị ràng buộc 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ượngPageElement
phải làcurrent page selection
.- Bạn không được chọn nhiều đối tượng
Page
.
Để đảm bảo trường hợp này xảy ra, phương pháp ưu tiên là chọn Page
mẹ trước bằng cách sử dụng Page.selectAsCurrentPage()
, sau đó chọn các phần tử trang trong 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); }
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
replace | Boolean | Nếu là true , lựa chọn trước đó 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 mọi lựa chọn 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/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendBackward()
Đưa phần tử trang lùi lại trang bằng một phần tử.
Phần tử trang không được nằm trong một 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 yêu cầu ủy 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 ra sau trang.
Phần tử trang không được nằm trong một 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 yêu cầu ủy 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)
Thiết lập ContentAlignment
của văn bản trong hình dạng.
Phương thức này sẽ 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 các hình dạng đã cập nhật.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
contentAlignment | ContentAlignment | Căn chỉnh cần đặ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 yêu cầu ủy 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)
Thiết lập 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());
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
description | String | Chuỗi để đặ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 yêu cầu ủy 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)
Thiết lập chiều cao của phần tử tính theo điểm, là chiều cao của hộp giới hạn của phần tử khi phần tử không 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 phần tử trang nào không tương thích với phương thức này, hãy tham khảo các giới hạn về kích thước và xác định vị trí.
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 yêu cầu ủy 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 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.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
left | Number | Vị trí ngang mới để đặ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 yêu cầu ủy 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 một Link
thành Slide
cho sẵn bằng cách sử dụng chỉ mục từ 0 của trang trình bày.
// Set a link to the first slide of the presentation. shape.setLinkSlide(0);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
slideIndex | Integer | Chỉ mục gốc 0 cho trang trình bày. |
Cầu thủ trả bó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/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slide)
Đặt Link
thành Slide
cho sẵn. Đường liên kết sẽ do mã trang trình bày cụ thể đặt.
// Set a link to the first slide of the presentation. var slide = presentation.getSlides()[0]; shape.setLinkSlide(slide);
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
Ủ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/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slidePosition)
Đặt Link
thành Slide
cho sẵn 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);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
slidePosition | SlidePosition | SlidePosition tương đối. |
Cầu thủ trả bó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/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");
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
url | String | Chuỗi URL. |
Cầu thủ trả bó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/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ử xung quanh tâm của phần tử theo độ.
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 phần tử trang nào không tương thích với phương thức này, hãy tham khảo các giới hạn về kích thước và xác định vị trí.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
angle | Number | Góc xoay theo chiều kim đồng hồ mới để đặ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 yêu cầu ủy 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ế 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 title to "new alt text title". var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setTitle('new alt text title'); Logger.log(pageElement.getTitle());
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
title | String | Chuỗi để đặt tiêu đề 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 yêu cầu ủy 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.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
top | Number | Vị trí dọc mới để đặ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 yêu cầu ủy 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 biến đổi của phần tử trang bằng biến đổi được cung cấp.
Việc cập nhật 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ể thay đổi giao diện trực quan của các phần tử đó.
Việc cập nhật biến đổi của một phần tử trang nằm trong nhóm chỉ 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 chi tiết về cách biến đổi tác động đến giao diện trực quan của các phần tử trang, hãy xem getTransform()
.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
transform | AffineTransform | 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 yêu cầu ủy 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)
Thiết lập chiều rộng của phần tử tính bằng điểm, tức 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.
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 phần tử trang nào không tương thích với phương thức này, hãy tham khảo các giới hạn về kích thước và xác định vị trí.
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 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 yêu cầu ủy 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