Kiểu văn bản.
Các phương thức đọc trong lớp này sẽ trả về null
nếu TextRange
tương ứng
nhiều văn bản chạy và các lần chạy đó có giá trị khác nhau cho phương thức đọc đang được gọi. Người nhận
để tránh điều này, hãy truy vấn kiểu văn bản bằng cách sử dụng TextRange
do phương thức TextRange.getRuns()
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 sẽ áp dụng cho đã huỷ kích hoạt kiểu văn bản này.
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
getBackgroundColor() | 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
. |
getBaselineOffset() | TextBaselineOffset | Trả về độ lệch dọc của văn bản từ vị trí thông thường hoặc null nếu có
nhiều kiểu trên văn bản. |
getFontFamily() | String | Trả về bộ phông chữ của văn bản hoặc null nếu có nhiều kiểu chữ trên văn bản. |
getFontSize() | Number | Trả về cỡ chữ của văn bản theo điểm hoặc null nếu có nhiều kiểu chữ trên
văn bản. |
getFontWeight() | Integer | Trả về độ đậm phông chữ của văn bản hoặc null nếu có nhiều kiểu chữ trên văn bản. |
getForegroundColor() | 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
. |
getLink() | Link | Trả về Link trên văn bản hoặc null nếu không có đường liên kết nào hoặc nếu đường liên kết đang bật
hoặc nếu có nhiều đường liên kết. |
hasLink() | 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
liên kết nằm trong một phần của văn bản hoặc có nhiều liên kết. |
isBackgroundTransparent() | Boolean | Trả về true nếu nền văn bản là trong suốt, false nếu nền không hoặc
null nếu có nhiều kiểu trên văn bản. |
isBold() | Boolean | Trả về true nếu văn bản được hiển thị ở dạng in đậm, false nếu không được hiển thị hoặc null nếu văn bản được hiển thị ở dạng in đậm.
có nhiều kiểu trên văn bản. |
isItalic() | 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ó
là nhiều kiểu trên văn bản. |
isSmallCaps() | Boolean | Trả về true nếu văn bản bằng chữ cái viết hoa nhỏ, false nếu không phải hoặc null nếu có nhiều kiểu chữ trên văn bản. |
isStrikethrough() | Boolean | Trả về true nếu văn bản bị gạch ngang, false nếu không bị gạch ngang hoặc null nếu
có nhiều kiểu trên văn bản. |
isUnderline() | Boolean | Trả về true nếu văn bản được gạch chân, false nếu không có hoặc null nếu có
là nhiều kiểu trên văn bản. |
removeLink() | TextStyle | Xoá một Link . |
setBackgroundColor(color) | TextStyle | Đặt màu nền cho văn bản. |
setBackgroundColor(red, green, blue) | TextStyle | Đặt màu nền của văn bản thành các giá trị RGB đã cho từ 0 đến 255. |
setBackgroundColor(hexColor) | TextStyle | Đặt màu nền của văn bản thành chuỗi màu hex đã cho. |
setBackgroundColor(color) | TextStyle | Đặt màu nền của văn bản thành ThemeColorType đã cho. |
setBackgroundColorTransparent() | TextStyle | Đặt màu nền của văn bản thành trong suốt. |
setBaselineOffset(offset) | TextStyle | Đặt độ lệch dọc của văn bản so với vị trí thông thường của văn bản đó. |
setBold(bold) | TextStyle | Đặt xem văn bản có hiển thị ở dạng in đậm hay không. |
setFontFamily(fontFamily) | TextStyle | Đặt bộ phông chữ của văn bản . |
setFontFamilyAndWeight(fontFamily, fontWeight) | TextStyle | Đặt bộ phông chữ và độ đậm của văn bản. |
setFontSize(fontSize) | TextStyle | Đặt cỡ chữ của văn bản tính bằng điểm. |
setForegroundColor(foregroundColor) | TextStyle | Đặt màu cho nền trước của văn bản. |
setForegroundColor(red, green, blue) | TextStyle | Đặ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. |
setForegroundColor(hexColor) | TextStyle | Đặt màu nền trước của văn bản thành chuỗi màu hex đã cho. |
setForegroundColor(color) | TextStyle | Đặt màu nền trước của văn bản thành ThemeColorType đã cho. |
setItalic(italic) | TextStyle | Thiết lập xem văn bản có in nghiêng hay không. |
setLinkSlide(slideIndex) | TextStyle | Đặt Link thành Slide cho sẵn bằng cách sử dụng chỉ mục từ 0 của trang trình bày. |
setLinkSlide(slide) | TextStyle | Đặt Link thành Slide cho sẵn. Đường liên kết sẽ do mã trang trình bày cụ thể đặt. |
setLinkSlide(slidePosition) | TextStyle | Đặt Link thành Slide cho sẵn bằng cách sử dụng vị trí tương đối của trang trình bày. |
setLinkUrl(url) | TextStyle | Đặt Link thành chuỗi URL không trống đã cho. |
setSmallCaps(smallCaps) | TextStyle | Đặt xem văn bản có hiển thị bằng chữ cái viết hoa nhỏ hay không. |
setStrikethrough(strikethrough) | TextStyle | Đặt văn bản có bị gạch ngang hay không. |
setUnderline(underline) | TextStyle | Đặt xem văn bản có được gạch chân hay không. |
Tài liệu chi tiết
getBackgroundColor()
getBaselineOffset()
Trả về độ lệch dọc của văn bản từ 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
getFontFamily()
Trả về bộ phông chữ của văn bản hoặc null
nếu có nhiều kiểu chữ trên văn bản.
Cầu thủ trả bóng
String
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
getFontSize()
Trả về cỡ chữ của văn bản theo điểm hoặc null
nếu có nhiều kiểu chữ trên
văn bản.
Cầu thủ trả bóng
Number
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
getFontWeight()
Trả về độ đậm phông chữ của văn bản hoặc null
nếu có nhiều kiểu chữ trên văn bản.
Trọng số là bội số của 100, từ 100 đến 900, gồm cả hai giá trị này. Phạm vi này tương ứng với
các giá trị bằng số được mô tả trong Thông số kỹ thuật CSS 2.1, mục 15.6, với
các giá trị không phải số không được phép. Các trọng số lớn hơn hoặc bằng 700 được xem là in đậm, theo
trường hợp nào isBold()
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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
getForegroundColor()
getLink()
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 đang bật
hoặc nếu có nhiều đường liên kết. Gọi hasLink()
để xác định xem
văn bản không có liên kết.
var 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
hasLink()
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
liên kết nằm trong một phần của văn bản hoặc có nhiều liên kết.
Không thể đặt đường liên kết trên các ký tự dòng mới. Do đó, nếu TextRange
chứa mã
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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
isBackgroundTransparent()
Trả về true
nếu nền văn bản là trong suốt, false
nếu nền 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
isBold()
Trả về true
nếu văn bản được hiển thị ở dạng in đậm, false
nếu không được hiển thị hoặc null
nếu văn bản được hiển thị dưới dạng in đậm.
có nhiều kiểu trên văn bản.
Cầu thủ trả bóng
Boolean
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
isItalic()
Trả về true
nếu văn bản được in nghiêng, false
nếu không hoặc null
nếu có
là nhiều kiểu trên văn bản.
Cầu thủ trả bóng
Boolean
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
isSmallCaps()
Trả về true
nếu văn bản bằng chữ cái viết hoa nhỏ, false
nếu không phải hoặc null
nếu có nhiều kiểu chữ trên văn bản.
Cầu thủ trả bóng
Boolean
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
isStrikethrough()
Trả về true
nếu văn bản bị gạch ngang, false
nếu không bị gạch ngang 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
isUnderline()
Trả về true
nếu văn bản được gạch chân, false
nếu không có hoặc null
nếu có
là nhiều kiểu trên văn bản.
Cầu thủ trả bóng
Boolean
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
removeLink()
setBackgroundColor(color)
setBackgroundColor(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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
setBackgroundColor(hexColor)
Đặt màu nền của văn bản thành chuỗi màu hex đã cho.
Chuỗi hex phải có đị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ả |
---|---|---|
hexColor | String |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
setBackgroundColor(color)
Đặt màu nền của văn bản thành ThemeColorType
đã cho.
Tham số
Tên | Loại | Mô tả |
---|---|---|
color | ThemeColorType |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
setBackgroundColorTransparent()
setBaselineOffset(offset)
Đặt độ lệch dọc của văn bản so với vị trí thông thường của văn bản đó.
Tham số
Tên | Loại | Mô tả |
---|---|---|
offset | TextBaselineOffset |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
setBold(bold)
Đặt xem văn bản 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
setFontFamily(fontFamily)
setFontFamilyAndWeight(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, gồm cả hai giá trị này. Phạm vi này tương ứng với
các giá trị bằng số được mô tả trong Thông số kỹ thuật CSS 2.1, mục 15.6, với
các giá trị không phải số không được phép. Các trọng số lớn hơn hoặc bằng 700 được xem là in đậm, theo
trường hợp nào isBold()
sẽ trả về true
. Giá trị mặc định là 400
("bình thường").
Tham số
Tên | Loại | Mô tả |
---|---|---|
fontFamily | String | |
fontWeight | Integer |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
setFontSize(fontSize)
setForegroundColor(foregroundColor)
setForegroundColor(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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
setForegroundColor(hexColor)
Đặt màu nền trước của văn bản thành chuỗi màu hex đã cho.
Chuỗi hex phải có đị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ả |
---|---|---|
hexColor | String |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
setForegroundColor(color)
Đặt màu nền trước của văn bản thành ThemeColorType
đã cho.
Tham số
Tên | Loại | Mô tả |
---|---|---|
color | ThemeColorType |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
setItalic(italic)
Thiết lập 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
setLinkSlide(slideIndex)
Đặt Link
thành Slide
cho sẵn bằng cách sử dụng chỉ mục từ 0 của trang trình bày.
Việc đặt đường liên kết sẽ thay đổi kiểu văn bản được gạch chân và có màu nền trước là ThemeColorType.HYPERLINK
. Bạn có thể thay đổi chế độ này thông qua setForegroundColor(hexColor)
và setUnderline(underline)
.
Do không thể đặt đường liên kết trên các ký tự dòng mới, nên các ký tự dòng mới trong TextRange
sẽ bị bỏ qua.
// Set a link to the first slide of the presentation. text.getTextStyle().setLinkSlide(0);
Tham số
Tên | Loại | Mô tả |
---|---|---|
slideIndex | Integer | Chỉ mục (bắt đầu đếm từ 0) cho trang trình bày. |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
setLinkSlide(slide)
Đặt Link
thành Slide
cho sẵn. Đường liên kết sẽ do mã trang trình bày cụ thể đặt.
Việc đặt đường liên kết sẽ thay đổi kiểu văn bản được gạch chân và có màu nền trước là ThemeColorType.HYPERLINK
. Bạn có thể thay đổi chế độ này thông qua setForegroundColor(hexColor)
và setUnderline(underline)
.
Do không thể đặt đường liên kết trên các ký tự dòng mới, nên các ký tự dòng mới trong TextRange
sẽ bị bỏ qua.
// Set a link to the first slide of the presentation. var slide = presentation.getSlides()[0]; text.getTextStyle().setLinkSlide(slide);
Tham 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
setLinkSlide(slidePosition)
Đặt Link
thành Slide
cho sẵn 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 văn bản được gạch chân và có màu nền trước là ThemeColorType.HYPERLINK
. Bạn có thể thay đổi chế độ này thông qua setForegroundColor(hexColor)
và setUnderline(underline)
.
Do không thể đặt đường liên kết trên các ký tự dòng mới, nên các ký tự dòng mới trong TextRange
sẽ bị bỏ qua.
// Set a link to the first slide of the presentation. text.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
Tham số
Tên | Loại | Mô tả |
---|---|---|
slidePosition | SlidePosition | SlidePosition tương đối. |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
setLinkUrl(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 văn bản được gạch chân và có màu nền trước là ThemeColorType.HYPERLINK
. Bạn có thể thay đổi chế độ này thông qua setForegroundColor(hexColor)
và setUnderline(underline)
.
Do không thể đặt đường liên kết trên các ký tự dòng mới, nên các ký tự dòng mới trong TextRange
sẽ bị bỏ qua.
// Set a link to the URL. text.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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
setSmallCaps(smallCaps)
Đặt xem văn bản có được hiển thị bằng chữ cái viết hoa nhỏ hay không.
Tham số
Tên | Loại | Mô tả |
---|---|---|
smallCaps | Boolean |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
setStrikethrough(strikethrough)
Đặt 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
setUnderline(underline)
Đặt xem văn bản có được gạch chân hay không.
Tham số
Tên | Loại | Mô tả |
---|---|---|
underline | Boolean |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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