Class TextRange

TextRange

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ứ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 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)TextRangeThê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)TextRangeThêm 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 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()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 ô 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 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()IntegerTrả về chỉ mục riêng 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ả 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()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 chồng chéo lên 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 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()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 ở độ lệch đầu.
insertRange(startOffset, textRange)TextRangeChè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)TextRangeChèn một bản sao của dải ô văn bản được cung cấp ở độ lệch đầu.
insertText(startOffset, text)TextRangeChèn văn bản vào độ lệch đầu.
isEmpty()BooleanTrả về true nếu không có ký tự nào trong dải ô này và trả về false.
replaceAllText(findText, replaceText)IntegerThay 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)IntegerThay 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()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 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ênLoạiNội dung mô tả
textStringChuỗi cần nối dưới dạng một đoạn.

Cầu thủ trả bóng

ParagraphParagraph đượ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ênLoạiNội dung mô 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

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ênLoạiNội dung mô tả
textRangeTextRangeDải ô văn bản cần nối.
matchSourceFormattingBooleanNế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ênLoạiNội dung mô tả
textStringChuỗ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ênLoạiNội dung mô 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á. 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.
endOffsetIntegerSố 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ênLoạiNội dung mô 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 dùng ký tự thoát.

Cầu thủ trả bóng

TextRange[]

Ủ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ênLoạiNội dung mô 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 dùng ký tự 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ủ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[]

Ủ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

AutoText[]

Ủ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

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

TextRange[]

Ủ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

Paragraph[]

Ủ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()

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

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

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

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

Paragraph[]

Ủ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ênLoạiNội dung mô 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ề. 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.
endOffsetIntegerSố 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

TextRange

Ủ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

TextRange[]

Ủ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()

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

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

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ênLoạiNội dung mô 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 văn bản cần chèn.
textStringChuỗi cần chèn.

Cầu thủ trả bóng

ParagraphParagraph đượ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ênLoạiNội dung mô 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 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 đượ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ênLoạiNội dung mô 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 văn bản cần chèn.
textRangeTextRangeDải ô văn bản cần chèn.
matchSourceFormattingBooleanNế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ênLoạiNội dung mô 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 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 đượ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ênLoạiNội dung mô tả
findTextStringVăn bản cần tìm.
replaceTextStringVă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ênLoạiNội dung mô tả
findTextStringVăn bản cần tìm.
replaceTextStringVăn bản để thay thế văn bản trùng khớp.
matchCaseBooleanNế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ênLoạiNội dung mô 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 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