Class PageElement

Phần tửTrang

Một phần tử hình ảnh được kết xuất trên một trang.

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
alignOnPage(alignmentPosition)PageElementCăn chỉnh phần tử với vị trí căn chỉnh được chỉ định trên trang.
asGroup()GroupTrả về phần tử trang dưới dạng một nhóm.
asImage()ImageTrả về phần tử trang dưới dạng hình ảnh.
asLine()LineTrả về phần tử trang dưới dạng một dòng.
asShape()ShapeTrả về phần tử trang dưới dạng hình dạng.
asSheetsChart()SheetsChartTrả về phần tử trang dưới dạng biểu đồ được liên kết được nhúng từ Google Trang tính.
asSpeakerSpotlight()SpeakerSpotlightTrả về phần tử trang dưới dạng điểm nổi bật của diễn giả.
asTable()TableTrả về phần tử trang dưới dạng bảng.
asVideo()VideoTrả về phần tử trang dưới dạng video.
asWordArt()WordArtTrả về phần tử trang dưới dạng văn bản nghệ thuật.
bringForward()PageElementChuyển phần tử trang về phía trước trên trang một phần tử.
bringToFront()PageElementĐưa phần tử trang lên đầu trang.
duplicate()PageElementSao 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.
getDescription()StringTrả về nội dung mô tả văn bản thay thế của phần tử trang.
getHeight()NumberLấ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()NumberTrả về chiều cao vốn có của phần tử tính bằng điểm.
getInherentWidth()NumberTrả về chiều rộng vốn có của phần tử tính bằng điểm.
getLeft()NumberTrả 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.
getObjectId()StringTrả về mã nhận dạng duy nhất cho đối tượng này.
getPageElementType()PageElementTypeTrả về loại phần tử trang, được biểu thị dưới dạng enum PageElementType.
getParentGroup()GroupTrả 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()PageTrả về trang chứa phần tử trang này.
getRotation()NumberTrả 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.
getTitle()StringTrả về tiêu đề văn bản thay thế của phần tử trang.
getTop()NumberLấ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()AffineTransformTrả về phép biến đổi của phần tử trang.
getWidth()NumberTrả 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.
preconcatenateTransform(transform)PageElementKế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()voidXoá phần tử trang.
scaleHeight(ratio)PageElementĐiều chỉnh tỷ lệ chiều cao của phần tử theo tỷ lệ đã chỉ định.
scaleWidth(ratio)PageElementĐiều chỉnh tỷ lệ chiều rộng của phần tử theo tỷ lệ đã chỉ định.
select()voidChỉ 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)voidChọn PageElement trong bản trình bày đang hoạt động.
sendBackward()PageElementChuyển phần tử trang lùi lại một phần tử trên trang.
sendToBack()PageElementChuyển phần tử trang về cuối trang.
setDescription(description)PageElementĐặt nội dung mô tả văn bản thay thế của phần tử trang.
setHeight(height)PageElementĐặ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)PageElementĐặ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.
setRotation(angle)PageElementĐặt góc xoay theo chiều kim đồng hồ của phần tử xung quanh tâm theo độ.
setTitle(title)PageElementĐặt tiêu đề văn bản thay thế của phần tử trang.
setTop(top)PageElementĐặ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)PageElementĐặt phép biến đổi của phần tử trang bằng phép biến đổi được cung cấp.
setWidth(width)PageElementĐặ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ênLoạiMô tả
alignmentPositionAlignmentPositionVị trí để căn chỉnh phần tử trang này trên trang.

Cầu thủ trả bóng

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


asGroup()

Trả về phần tử trang dưới dạng một nhóm.

Cầu thủ trả bóng

Group – Phần tử trang này dưới dạng một nhó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

asImage()

Trả về phần tử trang dưới dạng hình ảnh.

Cầu thủ trả bóng

Image – Phần tử trang này dưới dạng hình ảnh.

Ủ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

asLine()

Trả về phần tử trang dưới dạng một dòng.

Cầu thủ trả bóng

Line – Phần tử trang này dưới dạng một 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

asShape()

Trả về phần tử trang dưới dạng hình dạng.

Cầu thủ trả bóng

Shape – Phần tử trang này dưới dạng hình 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

asSheetsChart()

Trả về phần tử trang dưới dạng biểu đồ được liên kết được nhúng từ Google Trang tính.

Cầu thủ trả bóng

SheetsChart – Phần tử trang dưới dạng biểu đồ.

Ủ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

asSpeakerSpotlight()

Trả về phần tử trang dưới dạng điểm nổi bật của diễn giả.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = slide.getPageElements()[0];
pageElement.asSpeakerSpotlight();

Cầu thủ trả bóng

SpeakerSpotlight – Phần tử trang dưới dạng video của người trình bà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

asTable()

Trả về phần tử trang dưới dạng bảng.

Cầu thủ trả bóng

Table – Phần tử trang này dưới dạng 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

asVideo()

Trả về phần tử trang dưới dạng video.

Cầu thủ trả bóng

Video – Phần tử trang này dưới dạng video.

Ủ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

asWordArt()

Trả về phần tử trang dưới dạng văn bản nghệ thuật.

Cầu thủ trả bóng

WordArt – Phần tử trang này dưới dạng nghệ thuật chữ.

Ủ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

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

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

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

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

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

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()

Trả về trang chứa phần tử trang này.

Cầu thủ trả bóng

Page – Trang chứa phần tử 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

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

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

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

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ênLoạiMô tả
transformAffineTransformBiế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

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

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ênLoạiMô tả
ratioNumberTỷ lệ để điều chỉnh chiều cao của phần tử trang này.

Cầu thủ trả bóng

PageElement – 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ênLoạiMô tả
ratioNumberTỷ lệ để điều chỉnh chiều rộng của phần tử trang này.

Cầu thủ trả bóng

PageElement – 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:

  1. Page mẹ của đối tượng PageElement phải là current page selection.
  2. 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ênLoạiMô tả
replaceBooleanNế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

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

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

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ênLoạiMô tả
descriptionStringChuỗi để đặt nội dung mô tả văn bản thay thế.

Cầu thủ trả bóng

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

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ênLoạiMô tả
heightNumberChiề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

PageElement – 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ênLoạiMô tả
leftNumberVị trí ngang mới cần đặt, tính bằng điểm.

Cầu thủ trả bóng

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

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ênLoạiMô tả
angleNumberGóc xoay mới theo chiều kim đồng hồ cần đặt, tính bằng độ.

Cầu thủ trả bóng

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

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ênLoạiMô tả
titleStringChuỗi để đặt tiêu đề văn bản thay thế.

Cầu thủ trả bóng

PageElement – 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ênLoạiMô tả
topNumberVị trí dọc mới cần đặt, tính bằng điểm.

Cầu thủ trả bóng

PageElement – 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ênLoạiMô tả
transformAffineTransformBiến đổi được đặt cho phần tử trang này.

Cầu thủ trả bóng

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

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ênLoạiMô tả
widthNumberĐộ 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

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