Class Shape

Hình dạng

PageElement đại diện cho một hình dạng chung không có hình dạng cụ thể hơn của bạ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ứcLoại dữ liệu trả vềMô tả ngắn
alignOnPage(alignmentPosition)ShapeCă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()PageElementSao chép phần tử trang.
getAutofit()AutofitTrả về Autofit của văn bản trong hình dạng này.
getBorder()BorderTrả 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 trang không có bất kỳ trang web kết nối nào.
getContentAlignment()ContentAlignmentTrả về ContentAlignment của văn bản trong hình dạng.
getDescription()StringTrả về nội dung mô tả văn bản thay thế của phần tử trang.
getFill()FillTrả về Fill của hình dạng.
getHeight()NumberLấy chiều cao của phần tử tính bằng đ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 có chế độ 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 các điểm, được đo từ góc trên bên trái của khi phần tử không có chế độ xoay.
getLink()LinkTrả về Link hoặc null nếu không có đường liên kết.
getObjectId()StringTrả về mã nhận dạng duy nhất của đố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 nằm trong một nhóm.
getParentPage()PageTrả về trang có phần tử trang này.
getParentPlaceholder()PageElementTrả về phần tử trang gốc của phần giữ chỗ.
getPlaceholderIndex()IntegerTrả về chỉ mục phần giữ chỗ của hình dạng.
getPlaceholderType()PlaceholderTypeTrả 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à hình dạng phần giữ chỗ.
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 độ có nghĩa là không xoay.
getShapeType()ShapeTypeTrả về loại của hình dạng.
getText()TextRangeTrả về nội dung văn bản của hình dạng.
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ử tính theo điểm, được đo từ góc trên bên trái của trang khi phần tử không xoay.
getTransform()AffineTransformTrả về 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, là chiều rộng của hộp giới hạn của phần tử khi phần tử không có chế độ xoay.
preconcatenateTransform(transform)ShapeLiê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()voidXoá phần tử trang.
removeLink()voidXoá một Link.
replaceWithImage(blobSource)ImageThay thế hình dạng này bằng hình ảnh do BlobSource cung cấp.
replaceWithImage(blobSource, crop)ImageThay thế hình dạng này bằng hình ảnh do BlobSource cung cấp.
replaceWithImage(imageUrl)ImageThay thế hình dạng này bằng một hình ảnh.
replaceWithImage(imageUrl, crop)ImageThay thế hình dạng này bằng một hình ảnh.
replaceWithSheetsChart(sourceChart)SheetsChartThay thế hình này bằng biểu đồ trên Google Trang tính.
replaceWithSheetsChartAsImage(sourceChart)ImageThay 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()voidChỉ chọn PageElement trong bản trình bày đang hoạt động và xoá mọi bản trình bày trước đó lựa chọn.
select(replace)voidChọ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)ShapeThiết lập ContentAlignment của văn bản trong hình dạng.
setDescription(description)ShapeThiết lập nội dung mô tả văn bản thay thế của phần tử trang.
setHeight(height)ShapeĐặt chiều cao của phần tử theo điểm, là chiều cao của hộp giới hạn của phần tử khi phần tử không có chế độ xoay.
setLeft(left)ShapeĐặt vị trí ngang của phần tử tính theo các điểm, được đo từ góc trên bên trái của khi phần tử không có chế độ xoay.
setLinkSlide(slideIndex)LinkĐặ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 theo đ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Đặt 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 có chế độ xoay.

Tài liệu chi tiết

alignOnPage(alignmentPosition)

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

Tham số

TênLoạiMô tả
alignmentPositionAlignmentPositionVị 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()

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

Cầu thủ trả bóng

Border — Thiết lập đường viền của hình này.

Ủy quyền

Tập lệnh sử dụng phương thức này 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

getConnectionSites()

Trả về danh sách ConnectionSite trên phần tử trang hoặc danh sách trống nếu trang không có bất kỳ 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. 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ả 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()

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

Cầu thủ trả bóng

Fill — Chế độ cài đặt tô màu nền cho hình 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

getHeight()

Lấy chiều cao của phần tử tính bằng đ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 có chế độ xoay.

Phương thức này không tương thích với tất cả các phần tử trang. Để tìm hiểu xem phần tử trang nào không tương thích với phương pháp này, hãy tham khảo hạn chế 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 có chiều cao 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ó trong kết hợp với 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 có chiều cao 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ó trong kết hợp với 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 có chiều rộng 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ử theo các điểm, được đo từ góc trên bên trái của khi phần tử không có chế độ 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

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

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

Cầu thủ trả bóng

Link

Ủy quyền

Tập lệnh sử dụng phương thức này 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ó chung 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 một nhóm.

Cầu thủ trả bóng

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

Ủy quyền

Tập lệnh sử dụng phương thức này 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()

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

Cầu thủ trả bóng

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

Ủy quyền

Tập lệnh sử dụng phương thức này 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

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ó thư mục 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à hình dạng này phần giữ chỗ hoặc không có thư mục 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 phần giữ chỗ có trên cùng một trang, mỗi loại có giá trị chỉ mục riêng duy nhất. 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à hình dạng 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()

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

Cầu thủ trả bóng

ShapeType — Loại hình dạng này.

getText()

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

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

Cầu thủ trả bóng

