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 null nế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 null nế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 null nế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 null nếu có nhiều kiểu trên văn bản. |
get | Integer | Trả về độ đậm của phông chữ hoặc null nế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 null nếu có nhiều kiểu trên văn bản. |
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. |
has | Boolean | 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. |
is | Boolean | 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. |
is | Boolean | 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. |
is | Boolean | 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. |
is | Boolean | Trả về true nếu văn bản viết bằng chữ hoa thường, false nếu không hoặc null nếu có nhiều kiểu trên văn bản. |
is | Boolean | 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. |
is | Boolean | 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. |
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 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 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 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ữ 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 Background Color()
get Baseline Offset()
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 Font Family()
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 Font Size()
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 Font Weight()
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 Foreground Color()
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 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
Ủ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 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 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 Background Transparent()
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 Bold()
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 Italic()
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 Small Caps()
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 Strikethrough()
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 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 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 Link()
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 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.
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 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 ở đị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 Background Color(color)
Đặ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 Background Color Transparent()
set Baseline Offset(offset)
Đặ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 Bold(bold)
Đặ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 Font Family(fontFamily)
set Font Family And Weight(fontFamily, fontWeight)
Đặ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 Font Size(fontSize)
Đặ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 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.
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 Foreground Color(hexColor)
Đặ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 Foreground Color(color)
Đặ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 Italic(italic)
Đặ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 Link Slide(slideIndex)
Đặ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 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 đườ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 | Slide cầ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 Link Slide(slidePosition)
Đặ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 | 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 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 Link Url(url)
Đặ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 Small Caps(smallCaps)
Đặ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 Strikethrough(strikethrough)
Đặ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 Underline(underline)
Đặ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