Class TextRange

TextRange

ส่วนของเนื้อหาข้อความของ Shape หรือ TableCell

หากคุณใช้วิธีการที่แก้ไขความพอดีของข้อความภายในรูปร่าง ระบบจะใช้การตั้งค่าการปรับให้พอดีอัตโนมัติกับ ระบบจะปิดใช้งานรูปร่าง

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
appendParagraph(text)Paragraphเพิ่มย่อหน้าที่ท้ายช่วงข้อความ
appendRange(textRange)TextRangeแนบสำเนาของช่วงข้อความที่ให้ไว้ต่อท้ายช่วงข้อความปัจจุบัน
appendRange(textRange, matchSourceFormatting)TextRangeแนบสำเนาของช่วงข้อความที่ให้ไว้ต่อท้ายช่วงข้อความปัจจุบัน
appendText(text)TextRangeเพิ่มข้อความต่อท้ายส่วนท้ายของช่วงข้อความ
asRenderedString()Stringแสดงผลข้อความที่แสดงผลที่มีขอบเขตโดยช่วงนี้ของรูปร่างหรือเซลล์ตารางที่เกี่ยวข้องใน ที่เหมาะสมเพื่อแสดงต่อผู้ใช้ปลายทาง
asString()Stringแสดงผลข้อความดิบที่มีขอบเขตโดยช่วงนี้ของรูปร่างหรือเซลล์ในตารางที่เกี่ยวข้อง
clear()voidล้างข้อความที่ล้อมรอบด้วยช่วงนี้
clear(startOffset, endOffset)voidล้างข้อความที่ล้อมรอบด้วยออฟเซ็ตเริ่มต้นและสิ้นสุดในช่วง
find(pattern)TextRange[]แสดงผลช่วงทั้งหมดที่ตรงกับรูปแบบการค้นหาในช่วงข้อความปัจจุบัน
find(pattern, startOffset)TextRange[]แสดงผลช่วงทั้งหมดที่ตรงกับรูปแบบการค้นหาในช่วงข้อความปัจจุบัน โดยเริ่มจาก เริ่มต้นออฟเซ็ต
getAutoTexts()AutoText[]แสดงผลข้อความอัตโนมัติภายในช่วงข้อความปัจจุบัน
getEndIndex()Integerแสดงดัชนีพิเศษแบบ 0 สำหรับอักขระตัวสุดท้ายในช่วงนี้
getLength()Integerแสดงผลจำนวนอักขระในช่วงนี้
getLinks()TextRange[]แสดงคอลเล็กชันของช่วงข้อความที่ตรงกับ Link ทั้งหมดในช่วงปัจจุบัน หรือซ้อนทับกับช่วงข้อความปัจจุบัน
getListParagraphs()Paragraph[]แสดงผลย่อหน้าในรายการที่ทับซ้อนกับช่วงข้อความปัจจุบัน
getListStyle()ListStyleแสดงผล ListStyle ของช่วงข้อความปัจจุบัน
getParagraphStyle()ParagraphStyleแสดงผล ParagraphStyle ของช่วงข้อความปัจจุบัน
getParagraphs()Paragraph[]แสดงผลย่อหน้าที่ทับซ้อนกับช่วงข้อความปัจจุบัน
getRange(startOffset, endOffset)TextRangeแสดงผล TextRange ใหม่ที่ครอบคลุมส่วนของช่วงที่ดึงมา
getRuns()TextRange[]แสดงผลการเรียกใช้ข้อความที่ซ้อนทับกับช่วงข้อความปัจจุบัน
getStartIndex()Integerแสดงผลดัชนีรวมค่าฐาน 0 สำหรับอักขระตัวแรกในช่วงนี้
getTextStyle()TextStyleแสดงผลรูปแบบข้อความของช่วง หรือ null หากไม่มีข้อมูลของช่วง
insertParagraph(startOffset, text)Paragraphแทรกย่อหน้าที่ออฟเซ็ตเริ่มต้น
insertRange(startOffset, textRange)TextRangeแทรกสำเนาของช่วงข้อความที่ให้ไว้ที่ออฟเซ็ตเริ่มต้น
insertRange(startOffset, textRange, matchSourceFormatting)TextRangeแทรกสำเนาของช่วงข้อความที่ให้ไว้ที่ออฟเซ็ตเริ่มต้น
insertText(startOffset, text)TextRangeแทรกข้อความที่ออฟเซ็ตเริ่มต้น
isEmpty()Booleanแสดงผล true หากไม่มีอักขระในช่วงนี้ และแสดงค่า false หรือไม่เช่นนั้น
replaceAllText(findText, replaceText)Integerแทนที่ข้อความทั้งหมดที่ตรงกับการค้นหาข้อความด้วย "แทนที่ข้อความ"
replaceAllText(findText, replaceText, matchCase)Integerแทนที่ข้อความทั้งหมดที่ตรงกับการค้นหาข้อความด้วย "แทนที่ข้อความ"
select()voidเลือกเฉพาะ TextRange ในงานนำเสนอที่ใช้งานอยู่และนำรายการก่อนหน้าออก มากมาย
setText(newText)TextRangeตั้งค่าข้อความที่ล้อมรอบด้วยช่วงนี้ของรูปร่างหรือเซลล์ในตารางที่เชื่อมโยง

