Kiểu văn bản.
Các phương thức đọc trong lớp này sẽ trả về null nếu Text tương ứng trải dài trên nhiều đoạn văn bản và các đoạn đó có các giá trị khác nhau cho phương thức đọc đang được gọi. Để tránh trường hợp 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 kích thước được áp dụng cho kiểu văn bản sẽ bị vô hiệu hoá.
Phương thức
| Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
|---|---|---|
get | Color|null | Trả về màu nền của văn bản hoặc null nếu văn bản có nhiều kiểu. |
get | Text | Trả về độ lệch dọc của văn bản so với vị trí bình thường hoặc null nếu văn bản có nhiều kiểu. |
get | String|null | Trả về họ phông chữ của văn bản hoặc null nếu văn bản có nhiều kiểu. |
get | Number|null | Trả về cỡ chữ của văn bản tính bằng điểm hoặc null nếu văn bản có nhiều kiểu. |
get | Integer|null | Trả về độ đậm của phông chữ trong văn bản hoặc null nếu văn bản có nhiều kiểu. |
get | Color|null | Trả về màu nền trước của văn bản hoặc null nếu văn bản có nhiều kiểu. |
get | Link|null | 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. |
has | Boolean|null | 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 văn bản hoặc có nhiều đường liên kết. |
is | Boolean|null | Trả về true nếu nền của văn bản trong suốt, false nếu không hoặc null nếu văn bản có nhiều kiểu. |
is | Boolean|null | Trả về true nếu văn bản được hiển thị dưới dạng chữ đậm, false nếu không hoặc null nếu văn bản có nhiều kiểu. |
is | Boolean|null | Trả về true nếu văn bản được in nghiêng, false nếu không hoặc null nếu văn bản có nhiều kiểu. |
is | Boolean|null | Trả về true nếu văn bản có chữ hoa nhỏ, false nếu không hoặc null nếu văn bản có nhiều kiểu. |
is | Boolean|null | Trả về true nếu văn bản bị gạch ngang, false nếu không hoặc null nếu văn bản có nhiều kiểu. |
is | Boolean|null | Trả về true nếu văn bản được gạch chân, false nếu không hoặc null nếu văn bản có nhiều kiểu. |
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 độ lệch 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ữ cho 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 tiền cảnh 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ó được in nghiêng hay không. |
set | Text | Đặ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 | Text | Đặ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 | Text | Đặ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 | Text | Đặt một Link thà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ữ hoa nhỏ 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 Background Color()
get Baseline Offset()
Trả về độ lệch dọc của văn bản so với vị trí bình thường hoặc null nếu văn bản có nhiều kiểu.
Cầu thủ trả bóng
Text
Ủ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
get Font Family()
Trả về họ phông chữ của văn bản hoặc null nếu văn bản có nhiều kiểu.
Cầu thủ trả bóng
String|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
get Font Size()
Trả về cỡ chữ của văn bản tính bằng điểm hoặc null nếu văn bản có nhiều kiểu.
Cầu thủ trả bóng
Number|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
get Font Weight()
Trả về độ đậm của phông chữ trong văn bản hoặc null nếu văn bản có nhiều kiểu.
Trọng lượng 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ị bằng số được mô tả trong Quy cách CSS 2.1, mục 15.6, trong đó các giá trị không phải bằng số không được phép. Trọng số lớn hơn hoặc bằng 700 được coi là đậm, trong trường hợp đó, is sẽ trả về true. Giá trị mặc định là 400 ("normal").
Cầu thủ trả bóng
Integer|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
get Foreground Color()
Trả về màu nền trước của văn bản hoặc null nếu văn bản có nhiều kiểu.
Cầu thủ trả bóng
Color|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
get Link()
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
Link|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
has Link()
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 văn bản hoặc có nhiều đường liên kết.
Bạn 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 luôn trả về null hoặc false.
Cầu thủ trả bóng
Boolean|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
is Background Transparent()
Trả về true nếu nền của văn bản trong suốt, false nếu không hoặc null nếu văn bản có nhiều kiểu.
Cầu thủ trả bóng
Boolean|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
is Bold()
Trả về true nếu văn bản được hiển thị dưới dạng chữ đậm, false nếu không hoặc null nếu văn bản có nhiều kiểu.
Cầu thủ trả bóng
Boolean|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
is Italic()
Trả về true nếu văn bản được in nghiêng, false nếu không hoặc null nếu văn bản có nhiều kiểu.
Cầu thủ trả bóng
Boolean|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
is Small Caps()
Trả về true nếu văn bản có chữ hoa nhỏ, false nếu không hoặc null nếu văn bản có nhiều kiểu.
Cầu thủ trả bóng
Boolean|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
is Strikethrough()
Trả về true nếu văn bản bị gạch ngang, false nếu không hoặc null nếu văn bản có nhiều kiểu.
Cầu thủ trả bóng
Boolean|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
is Underline()
Trả về true nếu văn bản được gạch chân, false nếu không hoặc null nếu văn bản có nhiều kiểu.
Cầu thủ trả bóng
Boolean|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
remove Link()
Xoá Link.
Khi bạn xoá một đường liên kết, 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 sẽ bị xoá. 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 Background Color(color)
set Background Color(red, green, blue)
Đặt màu nền của văn bản thành các giá trị RGB đã cho từ 0 đến 255.
Thông 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 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
set Background Color(hexColor)
Đặ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 có định dạng "#RRGGBB". Ví dụ: màu hồng sẽ được biểu thị là "#FFC0CB".
Thông 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 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
set Background Color(color)
Đặt màu nền của văn bản thành Theme đã cho.
Thông 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 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
set Background Color Transparent()
set Baseline Offset(offset)
Đặt độ lệch dọc của văn bản so với vị trí thông thường.
Thông 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 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
set Bold(bold)
Đặt xem văn bản có được hiển thị ở dạng in đậm hay không.
Khi bạn thay đổi độ đậm của văn bản, độ đậm của phông chữ dùng để hiển thị văn bản cũng sẽ thay đổi.
Thông 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 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
set Font Family(fontFamily)
Đặt bộ phông chữ cho văn bản .
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
font | 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 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
set Font Family And Weight(fontFamily, fontWeight)
Đặt bộ phông chữ và độ đậm của văn bản.
Trọng lượng 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ị bằng số được mô tả trong Quy cách CSS 2.1, mục 15.6, trong đó các giá trị không phải bằng số không được phép. Trọng số lớn hơn hoặc bằng 700 được coi là đậm, trong trường hợp đó, is sẽ trả về true. Giá trị mặc định là 400 ("normal").
Thông 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 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
set Font Size(fontSize)
Đặt cỡ chữ của văn bản, tính bằng điểm.
Thông 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 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
set Foreground Color(foregroundColor)
set Foreground Color(red, green, blue)
Đặ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.
Thông 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 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
set Foreground Color(hexColor)
Đặt màu tiền cảnh của văn bản thành chuỗi màu hex đã cho.
Chuỗi thập lục phân phải có định dạng "#RRGGBB". Ví dụ: màu hồng sẽ được biểu thị là "#FFC0CB".
Thông 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 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
set Foreground Color(color)
Đặt màu nền trước của văn bản thành Theme đã cho.
Thông 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 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
set Italic(italic)
Đặt xem văn bản có được in nghiêng hay không.
Thông 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 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
set Link Slide(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.
Việc đặt một đường liên kết sẽ thay đổi kiểu của văn bản thành gạch chân 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ì bạn không thể đặt đường liên kết trên ký tự dòng mới, nên 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);
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
slide | Integer | Chỉ mục bắt đầu từ 0 cho 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 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
set Link Slide(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.
Việc đặt một đường liên kết sẽ thay đổi kiểu của văn bản thành gạch chân 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ì bạn không thể đặt đường liên kết trên ký tự dòng mới, nên 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);
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
slide | Slide | Slide cần 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 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
set Link Slide(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.
Việc đặt một đường liên kết sẽ thay đổi kiểu của văn bản thành gạch chân 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ì bạn không thể đặt đường liên kết trên ký tự dòng mới, nên 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);
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
slide | Slide | Slide tươ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 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
set Link Url(url)
Đặt một Link thành chuỗi URL không trống đã cho.
Việc đặt một đường liên kết sẽ thay đổi kiểu của văn bản thành gạch chân 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ì bạn không thể đặt đường liên kết trên ký tự dòng mới, nên 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');
Thông 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 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
set Small Caps(smallCaps)
Đặt xem văn bản có được hiển thị bằng chữ hoa nhỏ hay không.
Thông 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 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
set Strikethrough(strikethrough)
Đặt xem văn bản có bị gạch ngang hay không.
Thông 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 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
set Underline(underline)
Đặt xem văn bản có được gạch dưới hay không.
Thông 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 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