Một đoạn trong nội dung văn bản của Shape
hoặc TableCell
.
Nếu bạn dùng các phương thức chỉnh sửa cách văn bản vừa với hình dạng, thì mọi chế độ cài đặt tự động điều chỉnh được áp dụng cho hình dạng đó sẽ bị tắt.
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
appendParagraph(text) | Paragraph | Thêm một đoạn vào cuối dải ô văn bản. |
appendRange(textRange) | TextRange | Thêm bản sao của dải ô văn bản đã cung cấp vào cuối dải ô văn bản hiện tại. |
appendRange(textRange, matchSourceFormatting) | TextRange | Thêm bản sao của dải ô văn bản đã cung cấp vào cuối dải ô văn bản hiện tại. |
appendText(text) | TextRange | Thêm văn bản vào cuối dải ô văn bản. |
asRenderedString() | String | Trả về văn bản được kết xuất nằm trong dải ô này của hình dạng hoặc ô trong bảng được liên kết ở một định dạng phù hợp để hiển thị cho người dùng cuối. |
asString() | String | Trả về văn bản thô được giới hạn bởi dải ô này của hình dạng hoặc ô bảng được liên kết. |
clear() | void | Xoá văn bản nằm trong phạm vi này. |
clear(startOffset, endOffset) | void | Xoá văn bản khỏi độ dời đầu và cuối trong phạm vi. |
find(pattern) | TextRange[] | Trả về tất cả dải ô khớp với mẫu tìm kiếm trong dải ô văn bản hiện tại. |
find(pattern, startOffset) | TextRange[] | Trả về tất cả các dải ô khớp với mẫu tìm kiếm trong dải ô văn bản hiện tại bắt đầu từ độ lệch bắt đầu. |
getAutoTexts() | AutoText[] | Trả về văn bản tự động trong dải ô văn bản hiện tại. |
getEndIndex() | Integer | Trả về chỉ mục riêng dựa trên 0 cho ký tự cuối cùng trong dải ô này. |
getLength() | Integer | Trả về số lượng ký tự trong dải ô này. |
getLinks() | TextRange[] | Trả về một tập hợp các dải ô văn bản tương ứng với tất cả các Link trong dải ô văn bản hiện tại hoặc chồng lên dải văn bản hiện tại. |
getListParagraphs() | Paragraph[] | Trả về các đoạn văn trong danh sách chồng lên dải ô văn bản hiện tại. |
getListStyle() | ListStyle | Trả về ListStyle của dải ô văn bản hiện tại. |
getParagraphStyle() | ParagraphStyle | Trả về ParagraphStyle của dải ô văn bản hiện tại. |
getParagraphs() | Paragraph[] | Trả về các đoạn chồng chéo lên dải ô văn bản hiện tại. |
getRange(startOffset, endOffset) | TextRange | Trả về một TextRange mới bao gồm một phần dải ô mà giá trị đó bắt nguồn từ đó. |
getRuns() | TextRange[] | Trả về văn bản chạy chồng lên dải ô văn bản hiện tại. |
getStartIndex() | Integer | Trả về chỉ mục dựa trên 0, bao gồm cho ký tự đầu tiên trong dải ô này. |
getTextStyle() | TextStyle | Trả về kiểu văn bản của dải ô hoặc null nếu dải ô trống. |
insertParagraph(startOffset, text) | Paragraph | Chèn một đoạn ở độ lệch đầu. |
insertRange(startOffset, textRange) | TextRange | Chèn một bản sao của dải ô văn bản được cung cấp ở độ lệch đầu. |
insertRange(startOffset, textRange, matchSourceFormatting) | TextRange | Chèn một bản sao của dải ô văn bản được cung cấp ở độ lệch đầu. |
insertText(startOffset, text) | TextRange | Chèn văn bản vào độ lệch đầu. |
isEmpty() | Boolean | Trả về true nếu không có ký tự nào trong dải ô này và trả về false . |
replaceAllText(findText, replaceText) | Integer | Thay thế tất cả các bản sao văn bản tìm được khớp bằng văn bản thay thế. |
replaceAllText(findText, replaceText, matchCase) | Integer | Thay thế tất cả các bản sao văn bản tìm được khớp bằng văn bản thay thế. |
select() | void | Chỉ chọn TextRange trong bản trình bày đang hoạt động và xoá mọi lựa chọn trước đó. |
setText(newText) | TextRange | Đặt văn bản nằm trong dải ô này của hình dạng hoặc ô bảng được liên kết. |
Tài liệu chi tiết
appendParagraph(text)
Thêm một đoạn vào cuối dải ô văn bản. Đoạn này duy trì kiểu ở phần cuối của dải ô văn bản hiện tại.
Chuỗi văn bản đã cung cấp được nối dưới dạng một đoạn bằng cách thêm ít nhất một ký tự dòng mới xung quanh vào chuỗi.
Khi chuỗi văn bản đã cung cấp có chứa các ký tự dòng mới (do bao gồm nhiều đoạn), đoạn cuối cùng được thêm vào sẽ được trả về.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
text | String | Chuỗi cần nối dưới dạng một đoạn. |
Cầu thủ trả bóng
Paragraph
– Paragraph
được thêm vào.
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
appendRange(textRange)
Thêm bản sao của dải ô văn bản đã cung cấp vào cuối dải ô văn bản hiện tại.
Định dạng của văn bản được chèn sẽ khớp với định dạng của văn bản nguồn.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
textRange | TextRange | Dải ô văn bản cần nối. |
Cầu thủ trả bóng
TextRange
– dải ô văn bản đại diện cho văn bản được thêm vào
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
appendRange(textRange, matchSourceFormatting)
Thêm bản sao của dải ô văn bản đã cung cấp vào cuối dải ô văn bản hiện tại.
Nếu được đặt để khớp với định dạng của văn bản đích, thì AutoText
trong phạm vi văn bản được cung cấp sẽ được thay thế bằng các giá trị hiển thị. Hơn nữa, mọi phần tử không phải văn bản trong phạm vi văn bản đã cung cấp sẽ không được thêm vào.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
textRange | TextRange | Dải ô văn bản cần nối. |
matchSourceFormatting | Boolean | Nếu true thì khớp với định dạng của văn bản nguồn; nếu false , hãy khớp với định dạng của văn bản đích. |
Cầu thủ trả bóng
TextRange
– dải ô văn bản đại diện cho văn bản được thêm vào
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
appendText(text)
Thêm văn bản vào cuối dải ô văn bản. Văn bản này duy trì kiểu của phần cuối của văn bản hiện có.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
text | String | Chuỗi cần nối. |
Cầu thủ trả bóng
TextRange
– dải ô văn bản đại diện cho văn bản được thêm.
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
asRenderedString()
Trả về văn bản được kết xuất nằm trong dải ô này của hình dạng hoặc ô trong bảng được liên kết ở một định dạng phù hợp để hiển thị cho người dùng cuối.
Các phần tử AutoText, chẳng hạn như số trang trình bày được tạo, được thay thế bằng các giá trị đã kết xuất. Mọi phần tử không phải văn bản trong dải ô đều bị bỏ qua.
Cầu thủ trả bóng
String
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
asString()
Trả về văn bản thô được giới hạn bởi dải ô này của hình dạng hoặc ô bảng được liên kết.
Các phần tử Văn bản tự động (chẳng hạn như số trang trình bày được tạo và mọi phần tử không phải văn bản trong phạm vi) được thay thế bằng ký tự Unicode U+E907.
Cầu thủ trả bóng
String
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
clear()
Xoá văn bản nằm trong phạm vi này.
Vì toàn bộ văn bản trong một Hình dạng hoặc TableCell phải kết thúc bằng một dòng mới, nên dòng mới cuối cùng trong văn bản sẽ không bị xoá.
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
clear(startOffset, endOffset)
Xoá văn bản khỏi độ dời đầu và cuối trong phạm vi.
Vì văn bản phải kết thúc bằng một dòng mới, nên dòng mới cuối cùng trong văn bản sẽ không bị xoá ngay cả khi nằm trong độ lệch đã cho.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
startOffset | Integer | Số ký tự vượt quá chỉ mục bắt đầu của dải ô văn bản hiện tại được dùng để xác định chỉ mục bắt đầu bao gồm của dải ô cần xoá. Mức chênh lệch đầu phải bằng hoặc lớn hơn 0 và nhỏ hơn hoặc bằng endOffset . startOffset cũng phải nhỏ hơn độ dài của dải ô hiện tại. |
endOffset | Integer | Số ký tự vượt quá chỉ mục bắt đầu của dải ô văn bản hiện tại được dùng để xác định chỉ mục kết thúc riêng của dải ô cần xoá. endOffset phải bằng hoặc lớn hơn startOffset . endOffset cũng phải nhỏ hơn hoặc bằng độ dài của dải ô hiện tại. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
find(pattern)
Trả về tất cả dải ô khớp với mẫu tìm kiếm trong dải ô văn bản hiện tại. Nội dung tìm kiếm có phân biệt chữ hoa chữ thường.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
pattern | String | Mẫu biểu thức chính quy để tìm kiếm; mọi dấu gạch chéo ngược trong mẫu đó đều phải được dùng ký tự thoát. |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
find(pattern, startOffset)
Trả về tất cả các dải ô khớp với mẫu tìm kiếm trong dải ô văn bản hiện tại bắt đầu từ độ lệch bắt đầu. Tìm kiếm có phân biệt chữ hoa chữ thường.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
pattern | String | Mẫu biểu thức chính quy để tìm kiếm; mọi dấu gạch chéo ngược trong mẫu đó đều phải được dùng ký tự thoát. |
startOffset | Integer | Số ký tự vượt quá chỉ mục bắt đầu của dải ô văn bản hiện tại được dùng để xác định chỉ mục bắt đầu bao gồm của dải ô cần tìm kiếm. startOffset cũng phải nhỏ hơn độ dài của dải ô hiện tại. |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getAutoTexts()
Trả về văn bản tự động trong dải ô văn bản hiện tại.
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getEndIndex()
Trả về chỉ mục riêng dựa trên 0 cho ký tự cuối cùng trong dải ô này. Nếu chỉ số bắt đầu và chỉ số kết thúc bằng nhau, phạm vi được coi là trống.
Cầu thủ trả bóng
Integer
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getLength()
Trả về số lượng ký tự trong dải ô này.
Cầu thủ trả bóng
Integer
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getLinks()
Trả về một tập hợp các dải ô văn bản tương ứng với tất cả các Link
trong dải ô văn bản hiện tại hoặc chồng lên dải văn bản hiện tại.
Mỗi phạm vi được trả về đảm bảo kéo dài một đường liên kết khi được tạo. Các nội dung sửa đổi văn bản có thể khiến văn bản đó không còn đại diện chính xác cho một đường liên kết.
Bạn có thể truy cập vào mỗi Link
trong các dải ô được trả về thông qua TextStyle.getLink()
.
// Accesses the first link on a TextRange object. var linkTextRange = textRange.getLinks()[0]; var textStyle = linkTextRange.getTextStyle(); Logger.log(textStyle.hasLink()); // logs 'true' var link = textStyle.getLink(); // Link object
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getListParagraphs()
Trả về các đoạn văn trong danh sách chồng lên dải ô văn bản hiện tại.
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getListStyle()
getParagraphStyle()
Trả về ParagraphStyle
của dải ô văn bản hiện tại.
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getParagraphs()
Trả về các đoạn chồng chéo lên dải ô văn bản hiện tại.
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getRange(startOffset, endOffset)
Trả về một TextRange
mới bao gồm một phần dải ô mà giá trị đó bắt nguồn từ đó.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
startOffset | Integer | Số ký tự vượt quá chỉ mục bắt đầu của dải ô văn bản hiện tại được dùng để xác định chỉ mục bắt đầu bao gồm của dải ô được trả về. Mức chênh lệch đầu phải bằng hoặc lớn hơn 0 và nhỏ hơn hoặc bằng endOffset . startOffset cũng phải nhỏ hơn độ dài của dải ô hiện tại. |
endOffset | Integer | Số ký tự qua chỉ mục bắt đầu của dải ô văn bản hiện tại được dùng để xác định chỉ mục kết thúc riêng của dải ô được trả về. endOffset phải bằng hoặc lớn hơn startOffset . endOffset cũng phải nhỏ hơn hoặc bằng độ dài của dải ô hiện tại. |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getRuns()
Trả về văn bản chạy chồng lên dải ô văn bản hiện tại. Lần chạy văn bản là một đoạn văn bản trong đó tất cả các ký tự có cùng một kiểu văn bản.
Mỗi phạm vi được trả về chỉ đảm bảo kéo dài một lần chạy khi được tạo. Các thao tác sửa đổi văn bản hoặc kiểu có thể khiến văn bản đó không còn thể hiện chính xác một lần chạy.
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getStartIndex()
Trả về chỉ mục dựa trên 0, bao gồm cho ký tự đầu tiên trong dải ô này. Nếu chỉ mục bắt đầu và kết thúc bằng nhau, phạm vi được coi là trống.
Cầu thủ trả bóng
Integer
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getTextStyle()
insertParagraph(startOffset, text)
Chèn một đoạn ở độ lệch đầu. Đoạn văn bản duy trì kiểu của dải ô văn bản hiện tại ở độ lệch đầu.
Chuỗi văn bản đã cung cấp được chèn dưới dạng một đoạn văn bản bằng cách thêm ít nhất một ký tự dòng mới xung quanh vào chuỗi.
Khi chuỗi văn bản đã cung cấp có chứa các ký tự dòng mới (do bao gồm nhiều đoạn), đoạn cuối cùng được thêm vào sẽ được trả về.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
startOffset | Integer | Số ký tự vượt quá chỉ mục bắt đầu của dải ô văn bản hiện tại được dùng để xác định chỉ mục bắt đầu bao gồm của văn bản cần chèn. |
text | String | Chuỗi cần chèn. |
Cầu thủ trả bóng
Paragraph
– Paragraph
được chèn.
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
insertRange(startOffset, textRange)
Chèn một bản sao của dải ô văn bản được cung cấp ở độ lệch đầu.
Định dạng của văn bản được chèn sẽ khớp với định dạng của văn bản nguồn.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
startOffset | Integer | Số ký tự vượt quá chỉ mục bắt đầu của dải ô văn bản hiện tại được dùng để xác định chỉ mục bắt đầu bao gồm của văn bản cần chèn. |
textRange | TextRange | Dải ô văn bản cần chèn. |
Cầu thủ trả bóng
TextRange
– dải ô văn bản đại diện cho văn bản được chèn
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
insertRange(startOffset, textRange, matchSourceFormatting)
Chèn một bản sao của dải ô văn bản được cung cấp ở độ lệch đầu.
Nếu được đặt để khớp với định dạng của văn bản đích, thì AutoText
trong phạm vi văn bản được cung cấp sẽ được thay thế bằng các giá trị hiển thị. Hơn nữa, mọi phần tử không phải văn bản trong phạm vi văn bản đã cung cấp đều không được chèn.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
startOffset | Integer | Số ký tự vượt quá chỉ mục bắt đầu của dải ô văn bản hiện tại được dùng để xác định chỉ mục bắt đầu bao gồm của văn bản cần chèn. |
textRange | TextRange | Dải ô văn bản cần chèn. |
matchSourceFormatting | Boolean | Nếu true thì khớp với định dạng của văn bản nguồn; nếu false , hãy khớp với định dạng của văn bản đích. |
Cầu thủ trả bóng
TextRange
– dải ô văn bản đại diện cho văn bản được chèn
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
insertText(startOffset, text)
Chèn văn bản vào độ lệch đầu. Văn bản này duy trì kiểu của văn bản hiện tại ở độ lệch đầu tiên.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
startOffset | Integer | Số ký tự vượt quá chỉ mục bắt đầu của dải ô văn bản hiện tại được dùng để xác định chỉ mục bắt đầu bao gồm của văn bản cần chèn. |
text | String | Chuỗi cần chèn. |
Cầu thủ trả bóng
TextRange
– dải ô văn bản đại diện cho văn bản được chèn.
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
isEmpty()
Trả về true
nếu không có ký tự nào trong dải ô này và trả về false
.
Cầu thủ trả bóng
Boolean
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
replaceAllText(findText, replaceText)
Thay thế tất cả các bản sao văn bản tìm được khớp bằng văn bản thay thế. Nội dung tìm kiếm không phân biệt chữ hoa chữ thường.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
findText | String | Văn bản cần tìm. |
replaceText | String | Văn bản để thay thế văn bản trùng khớp. |
Cầu thủ trả bóng
Integer
— số lần xuất hiện đã thay đổi
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
replaceAllText(findText, replaceText, matchCase)
Thay thế tất cả các bản sao văn bản tìm được khớp bằng văn bản thay thế.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
findText | String | Văn bản cần tìm. |
replaceText | String | Văn bản để thay thế văn bản trùng khớp. |
matchCase | Boolean | Nếu là true , kết quả tìm kiếm sẽ phân biệt chữ hoa chữ thường; nếu là false , thì kết quả 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
Tập lệnh sử dụng phương thức này cần đượ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()
Chỉ chọn TextRange
trong bản trình bày đang hoạt động 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.
Page
mẹ của Shape
tương ứng hoặc TableCell
được đặt thành current page selection
. Shape
hoặc TableCell
được đặt thành selected page element
.
Selection
có thể có 2 loại:
- 1. Phạm vi của văn bản, sử dụng hàm select trên TextRange không trống để chọn phạm vi của ký tự.
- 2. Vị trí con trỏ, sử dụng TextRange trống để đặt con trỏ vào chỉ mục mong muốn.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; shape.getText().setText("Hello"); // Range selection: Select the text range "He". shape.getText().getRange(0, 2).select(); // Cursor selection: Place the cursor after "H" like "H|ello". shape.getText().getRange(1, 1).select();
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
-
setText(newText)
Đặt văn bản nằm trong dải ô này của hình dạng hoặc ô bảng được liên kết. Văn bản này duy trì kiểu như phần đầu của văn bản hiện có.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
newText | String | Chuỗi cần đặt làm văn bản mới. |
Cầu thủ trả bóng
TextRange
– dải ô văn bản đại diện cho tập hợp văn bản
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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