เอกสารโดยละเอียด

appendParagraph(text)

เพิ่มย่อหน้าที่ท้ายช่วงข้อความ ย่อหน้านั้นจะใช้การจัดรูปแบบของ จุดสิ้นสุดของช่วงข้อความปัจจุบัน

เพิ่มสตริงข้อความที่ให้ไว้เป็นย่อหน้าด้วยการเพิ่มสตริงข้อความอย่างน้อย 1 รายการโดยรอบ อักขระบรรทัดใหม่ในสตริง

เมื่อสตริงข้อความที่ระบุมีอักขระขึ้นบรรทัดใหม่ (ซึ่งประกอบด้วย paragraph) จะแสดงย่อหน้าสุดท้ายที่เพิ่ม

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringสตริงที่จะต่อท้ายเป็นย่อหน้า

รีเทิร์น

Paragraph — Paragraph ที่ต่อท้าย

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

appendRange(textRange)

แนบสำเนาของช่วงข้อความที่ให้ไว้ต่อท้ายช่วงข้อความปัจจุบัน

การจัดรูปแบบของข้อความที่แทรกจะตรงกับข้อความในต้นฉบับ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textRangeTextRangeช่วงข้อความที่จะต่อท้าย

รีเทิร์น

TextRange — ช่วงข้อความที่แสดงข้อความต่อท้าย

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

appendRange(textRange, matchSourceFormatting)

แนบสำเนาของช่วงข้อความที่ให้ไว้ต่อท้ายช่วงข้อความปัจจุบัน

หากตั้งค่าให้ตรงกันกับการจัดรูปแบบของข้อความปลายทาง AutoText ภายในข้อความที่ระบุ ระบบจะแทนที่ช่วงข้อความด้วยค่าที่แสดงผล นอกจากนี้ องค์ประกอบที่ไม่ใช่ข้อความภายใน ช่วงข้อความที่ระบุไม่ได้ต่อท้าย

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textRangeTextRangeช่วงข้อความที่จะต่อท้าย
matchSourceFormattingBooleanหากเป็น true ให้จับคู่การจัดรูปแบบของข้อความต้นฉบับ ถ้า false ให้จัดรูปแบบข้อความปลายทางให้ตรงกัน

รีเทิร์น

TextRange — ช่วงข้อความที่แสดงข้อความต่อท้าย

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

appendText(text)

เพิ่มข้อความต่อท้ายส่วนท้ายของช่วงข้อความ ข้อความจะรักษาสไตล์ของส่วนท้าย ข้อความที่มีอยู่

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringสตริงที่จะต่อท้าย

