Class WordArt

WordArt

PageElement đại diện cho chữ nghệ thuật.

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
alignOnPage(alignmentPosition)WordArtCăn chỉnh phần tử theo vị trí căn chỉnh được chỉ định trên trang.
bringForward()WordArtĐưa phần tử trang lên trước một phần tử trên trang.
bringToFront()WordArtĐư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ó bất kỳ 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()Number|nullLấy 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.
getInherentHeight()Number|nullTrả về chiều cao vốn có của phần tử theo điểm.
getInherentWidth()Number|nullTrả về chiều rộng vốn có của phần tử theo điểm.
getLeft()NumberTrả về vị trí ngang của phần tử theo điểm, được đo từ góc trên cùng bên trái của trang khi phần tử không có hướng xoay.
getLink()Link|nullTrả 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 cho đối tượng này.
getPageElementType()PageElementTypeTrả về loại phần tử trên trang, được biểu thị dưới dạng một enum PageElementType.
getParentGroup()Group|nullTrả 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 nhóm nào.
getParentPage()PageTrả về trang mà phần tử trang này nằm trên.
getRenderedText()StringLấy văn bản được kết xuất dưới dạng chữ nghệ thuật.
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.
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 cùng bên trái của trang khi phần tử không có độ xoay.
getTransform()AffineTransformTrả về phép biến đổi của phần tử trang.
getWidth()Number|nullTrả về chiều rộng của phần tử theo đ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ó góc xoay.
preconcatenateTransform(transform)WordArtNối trước phép biến đổi đã cho vào phép biến đổi hiện có của phần tử trang.
remove()voidXoá phần tử trang.
removeLink()voidXoá Link.
scaleHeight(ratio)WordArtĐiều chỉnh tỷ lệ chiều cao của phần tử theo tỷ lệ đã chỉ định.
scaleWidth(ratio)WordArtĐ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()WordArtDi chuyển phần tử trang về phía sau một phần tử trên trang.
sendToBack()WordArtĐưa phần tử trang ra phía sau trang.
setDescription(description)WordArtĐặt nội dung mô tả văn bản thay thế của phần tử trang.
setHeight(height)WordArtĐặ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)WordArtĐặt vị trí ngang của phần tử theo điểm, được đo từ góc trên cùng bên trái của trang khi phần tử không có chế độ xoay.
setLinkSlide(slideIndex)LinkĐặt mộ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 mộ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 một Link thành chuỗi URL không trống đã cho.
setRotation(angle)WordArtĐặ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)WordArtĐặt tiêu đề văn bản thay thế cho phần tử trang.
setTop(top)WordArtĐặt vị trí dọc của phần tử theo điểm, đo từ góc trên cùng bên trái của trang khi phần tử không có chế độ xoay.
setTransform(transform)WordArtĐặ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)WordArtĐặt chiều rộng của phần tử theo điểm, đây là chiều rộng của hộp giới hạn của phần tử khi phần tử không có góc xoay.

Tài liệu chi tiết

alignOnPage(alignmentPosition)

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

Thông 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

WordArt – Phần tử trang này, dùng để liên kết.

bringForward()

Đưa phần tử trang lên trước 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

WordArt – Phần tử trang này, dùng để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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

WordArt – Phần tử trang này, dùng để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 một 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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ó bất kỳ trang web kết nối nào.

Cầu thủ trả bóng

ConnectionSite[] – Danh sách các 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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, 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ử 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 hạn chế về kích thước và vị trí.

Cầu thủ trả bóng

Number|null – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getInherentHeight()

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

Phép biến đổi của phần tử trang có liên quan đến 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 trực quan cuối cùng của phần tử.

Cầu thủ trả bóng

Number|null – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getInherentWidth()

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

Phép biến đổi của phần tử trang có liên quan đến 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 trực quan cuối cùng của phần tử.

Cầu thủ trả bóng

Number|null – Chiều rộng vốn có của phần tử trang 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cùng bên trái của trang khi phần tử không có hướng xoay.

Cầu thủ trả bóng

Number – Vị trí ngang của phần tử này theo điểm, từ góc trên cùng 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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. 

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|null – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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ã nhận dạng đối tượng mà các trang và phần tử trang sử dụng có cùng 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPageElementType()

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

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 nhóm nào.

Cầu thủ trả bóng

Group|null – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getParentPage()

Trả về trang mà phần tử trang này nằm trên.

Cầu thủ trả bóng

Page – Trang mà phần tử này nằm trên.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getRenderedText()

