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 ตัวในสตริง

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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 ทั้งหมดภายในช่วงข้อความปัจจุบันหรือทับซ้อนกับช่วงข้อความปัจจุบัน

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

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

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

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