รีเทิร์น

TextRange — ช่วงข้อความที่แสดงข้อความต่อท้าย

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

asRenderedString()

แสดงผลข้อความที่แสดงผลที่มีขอบเขตโดยช่วงนี้ของรูปร่างหรือเซลล์ตารางที่เกี่ยวข้องใน ที่เหมาะสมเพื่อแสดงต่อผู้ใช้ปลายทาง

องค์ประกอบข้อความอัตโนมัติ เช่น หมายเลขสไลด์ที่สร้างขึ้น จะถูกแทนที่ด้วยค่าที่แสดงผล และละเว้นองค์ประกอบที่ไม่ใช่ข้อความในช่วง

รีเทิร์น

String

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

asString()

แสดงผลข้อความดิบที่มีขอบเขตโดยช่วงนี้ของรูปร่างหรือเซลล์ในตารางที่เกี่ยวข้อง

องค์ประกอบข้อความอัตโนมัติ เช่น หมายเลขสไลด์ที่สร้างขึ้น และองค์ประกอบที่ไม่ใช่ข้อความในช่วง แทนที่ด้วยอักขระ Unicode U+E907

รีเทิร์น

String

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

clear()

ล้างข้อความที่ล้อมรอบด้วยช่วงนี้

เนื่องจากข้อความทั้งหมดในรูปร่างหรือ TableCell จะต้องสิ้นสุดในบรรทัดใหม่ บรรทัดใหม่สุดท้ายใน ข้อความจะไม่ถูกนำออก

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

clear(startOffset, endOffset)

ล้างข้อความที่ล้อมรอบด้วยออฟเซ็ตเริ่มต้นและสิ้นสุดในช่วง

เนื่องจากข้อความต้องลงท้ายด้วยบรรทัดใหม่ บรรทัดใหม่สุดท้ายในข้อความจะไม่ถูกลบออกแม้ว่าจะ ครอบคลุมโดยการชดเชยที่ระบุ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
startOffsetIntegerจำนวนอักขระที่เลยดัชนีเริ่มต้นของช่วงข้อความปัจจุบันที่ใช้ เพื่อกำหนดดัชนีเริ่มต้นที่รวมค่าในช่วงที่จะล้าง ออฟเซ็ตเริ่มต้นต้องเป็น เท่ากับหรือมากกว่า 0 และน้อยกว่าหรือเท่ากับ endOffset startOffset ต้องน้อยกว่าความยาวของช่วงปัจจุบันด้วย
endOffsetIntegerจำนวนอักขระที่เลยดัชนีเริ่มต้นของช่วงข้อความปัจจุบันที่ใช้ เพื่อหาดัชนีสิ้นสุดพิเศษของช่วงที่จะล้าง endOffset ต้องเป็น เท่ากับหรือมากกว่า startOffset endOffset ต้องน้อยกว่าหรือ เท่ากับความยาวของช่วงปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

find(pattern)

แสดงผลช่วงทั้งหมดที่ตรงกับรูปแบบการค้นหาในช่วงข้อความปัจจุบัน การค้นหานั้น พิจารณาตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

พารามิเตอร์

ชื่อประเภทคำอธิบาย
patternStringรูปแบบนิพจน์ทั่วไปที่จะค้นหา เครื่องหมายแบ็กสแลชในรูปแบบนี้ ให้ Escape

รีเทิร์น

TextRange[]

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

find(pattern, startOffset)

แสดงผลช่วงทั้งหมดที่ตรงกับรูปแบบการค้นหาในช่วงข้อความปัจจุบัน โดยเริ่มจาก เริ่มต้นออฟเซ็ต การค้นหาจะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

พารามิเตอร์

