PageElement
đại diện cho một dòng.
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
alignOnPage(alignmentPosition) | Line | Căn chỉnh phần tử với vị trí căn chỉnh được chỉ định trên trang. |
bringForward() | Line | Chuyển phần tử trang về phía trước trên trang một phần tử. |
bringToFront() | Line | Đưa phần tử trang lên đầu trang. |
duplicate() | PageElement | Sao chép phần tử trang. |
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. |
getDashStyle() | DashStyle | Lấy DashStyle của dòng này. |
getDescription() | String | Trả về nội dung mô tả văn bản thay thế của phần tử trang. |
getEnd() | Point | Trả về điểm cuối của đường, được đo từ góc trên bên trái của trang. |
getEndArrow() | ArrowStyle | Lấy ArrowStyle của mũi tên ở cuối dòng. |
getEndConnection() | ConnectionSite | Trả về kết nối ở cuối dòng hoặc null nếu không có kết nối. |
getHeight() | Number | Lấy chiều cao của phần tử theo điểm, tức 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ử theo điểm, được đo từ góc trên bên trái của trang khi phần tử không xoay. |
getLineCategory() | LineCategory | Lấy LineCategory của dòng này. |
getLineFill() | LineFill | Lấy LineFill của dòng. |
getLineType() | LineType | Lấy LineType của dòng. |
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 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 thuộc một nhóm. |
getParentPage() | Page | Trả về trang chứa phần tử trang này. |
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 độ nghĩa là không xoay. |
getStart() | Point | Trả về điểm bắt đầu của đường thẳng, được đo từ góc trên bên trái của trang. |
getStartArrow() | ArrowStyle | Lấy ArrowStyle của mũi tên ở đầu dòng. |
getStartConnection() | ConnectionSite | Trả về kết nối ở đầu dòng hoặc null nếu không có kết nối. |
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ử theo điểm, đo từ góc trên bên trái của trang khi phần tử không xoay. |
getTransform() | AffineTransform | Trả về phép biến đổi của phần tử trang. |
getWeight() | Number | Trả về độ dày của đường kẻ tính bằng điểm. |
getWidth() | Number | Trả về 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. |
isConnector() | Boolean | Trả về true nếu dòng là một đầu nối hoặc false nếu không phải. |
preconcatenateTransform(transform) | Line | Kết hợp trước phép biến đổi được 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 . |
reroute() | Line | Định tuyến lại điểm bắt đầu và điểm cuối của đường đến hai điểm kết nối gần nhất trên các thành phần trang đã kết nối. |
scaleHeight(ratio) | Line | Điều chỉnh tỷ lệ chiều cao của phần tử theo tỷ lệ đã chỉ định. |
scaleWidth(ratio) | Line | Điều chỉnh tỷ lệ 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() | Line | Chuyển phần tử trang lùi lại một phần tử trên trang. |
sendToBack() | Line | Chuyển phần tử trang về cuối trang. |
setDashStyle(style) | Line | Đặt DashStyle của đường này. |
setDescription(description) | Line | Đặt nội dung mô tả văn bản thay thế của phần tử trang. |
setEnd(left, top) | Line | Đặt vị trí của điểm cuối của đường thẳng. |
setEnd(point) | Line | Đặt vị trí của điểm cuối của đường thẳng. |
setEndArrow(style) | Line | Đặt ArrowStyle của mũi tên ở cuối dòng. |
setEndConnection(connectionSite) | Line | Đặt kết nối ở cuối dòng. |
setHeight(height) | Line | Đặt chiều cao của phần tử theo điểm, tức 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) | Line | Đặt vị trí ngang của phần tử theo điểm, được đo từ góc trên bên trái của trang khi phần tử không xoay. |
setLineCategory(lineCategory) | Line | Đặt LineCategory của đường này. |
setLinkSlide(slideIndex) | Link | Đặt Link thành Slide đã cho bằng cách sử dụng chỉ mục dựa trên 0 của trang trình bày. |
setLinkSlide(slide) | Link | Đặt Link thành Slide đã cho, đường liên kết được đặt theo mã nhận dạng trang trình bày đã cho. |
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) | Line | Đặt góc xoay theo chiều kim đồng hồ của phần tử xung quanh tâm theo độ. |
setStart(left, top) | Line | Đặt vị trí của điểm bắt đầu của đường thẳng. |
setStart(point) | Line | Đặt vị trí của điểm bắt đầu của đường thẳng. |
setStartArrow(style) | Line | Đặt ArrowStyle của mũi tên ở đầu dòng. |
setStartConnection(connectionSite) | Line | Thiết lập kết nối ở đầu dòng. |
setTitle(title) | Line | Đặt tiêu đề văn bản thay thế của phần tử trang. |
setTop(top) | Line | Đặt vị trí dọc của phần tử theo điểm, đo từ góc trên bên trái của trang khi phần tử không xoay. |
setTransform(transform) | Line | Đặt phép biến đổi của phần tử trang bằng phép biến đổi được cung cấp. |
setWeight(points) | Line | Đặt độ dày của đường bằng điểm. |
setWidth(width) | Line | Đặt chiều rộng của phần tử theo đ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ử với vị trí căn chỉnh được chỉ định trên trang.
Tham số
Tên | Loại | Mô tả |
---|---|---|
alignmentPosition | AlignmentPosition | Vị trí để căn chỉnh phần tử trang này trên trang. |
Cầu thủ trả bóng
Line
– Phần tử trang này, để tạo chuỗi.
bringForward()
Chuyển phần tử trang về phía trước trên trang 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
Line
– Phần tử trang này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 nằm trong một nhóm.
Cầu thủ trả bóng
Line
– Phần tử trang này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 ở cùng vị trí với phần tử gốc.
Cầu thủ trả bóng
PageElement
– Phần tử trùng lặp mới của phần tử trang này.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 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
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
getDashStyle()
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
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
getEnd()
Trả về điểm cuối của đường, được đo từ góc trên bên trái của trang.
Cầu thủ trả bóng
Point
– Điểm cuối của đường thẳng.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
getEndArrow()
Lấy ArrowStyle
của mũi tên ở cuối dòng.
Cầu thủ trả bóng
ArrowStyle
– Kiểu của mũi tên ở cuối dòng này.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
getEndConnection()
Trả về kết nối ở cuối dòng hoặc null
nếu không có kết nối.
Cầu thủ trả bóng
ConnectionSite
– Kết nối ở cuối dòng.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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, tức 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ử trên trang. Để tìm hiểu những phần tử trang 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à 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
Các tập lệnh sử dụng phương thức này yêu cầu đượ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ử tính bằng điểm.
Biến đổi của phần tử trang tương ứng với kích thước vốn có của phần tử đó. Sử dụng kích thước vốn có cùng 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
Các tập lệnh sử dụng phương thức này yêu cầu đượ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ử tính bằng điểm.
Biến đổi của phần tử trang tương ứng với kích thước vốn có của phần tử đó. Sử dụng kích thước vốn có cùng 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 theo điểm hoặc null
nếu phần tử trang không có chiều rộng.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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ử 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í theo chiều ngang của phần tử này tính bằng điểm, từ góc trên bên trái của trang.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
getLineCategory()
Lấy LineCategory
của dòng này.
Cầu thủ trả bóng
LineCategory
– Danh mục đường.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
getLineFill()
getLineType()
getLink()
Trả về Link
hoặc null
nếu không có đường liên kết.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; const link = shape.getLink(); if (link != null) { Logger.log(`Shape has a link of type: ${link.getLinkType()}`); }
Cầu thủ trả bóng
Link
– Link
hoặc null
nếu không có đường liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 mà các trang và thành phần 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
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 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
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 mà phần tử trang này thuộc về hoặc null
nếu phần tử không thuộc một nhóm.
Cầu thủ trả bóng
Group
– Nhóm mà phần tử trang này thuộc về hoặc null
.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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()
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 độ nghĩa là không xoay.
Cầu thủ trả bóng
Number
– Góc xoay tính bằng độ từ 0 (bao gồm) đến 360 (không bao gồm).
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
getStart()
Trả về điểm bắt đầu của đường thẳng, được đo từ góc trên bên trái của trang.
Cầu thủ trả bóng
Point
– Điểm bắt đầu của đường thẳng.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
getStartArrow()
Lấy ArrowStyle
của mũi tên ở đầu dòng.
Cầu thủ trả bóng
ArrowStyle
– Kiểu của mũi tên ở đầu dòng này.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
getStartConnection()
Trả về kết nối ở đầu dòng hoặc null
nếu không có kết nối.
Cầu thủ trả bóng
ConnectionSite
– Kết nối ở đầu dòng.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
Các tập lệnh sử dụng phương thức này yêu cầu đượ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í dọc của phần tử theo điểm, đ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 bằng điểm, từ góc trên bên trái của trang.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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ề phép biến đổi của phần tử trang.
Hình thức hiển thị của phần tử trang được xác định bằng phép biến đổi tuyệt đối của phần tử đó. Để tính toán phép 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 phép biến đổi của tất cả các nhóm mẹ. 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ử đó 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
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
getWeight()
Trả về độ dày của đường kẻ tính bằng điểm.
Cầu thủ trả bóng
Number
– Độ dày của đường thẳng tính bằng điểm.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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ử 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ử trên trang. Để tìm hiểu những phần tử trang 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à vị trí.
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
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
isConnector()
Trả về true
nếu dòng là một đầu nối hoặc false
nếu không phải.
Đường kết nối là một loại đường dùng để kết nối các điểm kết nối trên các phần tử trang có liên quan. Mỗi đầu của đầu nối có thể kết nối với tối đa một điểm kết nối.
Cầu thủ trả bóng
Boolean
– True
nếu dòng là một trình kết nối hoặc false
nếu không phải.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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)
Kết hợp trước phép biến đổi được 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:
const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; 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)
.
Tham số
Tên | Loại | Mô tả |
---|---|---|
transform | AffineTransform | Biến đổi để nối trước vào biến đổi của phần tử trang này. |
Cầu thủ trả bóng
Line
– Phần tử trang này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 một thao tác xoá, Group
chỉ chứa một hoặc không có phần tử trang nào, thì chính nhóm đó cũng sẽ bị xoá.
Nếu bạn xoá một phần giữ chỗ PageElement
trên một bố cục hoặc bố cục chính, thì mọi phần giữ chỗ kế thừa trống cũng sẽ bị xoá.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
.
const slides = SlidesApp.getActivePresentation().getSlides(); slides[1].getShapes()[0].removeLink();
reroute()
Định tuyến lại điểm bắt đầu và điểm cuối của đường đến hai điểm kết nối gần nhất trên các thành phần trang đã kết nối. Điểm bắt đầu và điểm cuối của đường kẻ phải được kết nối với các phần tử trang khác nhau.
Cầu thủ trả bóng
Line
– Đường.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 tỷ lệ 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ó độ xoay.
Phương thức này không tương thích với tất cả các phần tử trên trang. Để tìm hiểu những phần tử trang 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à vị trí.
Tham số
Tên | Loại | Mô tả |
---|---|---|
ratio | Number | Tỷ lệ để điều chỉnh chiều cao của phần tử trang này. |
Cầu thủ trả bóng
Line
– Phần tử trang này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 tỷ lệ 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ó độ xoay.
Phương thức này không tương thích với tất cả các phần tử trên trang. Để tìm hiểu những phần tử trang 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à vị trí.
Tham số
Tên | Loại | Mô tả |
---|---|---|
ratio | Number | Tỷ lệ để điều chỉnh chiều rộng của phần tử trang này. |
Cầu thủ trả bóng
Line
– Phần tử trang này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đó. Điều này 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ẽ đặt Page
mẹ của PageElement
thành current page selection
.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const pageElement = slide.getPageElements()[0]; // Only select this page element and replace any previous selection. pageElement.select();
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 nằm 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
.- Không được chọn nhiều đối tượng
Page
.
Để đảm bảo điều đó, phương pháp ưu tiên là trước tiên, hãy chọn Page
gốc bằng Page.selectAsCurrentPage()
, sau đó chọn các phần tử trang trong trang đó.
const 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. const pageElements = slide.getPageElements(); for (let i = 0; i < pageElements.length; i++) { pageElements[i].select(false); }
Tham số
Tên | Loại | Mô tả |
---|---|---|
replace | Boolean | Nếu là true , lựa chọn 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
Các tập lệnh sử dụng phương thức này yêu cầu đượ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()
Chuyển phần tử trang lùi lại một phần tử trên trang.
Phần tử trang không được nằm trong một nhóm.
Cầu thủ trả bóng
Line
– Phần tử trang này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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()
Chuyển phần tử trang về cuối trang.
Phần tử trang không được nằm trong một nhóm.
Cầu thủ trả bóng
Line
– Phần tử trang này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
setDashStyle(style)
Đặt DashStyle
của đường này.
Tham số
Tên | Loại | Mô tả |
---|---|---|
style | DashStyle | Kiểu gạch ngang để đặt cho dòng này. |
Cầu thủ trả bóng
Line
– Dòng này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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". const pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setDescription('new alt text description'); Logger.log(pageElement.getDescription());
Tham số
Tên | Loại | Mô tả |
---|---|---|
description | String | Chuỗi để đặt nội dung mô tả văn bản thay thế. |
Cầu thủ trả bóng
Line
– Phần tử trang này.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
setEnd(left, top)
Đặt vị trí của điểm cuối của đường thẳng.
Đường dẫn của đường kẻ có thể được điều chỉnh sau khi vị trí thay đổi.
Tham số
Tên | Loại | Mô tả |
---|---|---|
left | Number | Vị trí theo chiều ngang của điểm cuối của đường thẳng, được đo bằng điểm tính từ góc trên cùng bên trái của trang. |
top | Number | Vị trí theo chiều dọc của điểm cuối của đường thẳng, đo bằng điểm tính từ góc trên cùng bên trái của trang. |
Cầu thủ trả bóng
Line
– Dòng này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
setEnd(point)
Đặt vị trí của điểm cuối của đường thẳng.
Đường dẫn của đường kẻ có thể được điều chỉnh sau khi vị trí thay đổi.
Tham số
Tên | Loại | Mô tả |
---|---|---|
point | Point | Điểm cuối của đường thẳng, vị trí được đo từ góc trên bên trái của trang. |
Cầu thủ trả bóng
Line
– Dòng này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
setEndArrow(style)
Đặt ArrowStyle
của mũi tên ở cuối dòng.
Tham số
Tên | Loại | Mô tả |
---|---|---|
style | ArrowStyle | Kiểu cần đặt. |
Cầu thủ trả bóng
Line
– Dòng này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
setEndConnection(connectionSite)
Đặt kết nối ở cuối dòng. Hàm này di chuyển phần cuối của dòng đến điểm kết nối được chỉ định trong khi vẫn giữ nguyên phần cuối còn lại.
Tham số
Tên | Loại | Mô tả |
---|---|---|
connectionSite | ConnectionSite | Trang web kết nối mà kết nối cuối được cập nhật đến hoặc null nếu bạn xoá kết nối cuối. |
Cầu thủ trả bóng
Line
– Đường.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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, tức 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ử trên trang. Để tìm hiểu những phần tử trang 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à vị trí.
Tham số
Tên | Loại | Mô tả |
---|---|---|
height | Number | Chiều cao mới của phần tử trang này cần đặt, tính bằng điểm. |
Cầu thủ trả bóng
Line
– Phần tử trang này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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í ngang của phần tử theo đ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 | Mô tả |
---|---|---|
left | Number | Vị trí ngang mới cần đặt, tính bằng điểm. |
Cầu thủ trả bóng
Line
– Phần tử trang này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
setLineCategory(lineCategory)
Đặt LineCategory
của đường này.
Bạn chỉ có thể đặt danh mục trên connectors
. Bạn có thể định tuyến lại trình kết nối sau khi thay đổi danh mục của trình kết nối đó.
Tham số
Tên | Loại | Mô tả |
---|---|---|
lineCategory | LineCategory | Danh mục dòng cần đặt. |
Cầu thủ trả bóng
Line
– Đường.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 dựa trên 0 của trang trình bày.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(0);
Tham số
Tên | Loại | Mô tả |
---|---|---|
slideIndex | Integer | Chỉ mục dựa trên 0 của trang trình bày. |
Cầu thủ trả bóng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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)
Đặt Link
thành Slide
đã cho, đường liên kết được đặt theo mã nhận dạng trang trình bày đã cho.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(slides[0]);
Tham số
Tên | Loại | Mô tả |
---|---|---|
slide | Slide | Slide cần được liên kết. |
Cầu thủ trả bóng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
Tham số
Tên | Loại | Mô tả |
---|---|---|
slidePosition | SlidePosition | SlidePosition tương đối. |
Cầu thủ trả bóng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkUrl('https://slides.google.com');
Tham số
Tên | Loại | Mô tả |
---|---|---|
url | String | Chuỗi URL. |
Cầu thủ trả bóng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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ử xung quanh tâm theo độ.
Phương thức này không tương thích với tất cả các phần tử trên trang. Để tìm hiểu những phần tử trang 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à vị trí.
Tham số
Tên | Loại | Mô tả |
---|---|---|
angle | Number | Góc xoay mới theo chiều kim đồng hồ cần đặt, tính bằng độ. |
Cầu thủ trả bóng
Line
– Phần tử trang này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
setStart(left, top)
Đặt vị trí của điểm bắt đầu của đường thẳng.
Đường dẫn của đường kẻ có thể được điều chỉnh sau khi vị trí thay đổi.
Tham số
Tên | Loại | Mô tả |
---|---|---|
left | Number | Vị trí theo chiều ngang của điểm bắt đầu của đường thẳng, được đo bằng điểm tính từ góc trên cùng bên trái của trang. |
top | Number | Vị trí theo chiều dọc của điểm bắt đầu của đường thẳng, được đo bằng điểm tính từ góc trên bên trái của trang. |
Cầu thủ trả bóng
Line
– Dòng này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
setStart(point)
Đặt vị trí của điểm bắt đầu của đường thẳng.
Đường dẫn của đường kẻ có thể được điều chỉnh sau khi vị trí thay đổi.
Tham số
Tên | Loại | Mô tả |
---|---|---|
point | Point | Điểm bắt đầu của đường, vị trí được đo từ góc trên bên trái của trang. |
Cầu thủ trả bóng
Line
– Dòng này để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
setStartArrow(style)
Đặt ArrowStyle
của mũi tên ở đầu dòng.
Tham số
Tên | Loại | Mô tả |
---|---|---|
style | ArrowStyle | Kiểu mũi tên mới cần đặt. |
Cầu thủ trả bóng
Line
– Dòng này để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
setStartConnection(connectionSite)
Thiết lập kết nối ở đầu dòng. Hàm này di chuyển đầu dòng đến điểm kết nối đã chỉ định trong khi vẫn giữ nguyên đầu kia.
Tham số
Tên | Loại | Mô tả |
---|---|---|
connectionSite | ConnectionSite | Trang web kết nối mà kết nối bắt đầu được cập nhật hoặc null nếu xoá kết nối bắt đầu. |
Cầu thủ trả bóng
Line
– Đường.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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ế 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". const pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setTitle('new alt text title'); Logger.log(pageElement.getTitle());
Tham số
Tên | Loại | Mô tả |
---|---|---|
title | String | Chuỗi để đặt tiêu đề văn bản thay thế. |
Cầu thủ trả bóng
Line
– Phần tử trang này.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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í dọc của phần tử theo điểm, đ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 | Mô tả |
---|---|---|
top | Number | Vị trí dọc mới cần đặt, tính bằng điểm. |
Cầu thủ trả bóng
Line
– Phần tử trang này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được cung cấp.
Việc cập nhật phép biến đổi của một nhóm sẽ thay đổi phép 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 của các phần tử đó.
Việc cập nhật phép biến đổi của một phần tử trang nằm trong một nhóm chỉ thay đổi phép biến đổi của phần tử trang đó; không ảnh hưởng đến phép 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ề cách các phép biến đổi ảnh hưởng đến giao diện của các phần tử trên trang, hãy xem getTransform()
.
Tham số
Tên | Loại | Mô tả |
---|---|---|
transform | AffineTransform | Biến đổi được đặt cho phần tử trang này. |
Cầu thủ trả bóng
Line
– Phần tử này dùng để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
setWeight(points)
Đặt độ dày của đường bằng điểm.
Tham số
Tên | Loại | Mô tả |
---|---|---|
points | Number | Độ dày mới của đường kẻ tính bằng điểm. |
Cầu thủ trả bóng
Line
– Dòng này để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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, 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ử trên trang. Để tìm hiểu những phần tử trang 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à vị trí.
Tham số
Tên | Loại | Mô tả |
---|---|---|
width | Number | Độ rộng mới của phần tử trang này cần đặt, tính bằng điểm. |
Cầu thủ trả bóng
Line
– Phần tử trang này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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