Class TextRange

Phạm viVăn bản

Một đoạn nội dung văn bản của Shape hoặc TableCell.

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 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 hình dạng sẽ bị vô hiệu hoá.

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
appendParagraph(text)ParagraphThêm một đoạn vào cuối dải văn bản.
appendRange(textRange)TextRangeThêm một bản sao của dải văn bản đã cho vào cuối dải văn bản hiện tại.
appendRange(textRange, matchSourceFormatting)TextRangeThêm một bản sao của dải văn bản đã cho vào cuối dải văn bản hiện tại.
appendText(text)TextRangeNối văn bản vào cuối dải văn bản.
asRenderedString()StringTrả về văn bản được kết xuất bị 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 theo định dạng phù hợp để hiển thị cho người dùng cuối.
asString()StringTrả 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 ô trong bảng được liên kết.
clear()voidXoá văn bản bị giới hạn bởi dải ô này.
clear(startOffset, endOffset)voidXoá văn bản được giới hạn bởi mức chênh lệch đầu và cuối trong dải ô.
find(pattern)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.
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ừ mức chênh lệch đầu.
getAutoTexts()AutoText[]Trả về văn bản tự động trong phạm vi văn bản hiện tại.
getEndIndex()IntegerTrả về chỉ mục loại trừ, bắt đầu từ 0 cho ký tự cuối cùng trong dải ô này.
getLength()IntegerTrả 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ả 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 trong danh sách trùng với dải văn bản hiện tại.
getListStyle()ListStyleTrả về ListStyle của dải văn bản hiện tại.
getParagraphStyle()ParagraphStyleTrả về ParagraphStyle của dải văn bản hiện tại.
getParagraphs()Paragraph[]Trả về các đoạn văn bản trùng lặp với dải văn bản hiện tại.
getRange(startOffset, endOffset)TextRangeTrả về một TextRange mới bao gồm một phần của dải ô mà từ đó TextRange này được lấy ra.
getRuns()TextRange[]Trả về các đoạn văn bản trùng với dải văn bản hiện tại.
getStartIndex()IntegerTrả về chỉ mục dựa trên 0, bao gồm cho ký tự đầu tiên trong dải ô này.
getTextStyle()TextStyleTrả về kiểu văn bản của dải ô hoặc null nếu dải ô trống.
insertParagraph(startOffset, text)ParagraphChèn một đoạn tại phần bù bắt đầu.
insertRange(startOffset, textRange)TextRangeChèn bản sao của dải văn bản được cung cấp vào phần bù bắt đầu.
insertRange(startOffset, textRange, matchSourceFormatting)TextRangeChèn bản sao của dải văn bản được cung cấp vào phần bù bắt đầu.
insertText(startOffset, text)TextRangeChèn văn bản vào phần bù bắt đầu.
isEmpty()BooleanTrả về true nếu không có ký tự nào trong dải ô này và trả về false nếu có.
replaceAllText(findText, replaceText)IntegerThay thế tất cả các trường hợp văn bản khớp với văn bản tìm bằng văn bản thay thế.
replaceAllText(findText, replaceText, matchCase)IntegerThay thế tất cả các trường hợp văn bản khớp với văn bản tìm bằng văn bản thay thế.
select()voidChỉ 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 đượ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.

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 văn bản giữ nguyên kiểu của cuối dải ô văn bản hiện tại.

Chuỗi văn bản được cung cấp sẽ được thêm dưới dạng một đoạn vă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 được cung cấp chứa các ký tự dòng mới (do đó bao gồm nhiều đoạn văn), đoạn văn cuối cùng được thêm vào sẽ được trả về.

Thông số

TênLoạiMô tả
textStringChuỗi cần thêm dưới dạng một đoạn văn.

Cầu thủ trả bóng

Paragraph – Paragraph được thêm vào.

Ủ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

appendRange(textRange)

Thêm một bản sao của dải văn bản đã cho 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 khớp với định dạng của văn bản nguồn.

Thông số

TênLoạiMô tả
textRangeTextRangeDải ô văn bản cần nối.

Cầu thủ trả bóng

TextRange – Phạm vi văn bản biểu thị văn bản được thêm vào.

Ủ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

appendRange(textRange, matchSourceFormatting)

Thêm một bản sao của dải văn bản đã cho 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ị được hiển thị. Hơn nữa, mọi phần tử không phải văn bản trong dải ô văn bản được cung cấp đều không được nối.

Thông số

TênLoạiMô tả
textRangeTextRangeDải ô văn bản cần nối.
matchSourceFormattingBooleanNếu true, hãy 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 – Phạm vi văn bản biểu thị văn bản được thêm vào.

Ủ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

appendText(text)

Nối văn bản vào cuối dải văn bản. Văn bản giữ nguyên kiểu của phần cuối văn bản hiện có.

Thông số

TênLoạiMô tả
textStringChuỗi cần thêm vào.