ชื่อประเภทคำอธิบาย
patternStringรูปแบบนิพจน์ทั่วไปที่จะค้นหา เครื่องหมายแบ็กสแลชในรูปแบบนี้ ให้ Escape
startOffsetIntegerจำนวนอักขระที่เลยดัชนีเริ่มต้นของช่วงข้อความปัจจุบันที่ใช้ เพื่อหาดัชนีเริ่มต้นแบบรวมของช่วงที่จะค้นหา startOffset ต้อง จะน้อยกว่าความยาวของช่วงปัจจุบันด้วย

รีเทิร์น

TextRange[]

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getAutoTexts()

แสดงผลข้อความอัตโนมัติภายในช่วงข้อความปัจจุบัน

รีเทิร์น

AutoText[]

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getEndIndex()

แสดงดัชนีพิเศษแบบ 0 สำหรับอักขระตัวสุดท้ายในช่วงนี้ หากจุดเริ่มต้นและสิ้นสุด ดัชนีเท่ากัน จะถือว่าช่วงว่างเปล่า

รีเทิร์น

Integer

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getLength()

แสดงผลจำนวนอักขระในช่วงนี้

รีเทิร์น

Integer

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

แสดงคอลเล็กชันของช่วงข้อความที่สอดคล้องกับ Link ทั้งหมดในช่วงปัจจุบัน หรือซ้อนทับกับช่วงข้อความปัจจุบัน

ช่วงที่แสดงแต่ละช่วงที่ส่งคืนจะครอบคลุม 1 ลิงก์เมื่อสร้างแล้ว การแก้ไขข้อความ อาจทำให้หน้าไม่ได้แสดงลิงก์เดียวอีกต่อไป

Link แต่ละรายการในช่วงที่แสดงผลจะเข้าถึงได้ผ่าน 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

รีเทิร์น

TextRange[]

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getListParagraphs()

แสดงผลย่อหน้าในรายการที่ทับซ้อนกับช่วงข้อความปัจจุบัน

รีเทิร์น

Paragraph[]

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getListStyle()

แสดงผล ListStyle ของช่วงข้อความปัจจุบัน

รีเทิร์น

ListStyle

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getParagraphStyle()

แสดงผล ParagraphStyle ของช่วงข้อความปัจจุบัน

รีเทิร์น

ParagraphStyle

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getParagraphs()

แสดงผลย่อหน้าที่ทับซ้อนกับช่วงข้อความปัจจุบัน

รีเทิร์น

Paragraph[]

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getRange(startOffset, endOffset)

แสดงผล TextRange ใหม่ที่ครอบคลุมส่วนของช่วงที่ดึงมา

พารามิเตอร์

ชื่อประเภทคำอธิบาย
startOffsetIntegerจำนวนอักขระที่เลยดัชนีเริ่มต้นของช่วงข้อความปัจจุบันที่ใช้ เพื่อกำหนดดัชนีเริ่มต้นแบบรวมของช่วงที่ส่งคืน ออฟเซ็ตเริ่มต้นต้องเป็น เท่ากับหรือมากกว่า 0 และน้อยกว่าหรือเท่ากับ endOffset startOffset ต้องน้อยกว่าความยาวของช่วงปัจจุบันด้วย
endOffsetIntegerจำนวนอักขระที่เลยดัชนีเริ่มต้นของช่วงข้อความปัจจุบันที่ใช้ เพื่อกำหนดดัชนีสิ้นสุดพิเศษของช่วงที่ส่งคืน endOffset ต้องเป็น เท่ากับหรือมากกว่า startOffset endOffset ต้องน้อยกว่าหรือ เท่ากับความยาวของช่วงปัจจุบัน

รีเทิร์น

TextRange

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getRuns()

แสดงผลการเรียกใช้ข้อความที่ซ้อนทับกับช่วงข้อความปัจจุบัน การเรียกใช้ข้อความคือส่วนของข้อความ โดยที่อักขระทั้งหมดมีรูปแบบข้อความเดียวกัน

ช่วงที่แสดงผลแต่ละช่วงได้รับการรับประกันว่าจะครอบคลุมการเรียกใช้ได้ครั้งเดียวเท่านั้นเมื่อมีการสร้างช่วงดังกล่าว ข้อความหรือรูปแบบ การแก้ไขอาจทำให้รายการโฆษณาไม่ได้แสดงแค่ครั้งเดียวอีกต่อไป

