Kiểu văn bản.
Các phương thức đọc trong lớp này trả về null nếu Text tương ứng trải dài trên nhiều lần chạy văn bản và các lần chạy đó có các giá trị khác nhau cho phương thức đọc đang được gọi. Để tránh điều này, hãy truy vấn kiểu văn bản bằng cách sử dụng Text do phương thức Text trả về.
Nếu bạn sử dụng các phương thức chỉnh sửa cách văn bản vừa với một hình dạng, thì mọi chế độ cài đặt tự động điều chỉnh áp dụng cho kiểu văn bản sẽ bị vô hiệu hoá.
Phương thức
| Phương thức | Loại dữ liệu trả về | Mô tả ngắn | 
|---|---|---|
| get | Color | Trả về màu nền của văn bản hoặc nullnếu có nhiều kiểu trên văn bản. | 
| get | Text | Trả về độ dời theo chiều dọc của văn bản so với vị trí thông thường hoặc nullnếu có nhiều kiểu trên văn bản. | 
| get | String | Trả về bộ phông chữ của văn bản hoặc nullnếu có nhiều kiểu trên văn bản. | 
| get | Number | Trả về cỡ chữ của văn bản theo điểm hoặc nullnếu có nhiều kiểu trên văn bản. | 
| get | Integer | Trả về độ đậm của phông chữ hoặc nullnếu văn bản có nhiều kiểu. | 
| get | Color | Trả về màu nền trước của văn bản hoặc nullnếu có nhiều kiểu trên văn bản. | 
| get | Link | Trả về Linktrên văn bản hoặcnullnếu không có đường liên kết hoặc nếu đường liên kết nằm trên một phần của văn bản hoặc nếu có nhiều đường liên kết. | 
| has | Boolean | Trả về truenếu có đường liên kết trên văn bản,falsenếu không có hoặcnullnếu đường liên kết nằm trên một phần của văn bản hoặc có nhiều đường liên kết. | 
| is | Boolean | Trả về truenếu nền của văn bản là trong suốt,falsenếu không hoặcnullnếu có nhiều kiểu trên văn bản. | 
| is | Boolean | Trả về truenếu văn bản được hiển thị dưới dạng in đậm,falsenếu không hoặcnullnếu có nhiều kiểu trên văn bản. | 
| is | Boolean | Trả về truenếu văn bản được in nghiêng,falsenếu không hoặcnullnếu có nhiều kiểu trên văn bản. | 
| is | Boolean | Trả về truenếu văn bản viết bằng chữ hoa thường,falsenếu không hoặcnullnếu có nhiều kiểu trên văn bản. | 
| is | Boolean | Trả về truenếu văn bản bị gạch ngang,falsenếu không hoặcnullnếu có nhiều kiểu trên văn bản. | 
| is | Boolean | Trả về truenếu văn bản được gạch chân,falsenếu không hoặcnullnếu có nhiều kiểu trên văn bản. | 
| remove | Text | Xoá Link. | 
| set | Text | Đặt màu nền của văn bản. | 
| set | Text | Đặt màu nền của văn bản thành các giá trị RGB đã cho từ 0 đến 255. | 
| set | Text | Đặt màu nền của văn bản thành chuỗi màu hex đã cho. | 
| set | Text | Đặt màu nền của văn bản thành Themeđã cho. | 
| set | Text | Đặt màu nền của văn bản thành trong suốt. | 
| set | Text | Đặt độ dời theo chiều dọc của văn bản so với vị trí thông thường. | 
| set | Text | Đặt xem văn bản có được hiển thị ở dạng in đậm hay không. | 
| set | Text | Đặt bộ phông chữ của văn bản . | 
| set | Text | Đặt bộ phông chữ và độ đậm của văn bản. | 
| set | Text | Đặt cỡ chữ của văn bản, tính bằng điểm. | 
| set | Text | Đặt màu nền trước của văn bản. | 
| set | Text | Đặt màu nền trước của văn bản thành các giá trị RGB đã cho từ 0 đến 255. | 
| set | Text | Đặt màu nền trước của văn bản thành chuỗi màu hex đã cho. | 
| set | Text | Đặt màu nền trước của văn bản thành Themeđã cho. | 
| set | Text | Đặt xem văn bản có in nghiêng hay không. | 
| set | Text | Đặt LinkthànhSlideđã cho bằng cách sử dụng chỉ mục dựa trên 0 của trang trình bày. | 
| set | Text | Đặt LinkthànhSlideđã cho, đường liên kết được đặt theo mã nhận dạng trang trình bày đã cho. | 
| set | Text | Đặt LinkthànhSlideđã cho bằng cách sử dụng vị trí tương đối của trang trình bày. | 
| set | Text | Đặt Linkthành chuỗi URL không trống đã cho. | 
| set | Text | Đặt xem văn bản có được hiển thị bằng chữ thường viết hoa hay không. | 
| set | Text | Đặt xem văn bản có bị gạch ngang hay không. | 
| set | Text | Đặt xem văn bản có được gạch dưới hay không. | 
Tài liệu chi tiết
get
get
Trả về độ dời theo chiều dọc của văn bản so với vị trí thông thường hoặc null nếu có nhiều kiểu trên văn bản.
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
Trả về bộ phông chữ của văn bản hoặc null nếu có nhiều kiểu trên văn bả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
Trả về cỡ chữ của văn bản theo điểm hoặc null nếu có nhiều kiểu trên văn bản.
Cầu thủ trả bóng
Number
Ủ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
Trả về độ đậm của phông chữ của văn bản hoặc null nếu có nhiều kiểu trên văn bản.
Trọng số là bội số của 100, từ 100 đến 900 (tính cả 2 giá trị đầu cuối). Phạm vi này tương ứng với các giá trị số được mô tả trong Quy cách CSS 2.1, phần 15.6, với các giá trị không phải số không được phép. Độ đậm lớn hơn hoặc bằng 700 được coi là đậm, trong trường hợp này, is sẽ trả về true. Giá trị mặc định là 400
("bình thường").
Cầu thủ trả bóng
Integer
Ủ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
Trả về màu nền trước của văn bản hoặc null nếu có nhiều kiểu trên văn bản.
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
Trả về Link trên văn bản hoặc null nếu không có đường liên kết hoặc nếu đường liên kết nằm trên một phần của văn bản hoặc nếu có nhiều đường liên kết. Gọi has để xác định xem văn bản có liên kết hay không.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; const textLink = shape.getText().getTextStyle().getLink(); if (textLink != null) { Logger.log(`Shape text has a link of type: ${textLink.getLinkType()}`); }
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
has
Trả về true nếu có đường liên kết trên văn bản, false nếu không có hoặc null nếu đường liên kết nằm trên một phần của văn bản hoặc có nhiều đường liên kết.
Không thể đặt đường liên kết trên ký tự dòng mới. Do đó, nếu Text chứa ký tự dòng mới, phương thức này sẽ luôn trả về null hoặc false.
Cầu thủ trả bóng
Boolean
Ủ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
is
Trả về true nếu nền của văn bản là trong suốt, false nếu không hoặc null nếu có nhiều kiểu trên văn bản.
Cầu thủ trả bóng
Boolean
Ủ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
is
Trả về true nếu văn bản được hiển thị dưới dạng in đậm, false nếu không hoặc null nếu có nhiều kiểu trên văn bản.
Cầu thủ trả bóng
Boolean
Ủ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
is
Trả về true nếu văn bản được in nghiêng, false nếu không hoặc null nếu có nhiều kiểu trên văn bản.
Cầu thủ trả bóng
Boolean
Ủ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
is
Trả về true nếu văn bản viết bằng chữ thường, false nếu không hoặc null nếu có nhiều kiểu trên văn bản.
Cầu thủ trả bóng
Boolean
Ủ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
is
Trả về true nếu văn bản bị gạch ngang, false nếu không hoặc null nếu có nhiều kiểu trên văn bản.
Cầu thủ trả bóng
Boolean
Ủ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
is
Trả về true nếu văn bản được gạch chân, false nếu không hoặc null nếu có nhiều kiểu trên văn bản.
Cầu thủ trả bóng
Boolean
Ủ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á Link.
Việc xoá đường liên kết sẽ xoá màu nền trước của siêu liên kết và kiểu gạch chân trên văn bản. Nếu có thể, các kiểu này sẽ được áp dụng để khớp với văn bản đứng trước đường liên kết.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText(); textRange.getTextStyle().removeLink();
Cầu thủ trả bóng
set
set
Đặt màu nền của văn bản thành các giá trị RGB đã cho từ 0 đến 255.
Tham số
| Tên | Loại | Mô tả | 
|---|---|---|
| red | Integer | |
| green | Integer | |
| blue | 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
set
Đặt màu nền của văn bản thành chuỗi màu hex đã cho.
Chuỗi thập lục phân phải ở định dạng "#RRGGBB". Ví dụ: màu hồng sẽ được biểu thị là "#FFC0CB".
Tham số
| Tên | Loại | Mô tả | 
|---|---|---|
| hex | String | 
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
set
Đặt màu nền của văn bản thành Theme đã cho.
Tham số
| Tên | Loại | Mô tả | 
|---|---|---|
| color | Theme | 
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
set
set
Đặt độ dời theo chiều dọc của văn bản so với vị trí thông thường.
Tham số
| Tên | Loại | Mô tả | 
|---|---|---|
| offset | Text | 
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
set
Đặt xem văn bản có được hiển thị ở dạng in đậm hay không.
Việc thay đổi độ đậm của văn bản sẽ cập nhật độ đậm phông chữ dùng để hiển thị văn bản.
Tham số
| Tên | Loại | Mô tả | 
|---|---|---|
| bold | Boolean | 
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
set
set
Đặt bộ phông chữ và độ đậm của văn bản.
Trọng số là bội số của 100, từ 100 đến 900 (tính cả 2 giá trị đầu cuối). Phạm vi này tương ứng với các giá trị số được mô tả trong Quy cách CSS 2.1, phần 15.6, với các giá trị không phải số không được phép. Độ đậm lớn hơn hoặc bằng 700 được coi là đậm, trong trường hợp này, is sẽ trả về true. Giá trị mặc định là 400
("bình thường").
Tham số
| Tên | Loại | Mô tả | 
|---|---|---|
| font | String | |
| font | 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
set
Đặt cỡ chữ của văn bản, tính bằng điểm.
Tham số
| Tên | Loại | Mô tả | 
|---|---|---|
| font | Number | 
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
set
set
Đặt màu nền trước của văn bản thành các giá trị RGB đã cho từ 0 đến 255.
Tham số
| Tên | Loại | Mô tả | 
|---|---|---|
| red | Integer | |
| green | Integer | |
| blue | 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
set
Đặt màu nền trước của văn bản thành chuỗi màu hex đã cho.
Chuỗi thập lục phân phải ở định dạng "#RRGGBB". Ví dụ: màu hồng sẽ được biểu thị là "#FFC0CB".
Tham số
| Tên | Loại | Mô tả | 
|---|---|---|
| hex | String | 
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
set
Đặt màu nền trước của văn bản thành Theme đã cho.
Tham số
| Tên | Loại | Mô tả | 
|---|---|---|
| color | Theme | 
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
set
Đặt xem văn bản có in nghiêng hay không.
Tham số
| Tên | Loại | Mô tả | 
|---|---|---|
| italic | Boolean | 
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
set
Đặ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.
Việc đặt đường liên kết sẽ thay đổi kiểu của văn bản thành gạch dưới và có màu nền trước Theme. Bạn có thể thay đổi chế độ này thông qua set và set.
Vì không thể đặt đường liên kết trên ký tự dòng mới, nên các ký tự dòng mới trong Text sẽ bị bỏ qua.
// Set a link to the first slide of the presentation. const presentation = SlidesApp.getActivePresentation(); const slide = presentation.getSlides()[0]; const textRange = slide.getShapes()[0].getText(); textRange.getTextStyle().setLinkSlide(0);
Tham số
| Tên | Loại | Mô tả | 
|---|---|---|
| slide | Integer | Chỉ mục dựa trên 0 của trang trình bày. | 
Cầu thủ trả bóng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
Đặ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.
Việc đặt đường liên kết sẽ thay đổi kiểu của văn bản thành gạch dưới và có màu nền trước Theme. Bạn có thể thay đổi chế độ này thông qua set và set.
Vì không thể đặt đường liên kết trên ký tự dòng mới, nên các ký tự dòng mới trong Text sẽ bị bỏ qua.
// Set a link to the first slide of the presentation. const presentation = SlidesApp.getActivePresentation(); const slide = presentation.getSlides()[0]; const textRange = slide.getShapes()[0].getText(); textRange.getTextStyle().setLinkSlide(slide);
Tham số
| Tên | Loại | Mô tả | 
|---|---|---|
| slide | Slide | Slidecần được liên kết. | 
Cầu thủ trả bóng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
Đặ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.
Việc đặt đường liên kết sẽ thay đổi kiểu của văn bản thành gạch dưới và có màu nền trước Theme. Bạn có thể thay đổi chế độ này thông qua set và set.
Vì không thể đặt đường liên kết trên ký tự dòng mới, nên các ký tự dòng mới trong Text sẽ bị bỏ qua.
// Set a link to the first slide of the presentation. const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText(); textRange.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
Tham số
| Tên | Loại | Mô tả | 
|---|---|---|
| slide | Slide | Slidetương đối. | 
Cầu thủ trả bóng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
Đặt Link thành chuỗi URL không trống đã cho.
Việc đặt đường liên kết sẽ thay đổi kiểu của văn bản thành gạch dưới và có màu nền trước Theme. Bạn có thể thay đổi chế độ này thông qua set và set.
Vì không thể đặt đường liên kết trên ký tự dòng mới, nên các ký tự dòng mới trong Text sẽ bị bỏ qua.
// Set a link to the URL. const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText(); textRange.getTextStyle().setLinkUrl('https://slides.google.com');
Tham số
| Tên | Loại | Mô tả | 
|---|---|---|
| url | String | Chuỗi URL. | 
Cầu thủ trả bóng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
Đặt xem văn bản có được hiển thị bằng chữ thường viết hoa hay không.
Tham số
| Tên | Loại | Mô tả | 
|---|---|---|
| small | Boolean | 
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
set
Đặt xem văn bản có bị gạch ngang hay không.
Tham số
| Tên | Loại | Mô tả | 
|---|---|---|
| strikethrough | Boolean | 
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
set
Đặt xem văn bản có được gạch dưới hay không.
Tham số
| Tên | Loại | Mô tả | 
|---|---|---|
| underline | Boolean | 
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