Bố cục trong bản trình bày.
Mỗi bố cục đóng vai trò là mẫu cho các trang trình bày kế thừa từ bố cục đó, xác định cách sắp xếp và tạo kiểu nội dung trên các trang trình bày đó.
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
get | Page | Lấy nền của trang. |
get | Color | Lấy Color được liên kết với trang. |
get | Group[] | Trả về danh sách đối tượng Group trên trang. |
get | Image[] | Trả về danh sách đối tượng Image trên trang. |
get | String | Lấy tên của bố cục. |
get | Line[] | Trả về danh sách đối tượng Line trên trang. |
get | Master | Lấy bản chính mà bố cục dựa trên đó. |
get | String | Lấy mã nhận dạng duy nhất của trang. |
get | Page | Trả về Page trên trang có mã nhận dạng đã cho hoặc null nếu không có. |
get | Page | Trả về danh sách các đối tượng Page được hiển thị trên trang. |
get | Page | Lấy loại trang. |
get | Page | Trả về đối tượng Page giữ chỗ cho một Placeholder hoặc null đã chỉ định nếu không có phần giữ chỗ phù hợp. |
get | Page | Trả về đối tượng Page phần giữ chỗ cho một Placeholder và chỉ mục phần giữ chỗ đã chỉ định hoặc null nếu không có phần giữ chỗ. |
get | Page | Trả về danh sách các đối tượng Page giữ chỗ trong trang. |
get | Shape[] | Trả về danh sách đối tượng Shape trên trang. |
get | Sheets | Trả về danh sách đối tượng Sheets trên trang. |
get | Table[] | Trả về danh sách đối tượng Table trên trang. |
get | Video[] | Trả về danh sách đối tượng Video trên trang. |
get | Word | Trả về danh sách đối tượng Word trên trang. |
group(pageElements) | Group | Nhóm tất cả các phần tử trang đã chỉ định. |
insert | Group | Chèn một bản sao của Group được cung cấp trên trang. |
insert | Image | Chèn một hình ảnh ở góc trên cùng bên trái của trang với kích thước mặc định từ khối hình ảnh được chỉ định. |
insert | Image | Chèn hình ảnh trên trang có vị trí và kích thước được cung cấp từ blob hình ảnh được chỉ định. |
insert | Image | Chèn một bản sao của Image được cung cấp trên trang. |
insert | Image | Chèn hình ảnh ở góc trên cùng bên trái của trang với kích thước mặc định từ URL được cung cấp. |
insert | Image | Chèn hình ảnh trên trang với vị trí và kích thước được cung cấp từ URL được cung cấp. |
insert | Line | Chèn một bản sao của Line được cung cấp trên trang. |
insert | Line | Chèn một dòng trên trang kết nối hai connection sites . |
insert | Line | Chèn một dòng trên trang. |
insert | Page | Chèn một bản sao của Page được cung cấp trên trang. |
insert | Shape | Chèn một bản sao của Shape được cung cấp trên trang. |
insert | Shape | Chèn một hình dạng trên trang. |
insert | Shape | Chèn một hình dạng trên trang. |
insert | Sheets | Chèn biểu đồ trên Google Trang tính vào trang. |
insert | Sheets | Chèn một biểu đồ trên Google Trang tính vào trang với vị trí và kích thước được cung cấp. |
insert | Sheets | Chèn một bản sao của Sheets được cung cấp trên trang. |
insert | Image | Chèn biểu đồ Google Trang tính dưới dạng Image trên trang. |
insert | Image | Chèn biểu đồ Google Trang tính dưới dạng Image trên trang với vị trí và kích thước được cung cấp. |
insert | Table | Chèn một bảng trên trang. |
insert | Table | Chèn một bảng trên trang với vị trí và kích thước được cung cấp. |
insert | Table | Chèn một bản sao của Table được cung cấp trên trang. |
insert | Shape | Chèn một hộp văn bản Shape chứa chuỗi được cung cấp trên trang. |
insert | Shape | Chèn một hộp văn bản Shape chứa chuỗi được cung cấp trên trang. |
insert | Video | Chèn một video ở góc trên cùng bên trái của trang với kích thước mặc định. |
insert | Video | Chèn một video trên trang với vị trí và kích thước được cung cấp. |
insert | Video | Chèn một bản sao của Video được cung cấp trên trang. |
insert | Word | Chèn một bản sao của Word được cung cấp trên trang. |
remove() | void | Xoá trang. |
replace | Integer | Thay thế tất cả các bản sao của văn bản khớp với văn bản tìm kiếm bằng văn bản thay thế. |
replace | Integer | Thay thế tất cả các bản sao của văn bản khớp với văn bản tìm kiếm bằng văn bản thay thế. |
select | void | Chọn Page trong bản trình bày đang hoạt động làm current page selection và xoá mọi lựa chọn trước đó. |
Tài liệu chi tiết
get Background()
Lấy nền của trang.
Cầu thủ trả bóng
Page
– Nền 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
get Color Scheme()
Lấy Color
được liên kết với trang.
Cầu thủ trả bóng
Color
– Bảng phối màu 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
get Groups()
get Images()
get Layout Name()
Lấy tên của bố cục.
Cầu thủ trả bóng
String
Ủ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
get Lines()
get Master()
get Object Id()
Lấy mã nhận dạng duy nhất của trang. Mã nhận dạng đối tượng mà các trang và phần tử trang sử dụng có cùng một không gian tên.
Cầu thủ trả bóng
String
Ủ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
get Page Element By Id(id)
Trả về Page
trên trang có mã nhận dạng đã cho hoặc null
nếu không có.
Tham số
Tên | Loại | Mô tả |
---|---|---|
id | String | Mã của phần tử trang đang được truy xuất. |
Cầu thủ trả bóng
Page
– Phần tử trang có mã nhận dạng đã cho.
Ủ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
get Page Elements()
Trả về danh sách các đối tượng Page
được hiển thị trên trang.
Cầu thủ trả bóng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Type()
get Placeholder(placeholderType)
Trả về đối tượng Page
giữ chỗ cho một Placeholder
hoặc null
đã chỉ định nếu không có phần giữ chỗ phù hợp.
Nếu có nhiều phần giữ chỗ cùng loại, hàm này sẽ trả về phần giữ chỗ có chỉ mục phần giữ chỗ tối thiểu. Nếu có nhiều phần giữ chỗ khớp với cùng một chỉ mục, thì hàm này sẽ trả về phần giữ chỗ đầu tiên trong tập hợp phần tử trang của trang.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, );
Tham số
Tên | Loại | Mô tả |
---|---|---|
placeholder | Placeholder |
Cầu thủ trả bóng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholder(placeholderType, placeholderIndex)
Trả về đối tượng Page
phần giữ chỗ cho một Placeholder
và chỉ mục phần giữ chỗ đã chỉ định hoặc null
nếu không có phần giữ chỗ.
Nếu có nhiều phần giữ chỗ có cùng loại và chỉ mục, thì hàm này sẽ trả về phần giữ chỗ đầu tiên trong tập hợp phần tử trang của trang.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, 0, );
Tham số
Tên | Loại | Mô tả |
---|---|---|
placeholder | Placeholder | |
placeholder | Integer |
Cầu thủ trả bóng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholders()
Trả về danh sách các đối tượng Page
giữ chỗ trong trang.
const master = SlidesApp.getActivePresentation().getMasters()[0]; Logger.log( `Number of placeholders in the master: ${master.getPlaceholders().length}`, );
Cầu thủ trả bóng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Shapes()
get Sheets Charts()
Trả về danh sách đối tượng Sheets
trên trang.
Cầu thủ trả bóng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Tables()
get Videos()
get Word Arts()
group(pageElements)
Nhóm tất cả các phần tử trang đã chỉ định.
Phải có ít nhất hai phần tử trang trên cùng một trang chưa có trong một nhóm khác. Không thể nhóm một số thành phần trang, chẳng hạn như Videos
, Tables
và placeholder Shapes
.
Tham số
Tên | Loại | Mô tả |
---|---|---|
page | Page | Các phần tử cần nhóm lại với nhau. |
Cầu thủ trả bóng
Group
– Nhóm mớ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
insert Group(group)
Chèn một bản sao của Group
được cung cấp trên trang.
Vị trí của phần tử được chèn trên trang này được xác định từ vị trí của phần tử nguồn trên trang tương ứng.
Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ trong bản trình bày hiện tại, thì các thuộc tính kế thừa từ trang chính hoặc trang bố cục cũng kế thừa trên phần tử được chèn.
Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ một bản trình bày khác, thì các thuộc tính kế thừa từ trang tổng thể hoặc trang bố cục sẽ được sao chép vào phần tử từ bản trình bày nguồn.
// Copy a group between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const group = otherPresentationSlide.getGroups()[0]; currentPresentationSlide.insertGroup( group); // Also available for Layout, Master, and Page.
Tham số
Tên | Loại | Mô tả |
---|---|---|
group | Group | Nhóm cần sao chép và chèn. |
Cầu thủ trả bóng
Group
– Nhóm đã chèn.
Ủ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
insert Image(blobSource)
Chèn một hình ảnh ở góc trên cùng bên trái của trang với kích thước mặc định từ khối hình ảnh được chỉ định.
Thao tác chèn hình ảnh sẽ tìm nạp hình ảnh đó từ Blob
một lần và một bản sao sẽ được lưu trữ để hiển thị bên trong bản trình bày. Hình ảnh phải có kích thước dưới 50 MB, không được vượt quá 25 megapixel và phải ở định dạng PNG, JPEG hoặc GIF.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. const image = DriveApp.getFileById('123abc'); slide.insertImage(image);
Tham số
Tên | Loại | Mô tả |
---|---|---|
blob | Blob | Dữ liệu hình ảnh. |
Cầu thủ trả bóng
Image
– Hình ảnh đã chèn.
Ủ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
insert Image(blobSource, left, top, width, height)
Chèn hình ảnh trên trang có vị trí và kích thước được cung cấp từ blob hình ảnh được chỉ định.
Hình ảnh được tìm nạp từ Blob
đượ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ị bên trong bản trình bày. Hình ảnh phải có kích thước dưới 50 MB, không được vượt quá 25 megapixel và phải ở định dạng PNG, JPEG hoặc GIF.
Để duy trì tỷ lệ khung hình của hình ảnh, hình ảnh được điều chỉnh theo tỷ lệ và căn giữa theo kích thước được cung cấp.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. const image = DriveApp.getFileById('123abc'); const position = { left: 0, top: 0 }; const size = { width: 300, height: 100 }; slide.insertImage(image, position.left, position.top, size.width, size.height);
Tham số
Tên | Loại | Mô tả |
---|---|---|
blob | Blob | Dữ liệu hình ảnh. |
left | Number | Vị trí ngang của hình ảnh tính bằng điểm, đo từ góc trên bên trái của trang. |
top | Number | Vị trí dọc của hình ảnh tính bằng điểm, được đo từ góc trên bên trái của trang. |
width | Number | Chiều rộng của hình ảnh tính bằng điểm. |
height | Number | Chiều cao của hình ảnh tính bằng điểm. |
Cầu thủ trả bóng
Image
– Hình ảnh đã chèn.
Ủ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
insert Image(image)
Chèn một bản sao của Image
được cung cấp trên trang.
Vị trí của hình ảnh được chèn trên trang này được xác định từ vị trí của hình ảnh nguồn trên trang tương ứng.
Nếu hình ảnh được cung cấp là phần giữ chỗ đang được sao chép từ trong bản trình bày hiện tại, thì các thuộc tính kế thừa từ trang chính hoặc trang bố cục cũng sẽ kế thừa trên hình ảnh được chèn.
Nếu hình ảnh được cung cấp là phần giữ chỗ đang được sao chép từ một bản trình bày khác, thì các thuộc tính kế thừa từ trang tổng thể hoặc trang bố cục sẽ được sao chép vào hình ảnh từ bản trình bày nguồn. Nếu hình ảnh phần giữ chỗ được sao chép trống, thì sẽ không có nội dung nào được chèn vào bản trình bày đích.
// Copy an image between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const image = otherPresentationSlide.getImages[0]; currentPresentationSlide.insertImage(image);
Tham số
Tên | Loại | Mô tả |
---|---|---|
image | Image | Hình ảnh cần sao chép và chèn. |
Cầu thủ trả bóng
Image
– Hình ảnh đã chèn.
Ủ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
insert Image(imageUrl)
Chèn hình ảnh ở góc trên cùng bên trái của trang với kích thước mặc định từ URL được cung cấp.
Thao tác chèn hình ảnh sẽ tìm nạp hình ảnh đó từ URL một lần và lưu trữ một bản sao để hiển thị bên trong bản trình bày. Hình ảnh phải có kích thước dưới 50 MB, không được vượt quá 25 megapixel và phải ở định dạng PNG, JPEG hoặc GIF.
URL bạn cung cấp phải có thể truy cập công khai và không được lớn hơn 2 kB. URL sẽ được lưu cùng với hình ảnh và hiển thị thông qua Image.getSourceUrl()
.
Tham số
Tên | Loại | Mô tả |
---|---|---|
image | String | URL của hình ảnh. |
Cầu thủ trả bóng
Image
– Hình ảnh đã chèn.
Ủ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
insert Image(imageUrl, left, top, width, height)
Chèn hình ảnh trên trang với vị trí và kích thước được cung cấp từ URL được cung cấp.
Thao tác chèn hình ảnh sẽ tìm nạp hình ảnh đó từ URL một lần và lưu trữ một bản sao để hiển thị bên trong bản trình bày. Hình ảnh phải có kích thước dưới 50 MB, không được vượt quá 25 megapixel và phải ở định dạng PNG, JPEG hoặc GIF.
URL bạn cung cấp phải có thể truy cập công khai và không được lớn hơn 2 kB. URL sẽ được lưu cùng với hình ảnh và hiển thị thông qua Image.getSourceUrl()
.
Để duy trì tỷ lệ khung hình của hình ảnh, hình ảnh được điều chỉnh theo tỷ lệ và căn giữa theo kích thước được cung cấp.
Tham số
Tên | Loại | Mô tả |
---|---|---|
image | String | URL của hình ảnh. |
left | Number | Vị trí ngang của hình ảnh tính bằng điểm, đo từ góc trên bên trái của trang. |
top | Number | Vị trí dọc của hình ảnh tính bằng điểm, được đo từ góc trên bên trái của trang. |
width | Number | Chiều rộng của hình ảnh tính bằng điểm. |
height | Number | Chiều cao của hình ảnh tính bằng điểm. |
Cầu thủ trả bóng
Image
– Hình ảnh đã chèn.
Ủ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
insert Line(line)
Chèn một bản sao của Line
được cung cấp trên trang.
Vị trí của phần tử được chèn trên trang này được xác định từ vị trí của phần tử nguồn trên trang tương ứng.
Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ trong bản trình bày hiện tại, thì các thuộc tính kế thừa từ trang chính hoặc trang bố cục cũng kế thừa trên phần tử được chèn.
Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ một bản trình bày khác, thì các thuộc tính kế thừa từ trang tổng thể hoặc trang bố cục sẽ được sao chép vào phần tử từ bản trình bày nguồn.
// Copy a line between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const line = otherPresentationSlide.getLines[0]; currentPresentationSlide.insertLine(line);
Tham số
Tên | Loại | Mô tả |
---|---|---|
line | Line | Dòng cần sao chép và chèn. |
Cầu thủ trả bóng
Line
– Dòng đã chèn.
Ủ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
insert Line(lineCategory, startConnectionSite, endConnectionSite)
Chèn một dòng trên trang kết nối hai connection sites
. Hai trang web liên kết phải nằm trên trang này.
// Insert a line in the first slide of the presentation connecting two shapes. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE); const shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD); slide.insertLine( SlidesApp.LineCategory.BENT, shape1.getConnectionSites()[0], shape2.getConnectionSites()[1], );
Tham số
Tên | Loại | Mô tả |
---|---|---|
line | Line | Danh mục của dòng cần chèn. |
start | Connection | Điểm kết nối nơi bắt đầu của đường dây sẽ được kết nối. |
end | Connection | Điểm kết nối nơi kết nối cuối đường dây. |
Cầu thủ trả bóng
Line
– Dòng đã chèn.
Ủ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
insert Line(lineCategory, startLeft, startTop, endLeft, endTop)
Chèn một dòng trên trang.
// Insert a line in the first slide of the presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const startPoint = { left: 10, top: 10 }; const endPoint = { left: 40, top: 40 }; slide.insertLine( SlidesApp.LineCategory.STRAIGHT, startPoint.left, startPoint.top, endPoint.left, endPoint.top, );
Tham số
Tên | Loại | Mô tả |
---|---|---|
line | Line | Danh mục của dòng cần chèn. |
start | Number | Vị trí theo chiều ngang của điểm bắt đầu của đường thẳng, đo bằng điểm tính từ góc trên cùng bên trái của trang. |
start | Number | Vị trí theo chiều dọc của điểm bắt đầu của đường thẳng, đo bằng điểm tính từ góc trên cùng bên trái của trang. |
end | Number | Vị trí theo chiều ngang của điểm cuối của đường thẳng, được đo bằng điểm tính từ góc trên cùng bên trái của trang. |
end | Number | Vị trí theo chiều dọc của điểm cuối của đường thẳng, đo bằng điểm tính từ góc trên cùng bên trái của trang. |
Cầu thủ trả bóng
Line
– Dòng đã chèn.
Ủ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
insert Page Element(pageElement)
Chèn một bản sao của Page
được cung cấp trên trang.
Vị trí của phần tử được chèn trên trang này được xác định từ vị trí của phần tử nguồn trên trang tương ứng.
Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ trong bản trình bày hiện tại, thì các thuộc tính kế thừa từ trang chính hoặc trang bố cục cũng kế thừa trên phần tử được chèn.
Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ một bản trình bày khác, thì các thuộc tính kế thừa từ trang tổng thể hoặc trang bố cục sẽ được sao chép vào phần tử từ bản trình bày nguồn.
// Copy a page element between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const pageElement = otherPresentationSlide.getPageElements()[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertPageElement(pageElement);
Tham số
Tên | Loại | Mô tả |
---|---|---|
page | Page | Phần tử trang cần sao chép và chèn. |
Cầu thủ trả bóng
Page
– Phần tử trang đã chèn.
Ủ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
insert Shape(shape)
Chèn một bản sao của Shape
được cung cấp trên trang.
Vị trí của phần tử được chèn trên trang này được xác định từ vị trí của phần tử nguồn trên trang tương ứng.
Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ trong bản trình bày hiện tại, thì các thuộc tính kế thừa từ trang chính hoặc trang bố cục cũng kế thừa trên phần tử được chèn.
Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ một bản trình bày khác, thì các thuộc tính kế thừa từ trang tổng thể hoặc trang bố cục sẽ được sao chép vào phần tử từ bản trình bày nguồn.
// Copy a shape between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const shape = otherPresentationSlide.getShapes[0]; currentPresentationSlide.insertShape( shape); // Also available for Layout, Master, and Page.
Tham số
Tên | Loại | Mô tả |
---|---|---|
shape | Shape | Hình dạng cần sao chép và chèn. |
Cầu thủ trả bóng
Shape
– Hình dạng được chèn.
Ủ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
insert Shape(shapeType)
Chèn một hình dạng trên trang.
Hình dạng được chèn với kích thước mặc định ở góc trên cùng bên trái của trang.
// Insert a shape in the first slide of the presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Also available for Layout, Master, and Page. slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
Tham số
Tên | Loại | Mô tả |
---|---|---|
shape | Shape | Loại hình dạng cần chèn. |
Cầu thủ trả bóng
Shape
– Hình dạng được chèn.
Ủ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
insert Shape(shapeType, left, top, width, height)
Chèn một hình dạng trên trang.
Tham số
Tên | Loại | Mô tả |
---|---|---|
shape | Shape | Loại hình dạng cần chèn. |
left | Number | Vị trí ngang của hình dạng, được đo từ góc trên bên trái của trang. |
top | Number | Vị trí dọc của hình dạng, được đo từ góc trên bên trái của trang. |
width | Number | Chiều rộng của hình dạng. |
height | Number | Chiều cao của hình dạng. |
Cầu thủ trả bóng
Shape
– Hình dạng được chèn.
Ủ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
insert Sheets Chart(sourceChart)
Chèn biểu đồ trên Google Trang tính vào trang.
Biểu đồ được chèn với kích thước mặc định ở góc trên cùng bên trái của trang.
Biểu đồ được chèn được liên kết với biểu đồ nguồn trên Google Trang tính, cho phép bạn cập nhật biểu đồ đó. Những cộng tác viên khác có thể thấy đường liên kết đến bảng tính nguồn.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChart(chart);
Tham số
Tên | Loại | Mô tả |
---|---|---|
source | Embedded | Biểu đồ trong bảng tính cần được chèn vào trang. |
Cầu thủ trả bóng
Sheets
– Biểu đồ đã chèn trong 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
insert Sheets Chart(sourceChart, left, top, width, height)
Chèn một biểu đồ trên Google Trang tính vào trang với vị trí và kích thước được cung cấp.
Để duy trì tỷ lệ khung hình của biểu đồ, biểu đồ được điều chỉnh theo tỷ lệ và căn giữa theo kích thước đã cung cấp.
Biểu đồ được chèn được liên kết với biểu đồ nguồn trên Google Trang tính, cho phép bạn cập nhật biểu đồ đó. Những cộng tác viên khác có thể thấy đường liên kết đến bảng tính nguồn.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const position = { left: 0, top: 0 }; const size = { width: 200, height: 200 }; // Also available for Layout, Master, and Page. slide.insertSheetsChart( chart, position.left, position.top, size.width, size.height, );
Tham số
Tên | Loại | Mô tả |
---|---|---|
source | Embedded | Biểu đồ trong bảng tính cần được chèn vào trang. |
left | Number | Vị trí theo chiều ngang của biểu đồ tính bằng điểm, được đo từ góc trên cùng bên trái của trang. |
top | Number | Vị trí dọc của biểu đồ tính bằng điểm, đo từ góc trên bên trái của trang. |
width | Number | Chiều rộng của biểu đồ tính bằng điểm. |
height | Number | Chiều cao của biểu đồ tính bằng điểm. |
Cầu thủ trả bóng
Sheets
– Biểu đồ đã chèn trong 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
insert Sheets Chart(sheetsChart)
Chèn một bản sao của Sheets
được cung cấp trên trang.
Vị trí của phần tử được chèn trên trang này được xác định từ vị trí của phần tử nguồn trên trang tương ứng.
Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ trong bản trình bày hiện tại, thì các thuộc tính kế thừa từ trang chính hoặc trang bố cục cũng kế thừa trên phần tử được chèn.
Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ một bản trình bày khác, thì các thuộc tính kế thừa từ trang tổng thể hoặc trang bố cục sẽ được sao chép vào phần tử từ bản trình bày nguồn.
// Copy a sheets chart between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const sheetsChart = otherPresentationSlide.getSheetsCharts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertSheetsChart(sheetsChart);
Tham số
Tên | Loại | Mô tả |
---|---|---|
sheets | Sheets | Biểu đồ trên trang tính cần sao chép và chèn. |
Cầu thủ trả bóng
Sheets
– Biểu đồ trang tính đã chèn.
Ủ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
insert Sheets ChartAsImage(sourceChart)
Chèn biểu đồ Google Trang tính dưới dạng Image
trên trang.
Hình ảnh của biểu đồ được chèn với kích thước mặc định ở góc trên cùng bên trái của trang.
Hình ảnh biểu đồ được chèn không được liên kết với biểu đồ nguồn trên Google Trang tính.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChartAsImage( chart); // Also available for Layout, Master, and Page.
Tham số
Tên | Loại | Mô tả |
---|---|---|
source | Embedded | Biểu đồ trong bảng tính cần được chèn vào trang. |
Cầu thủ trả bóng
Image
– Hình ảnh được chèn của biểu đồ trong 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
insert Sheets ChartAsImage(sourceChart, left, top, width, height)
Chèn biểu đồ Google Trang tính dưới dạng Image
trên trang với vị trí và kích thước được cung cấp.
Để duy trì tỷ lệ khung hình của hình ảnh biểu đồ, hình ảnh được điều chỉnh theo tỷ lệ và căn giữa theo kích thước đã cung cấp.
Hình ảnh biểu đồ được chèn không được liên kết với biểu đồ nguồn trên Google Trang tính.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const position = { left: 0, top: 0 }; const size = { width: 200, height: 200 }; // Also available for Layout, Master, and Page. slide.insertSheetsChartAsImage( chart, position.left, position.right, size.width, size.height, );
Tham số
Tên | Loại | Mô tả |
---|---|---|
source | Embedded | Biểu đồ trong bảng tính cần được chèn vào trang. |
left | Number | Vị trí theo chiều ngang của biểu đồ tính bằng điểm, được đo từ góc trên cùng bên trái của trang. |
top | Number | Vị trí dọc của biểu đồ tính bằng điểm, đo từ góc trên bên trái của trang. |
width | Number | Chiều rộng của biểu đồ tính bằng điểm. |
height | Number | Chiều cao của biểu đồ tính bằng điểm. |
Cầu thủ trả bóng
Image
– Hình ảnh được chèn của biểu đồ trong 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
insert Table(numRows, numColumns)
Chèn một bảng trên trang.
Bảng được căn giữa trang với kích thước mặc định và các hàng và cột được phân bổ đều nhau.
Tham số
Tên | Loại | Mô tả |
---|---|---|
num | Integer | Số hàng trong bảng. |
num | Integer | Số lượng cột trong bảng. |
Cầu thủ trả bóng
Table
– Bảng đã chèn.
Ủ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
insert Table(numRows, numColumns, left, top, width, height)
Chèn một bảng trên trang với vị trí và kích thước được cung cấp.
Các hàng và cột được phân bổ đều trong bảng đã tạo.
Tham số
Tên | Loại | Mô tả |
---|---|---|
num | Integer | Số hàng trong bảng. |
num | Integer | Số lượng cột trong bảng. |
left | Number | Vị trí ngang của bảng, được đo từ góc trên bên trái của trang. |
top | Number | Vị trí dọc của bảng, được đo từ góc trên bên trái của trang. |
width | Number | Chiều rộng của bảng. |
height | Number | Chiều cao tối thiểu của bảng. Chiều cao thực tế của bảng được hiển thị phụ thuộc vào các yếu tố như kích thước phông chữ văn bản. |
Cầu thủ trả bóng
Table
– Bảng đã chèn.
Ủ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
insert Table(table)
Chèn một bản sao của Table
được cung cấp trên trang.
Vị trí của phần tử được chèn trên trang này được xác định từ vị trí của phần tử nguồn trên trang tương ứng.
Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ trong bản trình bày hiện tại, thì các thuộc tính kế thừa từ trang chính hoặc trang bố cục cũng kế thừa trên phần tử được chèn.
Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ một bản trình bày khác, thì các thuộc tính kế thừa từ trang tổng thể hoặc trang bố cục sẽ được sao chép vào phần tử từ bản trình bày nguồn.
// Copy a table between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const table = otherPresentationSlide.getTables[0]; currentPresentationSlide.insertTable( table); // Also available for Layout, Master, and Page.
Tham số
Tên | Loại | Mô tả |
---|---|---|
table | Table | Bảng cần sao chép và chèn. |
Cầu thủ trả bóng
Table
– Bảng đã chèn.
Ủ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
insert Text Box(text)
Chèn một hộp văn bản Shape
chứa chuỗi được cung cấp trên trang.
Hình dạng hộp văn bản được chèn với kích thước mặc định ở góc trên cùng bên trái của trang.
// Insert text box with "Hello" on the first slide of presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox('Hello'); // Also available for Layout, Master, and Page.
Tham số
Tên | Loại | Mô tả |
---|---|---|
text | String | Chuỗi mà hình dạng hộp văn bản phải chứa. |
Cầu thủ trả bóng
Shape
– Hình dạng hộp văn bản đã chèn.
Ủ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
insert Text Box(text, left, top, width, height)
Chèn một hộp văn bản Shape
chứa chuỗi được cung cấp trên trang.
// Insert text box with "Hello" on the first slide of presentation. This text // box is a square with a length of 10 points on each side. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox( 'Hello', 0, 0, 10, 10); // Also available for Layout, Master, and Page.
Tham số
Tên | Loại | Mô tả |
---|---|---|
text | String | Chuỗi mà hình dạng hộp văn bản phải chứa. |
left | Number | Vị trí theo chiều ngang của hình dạng hộp văn bản, được đo từ góc trên bên trái của trang. |
top | Number | Vị trí dọc của hình dạng hộp văn bản, được đo từ góc trên bên trái của trang. |
width | Number | Chiều rộng của hình dạng hộp văn bản. |
height | Number | Chiều cao của hình dạng hộp văn bản. |
Cầu thủ trả bóng
Shape
– Hình dạng hộp văn bản đã chèn.
Ủ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
insert Video(videoUrl)
Chèn một video ở góc trên cùng bên trái của trang với kích thước mặc định.
Hiện tại, chỉ những video trên YouTube mới được hỗ trợ.
Tham số
Tên | Loại | Mô tả |
---|---|---|
video | String | URL của video cần chèn. |
Cầu thủ trả bóng
Video
– Video được chèn.
Ủ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
insert Video(videoUrl, left, top, width, height)
Chèn một video trên trang với vị trí và kích thước được cung cấp.
Hiện tại, chỉ những video trên YouTube mới được hỗ trợ.
Tham số
Tên | Loại | Mô tả |
---|---|---|
video | String | URL của video cần chèn. |
left | Number | Vị trí ngang của video tính bằng điểm, được đo từ góc trên bên trái của trang. |
top | Number | Vị trí dọc của video tính bằng điểm, đo từ góc trên bên trái của trang. |
width | Number | Chiều rộng của video tính bằng điểm. |
height | Number | Chiều cao của video tính bằng điểm. |
Cầu thủ trả bóng
Video
– Video được chèn.
Ủ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
insert Video(video)
Chèn một bản sao của Video
được cung cấp trên trang.
Vị trí của phần tử được chèn trên trang này được xác định từ vị trí của phần tử nguồn trên trang tương ứng.
Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ trong bản trình bày hiện tại, thì các thuộc tính kế thừa từ trang chính hoặc trang bố cục cũng kế thừa trên phần tử được chèn.
Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ một bản trình bày khác, thì các thuộc tính kế thừa từ trang tổng thể hoặc trang bố cục sẽ được sao chép vào phần tử từ bản trình bày nguồn.
// Copy a video between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const video = otherPresentationSlide.getVideos[0]; currentPresentationSlide.insertVideo( video); // Also available for Layout, Master, and Page.
Tham số
Tên | Loại | Mô tả |
---|---|---|
video | Video | Video cần sao chép và chèn. |
Cầu thủ trả bóng
Video
– Video được chèn.
Ủ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
insert Word Art(wordArt)
Chèn một bản sao của Word
được cung cấp trên trang.
Vị trí của phần tử được chèn trên trang này được xác định từ vị trí của phần tử nguồn trên trang tương ứng.
Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ trong bản trình bày hiện tại, thì các thuộc tính kế thừa từ trang chính hoặc trang bố cục cũng kế thừa trên phần tử được chèn.
Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ một bản trình bày khác, thì các thuộc tính kế thừa từ trang tổng thể hoặc trang bố cục sẽ được sao chép vào phần tử từ bản trình bày nguồn.
// Copy a word art between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const wordArt = otherPresentationSlide.getWordArts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertWordArt(wordArt);
Tham số
Tên | Loại | Mô tả |
---|---|---|
word | Word | Nhóm cần sao chép và chèn. |
Cầu thủ trả bóng
Word
– Chữ nghệ thuật đã chèn.
Ủ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á 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
replace All Text(findText, replaceText)
Thay thế tất cả các bản sao của văn bản khớp với văn bản tìm kiếm bằng văn bản thay thế. Tìm kiếm không phân biệt chữ hoa chữ thường.
Tham số
Tên | Loại | Mô tả |
---|---|---|
find | String | Văn bản cần tìm. |
replace | String | Văn bản thay thế văn bản đã khớp. |
Cầu thủ trả bóng
Integer
– số lần xuất hiện đã thay đổ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
replace All Text(findText, replaceText, matchCase)
Thay thế tất cả các bản sao của văn bản khớp với văn bản tìm kiếm bằng văn bản thay thế.
Tham số
Tên | Loại | Mô tả |
---|---|---|
find | String | Văn bản cần tìm. |
replace | String | Văn bản thay thế văn bản đã khớp. |
match | Boolean | Nếu là true , thì tính năng tìm kiếm sẽ phân biệt chữ hoa chữ thường; nếu là false , thì tính năng tìm kiếm sẽ không phân biệt chữ hoa chữ thường. |
Cầu thủ trả bóng
Integer
– số lần xuất hiện đã thay đổ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 As Current Page()
Chọn Page
trong bản trình bày đang hoạt động làm current page selection
và xoá mọi lựa chọn trước đó.
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.
// Select the first slide as the current page selection and replace any previous // selection. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.selectAsCurrentPage(); // Also available for Layout, Master, and Page.
Ủ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