Class 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 ตัวที่ล้อมรอบสตริง

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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()

ล้างข้อความที่อยู่ในขอบเขตของช่วงนี้

เนื่องจากข้อความทั้งหมดใน Shape หรือ 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รูปแบบนิพจน์ทั่วไปที่จะค้นหา โดยควรหลีกเลี่ยงเครื่องหมายแบ็กสแลชในรูปแบบ

รีเทิร์น

TextRange[] - รายการช่วงข้อความ

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

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

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

find(pattern, startOffset)

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
patternStringรูปแบบนิพจน์ทั่วไปที่จะค้นหา โดยควรหลีกเลี่ยงเครื่องหมายแบ็กสแลชในรูปแบบ
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.
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

รีเทิร์น

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 ตัวที่ล้อมรอบสตริง

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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 — true หากไม่มีอักขระในขอบเขตนี้ และแสดงผล false ในกรณีอื่นๆ

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

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 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 ที่ว่างเปล่าเพื่อวางเคอร์เซอร์ที่ดัชนีที่ต้องการ 
      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();

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

      สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 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