TextRange — Nội dung văn bản của hình 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 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 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í 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ử đó. Người nhận tính toán biến đổi tuyệt đối, liên kết trước biến đổi của phần tử trang với các 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ì biến đổi tuyệt đối của phần tử đó là 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 có chế độ xoay.

Phương thức này không tương thích với tất cả các phần tử trang. Để tìm hiểu xem phần tử trang nào không tương thích với phương pháp này, hãy tham khảo hạn chế 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 có chiều rộng 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ênLoạiMô tả
transformAffineTransformBiế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 bị xoá.

Nếu một phần giữ chỗ PageElement bị xoá trên một chính hoặc bố cục, thì mọi kế thừa trống phần giữ chỗ cũng bị xóa.

Ủ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

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 được lưu trữ để hiển thị trong bản trình bày. Hình ảnh phải có kích thước nhỏ hơn 50 MB, không được vượt quá 25 megapixel và phải ở định dạng PNG, JPEG hoặc GIF.

Để duy trì tỷ lệ khung hình của hình ảnh, hình ảnh sẽ được điều chỉnh theo tỷ lệ và căn giữa theo thành 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ênLoạiMô tả
blobSourceBlobSourceDữ 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 và một bản sao sẽ được lưu trữ cho hiển thị bên trong bản trình bày. Hình ảnh phải có kích thước nhỏ hơn 50 MB và 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ênLoạiMô tả
blobSourceBlobSourceDữ liệu hình ảnh.
cropBooleanNế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, giá trị đượ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 dạng này bằng một hình ảnh.

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

URL bạn 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. Hệ thống sẽ lưu URL này có hình ảnh này và được hiển thị 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 thành kích thước của hình dạng hiện có.

Tham số

TênLoạiMô tả
imageUrlStringURL 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 dạng này bằng một hình ảnh.

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

URL đã cung cấp không được lớn hơn 2kB. URL đó được lưu cùng với hình ảnh và được tiếp xúc thông qua Image.getSourceUrl().

Tham số

TênLoạiMô tả
imageUrlStringURL của hình ảnh để tải hình ảnh xuống.
cropBooleanNế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, giá trị đượ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 đồ. Lý do khác cộng tác viên có thể xem đườ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ênLoạiMô tả
sourceChartEmbeddedChartBiể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 đồ sẽ được điều chỉnh theo tỷ lệ và căn giữa tương ứng với kích thước của hình dạng hiện 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ênLoạiMô tả
sourceChartEmbeddedChartBiể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 xem phần tử trang nào không tương thích với phương pháp này, hãy tham khảo hạn chế về kích thước và xác định 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 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 xem phần tử trang nào không tương thích với phương pháp này, hãy tham khảo hạn chế về kích thước và xác định 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 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 bản trình bày trước đó lựa chọn. 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 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 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á bất kỳ lựa chọn trước đó. Thao tác này cũng đặt Page mẹ của PageElement làm current page selection.

Truyền false để chọn nhiều đối tượng PageElement. PageElement các đối tượng phải ở trong cùng 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 false tham số:

  1. Page mẹ của đối tượng PageElement phải là current page selection.
  2. 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 tiên bằng cách sử dụng Page.selectAsCurrentPage() rồi 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ênLoạiMô tả
replaceBooleanNếu là true, lựa chọn này sẽ thay thế mọi lựa chọn trước đó; nếu không thì lựa chọn trước đó sẽ được thêm vào.

Ủ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ênLoạiMô tả
contentAlignmentContentAlignmentCă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ênLoạiMô tả
descriptionStringChuỗ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)

Đặt chiều cao của phần tử 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 có chế độ xoay.

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

Tham số

TênLoạiMô tả
heightNumberChiề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í ngang của phần tử tính theo các điểm, được đo từ góc trên bên trái của khi phần tử không có chế độ xoay.

Tham số

TênLoạiMô tả
leftNumberVị 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 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ênLoạiMô tả
slideIndexIntegerChỉ mục (bắt đầu đếm từ 0) cho trang trình bày.

Cầu thủ trả bóng

Link – Link đã được đặt

Ủy quyền

Tập lệnh sử dụng phương thức này 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ênLoạiMô tả
slideSlideSlide cần liên kết.

Cầu thủ trả bóng

Link – Link đã được đặt

Ủy quyền

Tập lệnh sử dụng phương thức này 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ênLoạiMô tả
slidePositionSlidePositionSlidePosition tương đối.

Cầu thủ trả bóng

Link – Link đã được đặt

Ủy quyền

Tập lệnh sử dụng phương thức này 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ênLoạiMô tả
urlStringChuỗi URL.

Cầu thủ trả bóng

Link – Link đã được đặt

Ủy quyền

Tập lệnh sử dụng phương thức này 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 xem phần tử trang nào không tương thích với phương pháp này, hãy tham khảo hạn chế về kích thước và xác định vị trí.

Tham số

TênLoạiMô tả
angleNumberGó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ênLoạiMô tả
titleStringChuỗ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 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ả
topNumberVị 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ẽ thay đổi biến đổi tuyệt đối của các phần tử trang trong nhóm đó, có thể thay đổi hình ảnh trực quan của chúng.

Việc cập nhật biến đổi của phần tử trang nằm trong một nhóm chỉ làm thay đổi sự biến đổi của phần tử trang đó; nó không ảnh hưởng đến việc chuyển đổi nhóm hoặc các thành phần 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ênLoạiMô tả
transformAffineTransformBiế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)

Đặt 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 có chế độ xoay.

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

Tham số

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