Cầu thủ trả bóng

TextRange – Phạm vi văn bản biểu thị văn bản được thêm vào.

Ủ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

asRenderedString()

Trả về văn bản được kết xuất bị 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 theo định dạng phù hợp để hiển thị cho người dùng cuối.

Các phần tử Văn bản tự động, chẳng hạn như số trang được tạo, sẽ được thay thế bằng các giá trị đã hiển thị. 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 – Văn bản được hiển thị trong phạm vi.

Ủ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

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 ô trong 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 được tạo và mọi phần tử không phải văn bản trong dải ô sẽ được thay thế bằng ký tự Unicode U+E907.

Cầu thủ trả bóng

String – Văn bản thô trong dải ô.

Ủ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

clear()

Xoá văn bản bị giới hạn bởi dải ô này.

Vì toàn bộ văn bản trong Shape 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

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

clear(startOffset, endOffset)

Xoá văn bản được giới hạn bởi mức chênh lệch đầu và cuối trong dải ô.

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 dòng mới đó nằm trong phạm vi của các khoảng cách đã cho.

Thông số

TênLoạiMô tả
startOffsetIntegerSố lượng ký tự sau 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 lớn hơn hoặc bằng 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.
endOffsetIntegerSố lượng 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 cuối loại trừ 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

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

find(pattern)

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. Nội dung tìm kiếm có phân biệt chữ hoa chữ thường.

Thông số

TênLoạiMô tả
patternStringMẫ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 thoát.

Cầu thủ trả bóng

TextRange[] – Danh sách các dải văn bản.

Ủ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

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ừ mức chênh lệch đầu. Nội dung tìm kiếm có phân biệt chữ hoa chữ thường.

Thông số

TênLoạiMô tả
patternStringMẫ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 thoát.
startOffsetIntegerSố lượng ký tự sau 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 hà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

TextRange[] – Danh sách các dải văn bản.

Ủ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

getAutoTexts()

Trả về văn bản tự động trong phạm vi văn bản hiện tại.

Cầu thủ trả bóng

AutoText[] – Danh sách văn bản tự độ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

getEndIndex()

Trả về chỉ mục loại trừ, bắt đầu từ 0 cho ký tự cuối cùng trong dải ô này. Nếu chỉ mục bắt đầu và chỉ mục kết thúc bằng nhau, thì dải ô được coi là trống.

Cầu thủ trả bóng

Integer – Chỉ mục kết thúc của dải ô.

Ủ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

getLength()

Trả về số lượng ký tự trong dải ô này.

Cầu thủ trả bóng

Integer – Số ký tự trong dải ô này.

Ủ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

Trả về một tập hợp các dải văn bản tương ứng với tất 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 dải ô được trả về đều đảm bảo trải dài trên một đường liên kết khi được tạo. Việc sửa đổi văn bản có thể khiến văn bản đó không còn đại diện cho chính xác một đường liên kết.

Bạn có thể truy cập vào từng Link trong các dải ô được trả về thông qua TextStyle.getLink(). 

// Accesses the first link on a TextRange object.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
const linkTextRange = textRange.getLinks()[0];
const textStyle = linkTextRange.getTextStyle();
Logger.log(textStyle.hasLink());   // logs 'true'
const link = textStyle.getLink();  // Link object

Cầu thủ trả bóng

TextRange[] – Danh sách các dải văn bản.

Ủ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

getListParagraphs()

Trả về các đoạn trong danh sách trùng với dải văn bản hiện tại.

Cầu thủ trả bóng

Paragraph[] – Danh sách các đoạn trong danh sách.

Ủ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

getListStyle()

Trả về ListStyle của dải văn bản hiện tại.

Cầu thủ trả bóng

ListStyle – Kiểu danh sách của dải văn bản hiện tại.

Ủ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

getParagraphStyle()

Trả về ParagraphStyle của dải văn bản hiện tại.

Cầu thủ trả bóng

ParagraphStyle – Kiểu đoạn văn của dải văn bản hiện tại.

Ủ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

getParagraphs()

Trả về các đoạn văn bản trùng lặp với dải văn bản hiện tại.

Cầu thủ trả bóng

Paragraph[] – Danh sách các đoạn văn.

Ủ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

getRange(startOffset, endOffset)

Trả về một TextRange mới bao gồm một phần của dải ô mà từ đó TextRange này được lấy ra.

Thông số

TênLoạiMô tả
startOffsetIntegerSố lượng 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 lớn hơn hoặc bằng 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.
endOffsetIntegerSố lượng 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 cuối loại trừ 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

TextRange – Một dải văn bản mới.

Ủ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

getRuns()

Trả về các đoạn văn bản trùng với dải văn bản hiện tại. Đoạn văn bản là một đoạn văn bản mà tất cả các ký tự đều có cùng kiểu văn bản.

Mỗi dải ô được trả về chỉ được đảm bảo trải dài trên một lần chạy khi được tạo. Việc sửa đổi văn bản hoặc kiểu chữ có thể khiến văn bản đó không còn đại diện cho chính xác một lần chạy nữa.

Cầu thủ trả bóng

TextRange[] – Danh sách các dải văn bản.

Ủ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

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à chỉ mục kết thúc bằng nhau, thì dải ô được coi là trống.

Cầu thủ trả bóng

Integer – Chỉ mục bắt đầu của phạm vi.

Ủ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

getTextStyle()

Trả về kiểu văn bản của dải ô hoặc null nếu dải ô trống.

Cầu thủ trả bóng

TextStyle – Kiểu văn bản của dải ô.

Ủ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

insertParagraph(startOffset, text)

Chèn một đoạn tại phần bù bắt đầu. Đoạn văn bản duy trì kiểu của dải ô văn bản hiện tại tại mức chênh lệch đầu.

Chuỗi văn bản được cung cấp sẽ được chèn dưới dạng một đoạn vă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 được cung cấp chứa các ký tự dòng mới (do đó bao gồm nhiều đoạn văn), đoạn văn cuối cùng được thêm vào sẽ được trả về.

Thông số

TênLoạiMô tả
startOffsetIntegerSố lượng ký tự sau 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 hàm của văn bản cần chèn.
textStringChuỗi cần chèn.

Cầu thủ trả bóng

Paragraph – Paragraph đã chèn.

Ủ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

insertRange(startOffset, textRange)

Chèn bản sao của dải văn bản được cung cấp vào phần bù bắt đầu.

Định dạng của văn bản được chèn khớp với định dạng của văn bản nguồn.

Thông số

TênLoạiMô tả
startOffsetIntegerSố lượng ký tự sau 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 hàm của văn bản cần chèn.
textRangeTextRangeDải ô văn bản cần chèn.

Cầu thủ trả bóng

TextRange – Phạm vi văn bản biểu thị văn bản được chèn.

Ủ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

insertRange(startOffset, textRange, matchSourceFormatting)

Chèn bản sao của dải văn bản được cung cấp vào phần bù bắt đầ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ị được hiển thị. Ngoài ra, mọi phần tử không phải văn bản trong phạm vi văn bản được cung cấp đều không được chèn.

Thông số

TênLoạiMô tả
startOffsetIntegerSố lượng ký tự sau 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 hàm của văn bản cần chèn.
textRangeTextRangeDải ô văn bản cần chèn.
matchSourceFormattingBooleanNếu true, hãy 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 – Phạm vi văn bản biểu thị văn bản được chèn.

Ủ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

insertText(startOffset, text)

Chèn văn bản vào phần bù bắt đầu. Văn bản duy trì kiểu của văn bản hiện có tại phần bù bắt đầu.

Thông số

TênLoạiMô tả
startOffsetIntegerSố lượng ký tự sau 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 hàm của văn bản cần chèn.
textStringChuỗi cần chèn.

Cầu thủ trả bóng

TextRange – Phạm vi văn bản biểu thị văn bản được chèn.

Ủ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

isEmpty()

Trả về true nếu không có ký tự nào trong dải ô này và trả về false nếu có.

Cầu thủ trả bóng

Boolean – true nếu không có ký tự nào trong phạm vi này và trả về false nếu có.

Ủ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

replaceAllText(findText, replaceText)

Thay thế tất cả các trường hợp văn bản khớp với văn bản tìm 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.

Thông số

TênLoạiMô tả
findTextStringVăn bản cần tìm.
replaceTextStringVăn bản sẽ 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

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

replaceAllText(findText, replaceText, matchCase)

Thay thế tất cả các trường hợp văn bản khớp với văn bản tìm bằng văn bản thay thế.

Thông số

TênLoạiMô tả
findTextStringVăn bản cần tìm.
replaceTextStringVăn bản sẽ thay thế văn bản trùng khớp.
matchCaseBooleanNếu true, thì tìm kiếm có phân biệt chữ hoa chữ thường; nếu false, thì tìm kiếm 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

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

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 đó.

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 làm current page selection. Shape hoặc TableCell được đặt làm selected page element.

    Selection có thể thuộc 2 loại:
    • 1. Phạm vi văn bản, sử dụng lựa chọn trên TextRange không trống để chọn phạm vi của các ký tự.
    • 2. Vị trí con trỏ, hãy dùng một TextRange trống để đặt con trỏ tại chỉ mục mong muốn. 
      const 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

      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

    setText(newText)

    Đặt văn bản đượ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. Văn bản giữ nguyên kiểu của phần đầu văn bản hiện có.

    Thông số

    TênLoạiMô tả
    newTextStringChuỗi cần đặt làm văn bản mới.

    Cầu thủ trả bóng

    TextRange – Phạm vi văn bản biểu thị văn bản đã đặt.

    Ủ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