รีเทิร์น

TextRange[]

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getStartIndex()

แสดงผลดัชนีรวมค่าฐาน 0 สำหรับอักขระตัวแรกในช่วงนี้ หากจุดเริ่มต้นและ ดัชนีสิ้นสุดมีค่าเท่ากัน จะถือว่าช่วงว่างเปล่า

รีเทิร์น

Integer

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getTextStyle()

แสดงผลรูปแบบข้อความของช่วง หรือ null หากไม่มีข้อมูลของช่วง

รีเทิร์น

TextStyle

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertParagraph(startOffset, text)

แทรกย่อหน้าที่ออฟเซ็ตเริ่มต้น ย่อหน้านั้นจะใช้การจัดรูปแบบของ ช่วงข้อความที่ออฟเซ็ตเริ่มต้น

แทรกสตริงข้อความที่ให้ไว้เป็นย่อหน้าโดยเพิ่มอย่างน้อย 1 สตริงล้อมรอบ อักขระบรรทัดใหม่ในสตริง

เมื่อสตริงข้อความที่ระบุมีอักขระขึ้นบรรทัดใหม่ (ซึ่งประกอบด้วย paragraph) จะแสดงย่อหน้าสุดท้ายที่เพิ่ม

พารามิเตอร์

ชื่อประเภทคำอธิบาย
startOffsetIntegerจำนวนอักขระที่เลยดัชนีเริ่มต้นของช่วงข้อความปัจจุบันที่ใช้ เพื่อกำหนดดัชนีเริ่มต้นที่รวมข้อความที่จะแทรก
textStringสตริงที่จะแทรก

รีเทิร์น

Paragraph — Paragraph ที่แทรกไว้

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertRange(startOffset, textRange)

แทรกสำเนาของช่วงข้อความที่ให้ไว้ที่ออฟเซ็ตเริ่มต้น

การจัดรูปแบบของข้อความที่แทรกจะตรงกับข้อความในต้นฉบับ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
startOffsetIntegerจำนวนอักขระที่เลยดัชนีเริ่มต้นของช่วงข้อความปัจจุบันที่ใช้ เพื่อกำหนดดัชนีเริ่มต้นที่รวมข้อความที่จะแทรก
textRangeTextRangeช่วงข้อความที่จะแทรก

รีเทิร์น

TextRange — ช่วงข้อความซึ่งแสดงข้อความที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertRange(startOffset, textRange, matchSourceFormatting)

แทรกสำเนาของช่วงข้อความที่ให้ไว้ที่ออฟเซ็ตเริ่มต้น

หากตั้งค่าให้ตรงกันกับการจัดรูปแบบของข้อความปลายทาง AutoText ภายในข้อความที่ระบุ ระบบจะแทนที่ช่วงข้อความด้วยค่าที่แสดงผล นอกจากนี้ องค์ประกอบที่ไม่ใช่ข้อความภายใน ไม่ได้แทรกช่วงข้อความที่ระบุ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
startOffsetIntegerจำนวนอักขระที่เลยดัชนีเริ่มต้นของช่วงข้อความปัจจุบันที่ใช้ เพื่อกำหนดดัชนีเริ่มต้นที่รวมข้อความที่จะแทรก
textRangeTextRangeช่วงข้อความที่จะแทรก
matchSourceFormattingBooleanหากเป็น true ให้จับคู่การจัดรูปแบบของข้อความต้นฉบับ ถ้า false ให้จัดรูปแบบข้อความปลายทางให้ตรงกัน

รีเทิร์น

TextRange — ช่วงข้อความซึ่งแสดงข้อความที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertText(startOffset, text)

แทรกข้อความที่ออฟเซ็ตเริ่มต้น ข้อความจะใช้การจัดรูปแบบของข้อความที่มีอยู่ตาม เริ่มต้นออฟเซ็ต