Lấy văn bản được kết xuất dưới dạng chữ nghệ thuật.

Cầu thủ trả bóng

String – Văn bản được hiển thị dưới dạng chữ nghệ thuật này.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cùng bên trái của trang khi phần tử không có độ xoay.

Cầu thủ trả bóng

Number – Vị trí dọc của phần tử này theo điểm, từ góc trên cùng 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 trực quan của phần tử trang được xác định bằng phép biến đổi tuyệt đối. Để tính toán phép biến đổi tuyệt đối, hãy kết hợp 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ẹ của phần tử đó. Nếu phần tử trang không nằm trong một nhóm, thì phép biến đổi tuyệt đối của phần tử đó sẽ giống với giá trị trong trường này.

Cầu thủ trả bóng

AffineTransform – Biến đổi phần tử trang.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getWidth()

Trả về chiều rộng của phần tử theo điểm, 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ó gó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 hạn chế về kích thước và vị trí.

Cầu thủ trả bóng

Number|null – Chiều rộng vốn có của phần tử trang 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

preconcatenateTransform(transform)

Nối trước phép biến đổi đã cho vào 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ử trên 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).

Thông số

TênLoạiMô tả
transformAffineTransformPhép biến đổi để kết hợp trước vào phép biến đổi của phần tử trang này.

Cầu thủ trả bóng

WordArt – Phần tử trang này, dùng để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 một phần giữ chỗ PageElement bị xoá trên trang trình bày hoặc bố cục, thì mọi phần giữ chỗ trống kế thừa cũng sẽ bị xoá.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

Xoá Link. 

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

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ó gó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 hạn chế về kích thước và vị trí.

Thông 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

WordArt – Phần tử trang này, dùng để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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ó gó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 hạn chế về kích thước và vị trí.

Thông 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

WordArt – Phần tử trang này, dùng để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

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 làm 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

select(replace)

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

Tập lệnh chỉ có thể truy cập vào lựa chọn 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 đến 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 phần tử mẹ Page của PageElement làm 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 đây khi chọn một phần tử trên trang bằng cách sử dụng tham số false:

  1. Page mẹ của đối tượng PageElement phải là current page selection.
  2. Bạn không nên chọn nhiều đối tượng Page.

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

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);
}

Thông số

TênLoạiMô tả
replaceBooleanNếu true, lựa chọn này sẽ thay thế mọi lựa chọn trước đó; nếu không, lựa chọn này 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

sendBackward()

Di chuyển phần tử trang về phía sau 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

WordArt – Phần tử trang này, dùng để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

sendToBack()

Đưa phần tử trang ra phía sau trang.

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

Cầu thủ trả bóng

WordArt – Phần tử trang này, dùng để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

Thông số

TênLoạiMô tả
descriptionStringChuỗi dùng để đặt nội dung mô tả văn bản thay thế.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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ử 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 hạn chế về kích thước và vị trí.

Thông 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

WordArt – Phần tử trang này, dùng để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cùng bên trái của trang khi phần tử không có chế độ xoay.

Thông 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

WordArt – Phần tử trang này, dùng để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slideIndex)

Đặt mộ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);

Thông số

TênLoạiMô tả
slideIndexIntegerChỉ mục bắt đầu từ 0 cho trang trình bày.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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]);

Thông 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slidePosition)

Đặt mộ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);

Thông số

TênLoạiMô tả
slidePositionSlidePositionSlidePosition tương đối.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkUrl(url)

Đặt mộ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');

Thông số

TênLoạiMô tả
urlStringChuỗi URL.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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ử 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 hạn chế về kích thước và vị trí.

Thông 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

WordArt – Phần tử trang này, dùng để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setTitle(title)

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

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

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

Thông số

TênLoạiMô tả
titleStringChuỗi để đặt tiêu đề văn bản thay thế.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cùng bên trái của trang khi phần tử không có chế độ xoay.

Thông 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

WordArt – Phần tử trang này, dùng để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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ể làm thay đổi hình thức trực quan 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 đó; việc này 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 trực quan của các phần tử trên trang, hãy xem getTransform().

Thông số

TênLoạiMô tả
transformAffineTransformPhép biến đổi được đặt cho phần tử trang này.

Cầu thủ trả bóng

WordArt – Phần tử này dùng để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setWidth(width)

Đặt chiều rộng của phần tử theo điểm, đây là chiều rộng của hộp giới hạn của phần tử khi phần tử không có gó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 hạn chế về kích thước và vị trí.

Thông số

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

WordArt – Phần tử trang này, dùng để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations