Class TextRange

TextRange

Một phân đ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 một hình dạng, thì mọi chế độ cài đặt tự động điều chỉnh áp dụng cho hình dạng đó sẽ bị vô hiệu hoá.

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
appendParagraph(text)ParagraphThêm một đoạn văn bản vào cuối phạm vi văn bản.
appendRange(textRange)TextRangeThêm một bản sao của phạm vi văn bản đã cung cấp vào cuối phạm vi văn bản hiện tại.
appendRange(textRange, matchSourceFormatting)TextRangeThêm một bản sao của phạm vi văn bản đã cung cấp vào cuối phạm vi văn bản hiện tại.
appendText(text)TextRangeThêm văn bản vào cuối phạm vi văn bản.
asRenderedString()StringTrả về văn bản đã kết xuất được giới hạn bởi dải ô của hình dạng hoặc ô bảng được liên kết này ở đị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 ô của hình dạng hoặc ô bảng được liên kết.
clear()voidXoá văn bản nằm trong phạm vi này.
clear(startOffset, endOffset)voidXoá văn bản nằm trong phạm vi được giới hạn bởi độ dời bắt đầu và kết thúc.
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 riêng biệt, dựa trên 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 trùng lặp với dải văn bản hiện tại.
getListParagraphs()Paragraph[]Trả về các đoạn văn trong danh sách trùng lặp với phạm vi 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à nó được lấy từ đó.
getRuns()TextRange[]Trả về các dòng văn bản trùng lặp với dải văn bản hiện tại.
getStartIndex()IntegerTrả về chỉ mục bắt đầu từ 0, bao gồm cả 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 văn bản tại độ dời bắt đầu.
insertRange(startOffset, textRange)TextRangeChèn một bản sao của dải ô văn bản được cung cấp tại mức chênh lệch đầu.
insertRange(startOffset, textRange, matchSourceFormatting)TextRangeChèn một bản sao của dải ô văn bản được cung cấp tại mức chênh lệch đầu.
insertText(startOffset, text)TextRangeChèn văn bản tại độ dời bắt đầu.
isEmpty()BooleanTrả về true nếu không có ký tự nào trong phạm vi này và trả về false nếu có.
replaceAllText(findText, replaceText)IntegerThay thế tất cả các bản sao của văn bản khớp với văn bản tìm kiếm bằng văn bản thay thế.
replaceAllText(findText, replaceText, matchCase)IntegerThay thế tất cả các bản sao của văn bản khớp với văn bản tìm kiế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 ô 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ăn bản vào cuối phạm vi văn bản. Đoạn văn bản duy trì kiểu của phần cuối dải ô văn bản hiện tại.

Chuỗi văn bản được cung cấp được thêm vào 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 được cung cấp chứa 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 sẽ được trả về.

Tham số

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

Cầu thủ trả bóng

Paragraph – Paragraph đã thêm vào.

Ủ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

appendRange(textRange)

Thêm một bản sao của phạm vi văn bản đã cung cấp vào cuối phạm vi 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.

Tham số

TênLoạiMô tả
textRangeTextRangeDả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

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

appendRange(textRange, matchSourceFormatting)

Thêm một bản sao của phạm vi văn bản đã cung cấp vào cuối phạm vi 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, 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 được cung cấp sẽ không được thêm vào.

Tham số

TênLoạiMô tả
textRangeTextRangeDải ô văn bản cần nối.
matchSourceFormattingBooleanNếu là true, hãy so khớp định dạng của văn bản nguồn; nếu là false, hãy so khớp đị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

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

appendText(text)

Thêm văn bản vào cuối phạm vi văn bản. Văn bản duy trì kiểu của phần cuối văn bản hiện có.

Tham số

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

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

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

asRenderedString()

Trả về văn bản đã kết xuất được giới hạn bởi dải ô của hình dạng hoặc ô bảng được liên kết này ở đị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 trình bày được tạo, được thay thế bằng giá trị hiển thị của các phần 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

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

asString()

Trả về văn bản thô được giới hạn bởi dải ô của hình dạng hoặc ô bảng được liên kết.

Tự độngCác phần tử văn bả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 dải ô sẽ được thay thế bằng ký tự Unicode U+E907.

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

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

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

clear(startOffset, endOffset)

Xoá văn bản nằm trong phạm vi được giới hạn bởi độ dời bắt đầu và kết thúc.

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 các độ dời đã cho.

Tham số