พารามิเตอร์

ชื่อประเภทคำอธิบาย
startOffsetIntegerจำนวนอักขระที่เลยดัชนีเริ่มต้นของช่วงข้อความปัจจุบันที่ใช้ เพื่อกำหนดดัชนีเริ่มต้นที่รวมข้อความที่จะแทรก
textStringสตริงที่จะแทรก

รีเทิร์น

TextRange — ช่วงข้อความที่แสดงถึงข้อความที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isEmpty()

แสดงผล true หากไม่มีอักขระในช่วงนี้ และแสดงค่า false หรือไม่เช่นนั้น

รีเทิร์น

Boolean

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replaceAllText(findText, replaceText)

แทนที่ข้อความทั้งหมดที่ตรงกับการค้นหาข้อความด้วย "แทนที่ข้อความ" การค้นหาเป็นแบบตัวพิมพ์ใหญ่ ขาดความไว

พารามิเตอร์

ชื่อประเภทคำอธิบาย
findTextStringข้อความที่จะค้นหา
replaceTextStringข้อความที่จะแทนที่ข้อความที่ตรงกัน

รีเทิร์น

Integer — จำนวนครั้งที่เปลี่ยนแปลง

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replaceAllText(findText, replaceText, matchCase)

แทนที่ข้อความทั้งหมดที่ตรงกับการค้นหาข้อความด้วย "แทนที่ข้อความ"

พารามิเตอร์

ชื่อประเภทคำอธิบาย
findTextStringข้อความที่จะค้นหา
replaceTextStringข้อความที่จะแทนที่ข้อความที่ตรงกัน
matchCaseBooleanหากเป็น true การค้นหาจะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ หากเป็น false การค้นหาจะเป็น ไม่คำนึงถึงตัวพิมพ์เล็กหรือใหญ่

รีเทิร์น

Integer — จำนวนครั้งที่เปลี่ยนแปลง

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

select()

เลือกเฉพาะ TextRange ในงานนำเสนอที่ใช้งานอยู่และนำรายการก่อนหน้าออก มากมาย

สคริปต์จะเข้าถึงการเลือกของผู้ใช้ที่กำลังเรียกใช้สคริปต์เท่านั้น และเฉพาะในกรณีที่ สคริปต์จะเชื่อมโยงกับงานนำเสนอ

ตั้งค่า Page ระดับบนสุดของ Shape ที่เกี่ยวข้องหรือ TableCell แล้ว เป็น current page selection Shape หรือ TableCell ได้รับการตั้งค่าเป็น selected page element

    Selection มีได้ 2 ประเภท ดังนี้
    • 1. ช่วงของข้อความ ให้ใช้การเลือกใน TextRange ที่ไม่ว่างเปล่าเพื่อเลือกช่วงของ อักขระ
    • 2. ตำแหน่งเคอร์เซอร์ ให้ใช้ TextRange ที่ว่างเปล่าเพื่อวางเคอร์เซอร์ที่ดัชนีที่ต้องการ 
      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();

      การให้สิทธิ์

      สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

      • https://www.googleapis.com/auth/presentations.currentonly
      • https://www.googleapis.com/auth/presentations

    setText(newText)

    ตั้งค่าข้อความที่ล้อมรอบด้วยช่วงนี้ของรูปร่างหรือเซลล์ในตารางที่เชื่อมโยง ข้อความจะรักษา การจัดรูปแบบจุดเริ่มต้นของข้อความที่มีอยู่

    พารามิเตอร์

    ชื่อประเภทคำอธิบาย
    newTextStringสตริงที่จะตั้งค่าเป็นข้อความใหม่

    รีเทิร์น

    TextRange — ช่วงข้อความที่แสดงถึงข้อความชุด

    การให้สิทธิ์

    สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

    • https://www.googleapis.com/auth/presentations.currentonly
    • https://www.googleapis.com/auth/presentations