TênLoạiMô tả
startOffsetIntegerSố 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á. Độ lệch bắt đầ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.
endOffsetIntegerSố 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 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

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

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. Tính năng tìm kiếm có phân biệt chữ hoa chữ thường.

Tham 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[]

Ủ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

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

Tham 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ố 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ả 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[]

Ủ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

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[]

Ủ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

getEndIndex()

Trả về chỉ mục riêng biệt, dựa trên 0 cho ký tự cuối cùng trong dải ô này. Nếu chỉ mục bắt đầu và kết thúc bằng nhau, thì dải ô được coi là trố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

getLength()

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

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

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 trùng lặp với dải văn bản hiện tại.

Mỗi dải ô được trả về được đảm bảo sẽ 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 chính xác cho một đường liên kết.

Bạn có thể truy cập vào từng Link trên 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[]

Ủ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

getListParagraphs()

Trả về các đoạn văn trong danh sách trùng lặp với phạm vi văn bản hiện tại.

Cầu thủ trả bóng

Paragraph[]

Ủ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

getListStyle()

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

Cầu thủ trả bóng

ListStyle

Ủ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

getParagraphStyle()

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

Cầu thủ trả bóng

ParagraphStyle

Ủ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

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[]

Ủ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

getRange(startOffset, endOffset)

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

Tham số

TênLoạiMô tả
startOffsetIntegerSố 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ề. Độ lệch bắt đầ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.
endOffsetIntegerSố 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 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

TextRange

Ủ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

getRuns()

Trả về các dòng văn bản trùng lặp với dải văn bản hiện tại. Lượt chạy văn bản là một đoạn văn bản trong đó tất cả các ký tự đều có cùng một kiểu văn bản.

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

Cầu thủ trả bóng

TextRange[]

Ủ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

getStartIndex()

Trả về chỉ mục bắt đầu từ 0, bao gồm cả 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

Ủ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

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

Ủ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

insertParagraph(startOffset, text)

Chèn một đoạn văn bản tại độ dời 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 đượ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 được cung cấp chứa 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 sẽ được trả về.

Tham số

TênLoạiMô tả
startOffsetIntegerSố 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ả 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 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

insertRange(startOffset, textRange)

Chèn một bản sao của dải ô văn bản được cung cấp tại mức chênh 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.

Tham số

TênLoạiMô tả
startOffsetIntegerSố 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ả 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 – dải văn bản đại diện cho văn bản đã chèn

Ủ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

insertRange(startOffset, textRange, matchSourceFormatting)

Chèn một bản sao của dải ô văn bản được cung cấp tại mức chênh lệch đầu.

Nếu được đặt để khớp với định dạng của văn bản đích, 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ị. 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 sẽ không được chèn.

Tham số

TênLoạiMô tả
startOffsetIntegerSố 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ả văn bản cần chèn.
textRangeTextRangeDải ô văn bản cần chèn.
matchSourceFormattingBooleanNếu là true, hãy so khớp định dạng của văn bản nguồn; nếu là false, hãy so khớp đị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 đã chèn

Ủ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

insertText(startOffset, text)

Chèn văn bản tại độ dời bắt đầu. Văn bản duy trì kiểu của văn bản hiện có tại độ dời bắt đầu.

Tham số

TênLoạiMô tả
startOffsetIntegerSố 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ả văn bản cần chèn.
textStringChuỗ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 đã chèn.

Ủ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

isEmpty()

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

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

replaceAllText(findText, replaceText)

Thay thế tất cả các bản sao của văn bản khớp với văn bản tìm kiếm bằng văn bản thay thế. Tìm kiếm không phân biệt chữ hoa chữ thường.

Tham số

TênLoạiMô tả
findTextStringVăn bản cần tìm.
replaceTextStringVăn bản thay thế văn bản đã 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 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

replaceAllText(findText, replaceText, matchCase)

Thay thế tất cả các bản sao của văn bản khớp với văn bản tìm kiếm bằng văn bản thay thế.

Tham số

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

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

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

    Selection có thể là một trong hai loại:
    • 1. Phạm vi văn bản, sử dụng tính năng 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ỏ, sử dụng 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 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

    setText(newText)

    Đặt văn bản được giới hạn bởi dải ô của hình dạng hoặc ô bảng được liên kết. Văn bản duy trì kiểu của phần đầu văn bản hiện có.

    Tham 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 – dải văn bản đại diện cho văn bản đã đặt

    Ủ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