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

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
textStringสตริงที่จะต่อท้ายในย่อหน้า

รีเทิร์น

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

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

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

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

appendRange(textRange)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

appendRange(textRange, matchSourceFormatting)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

appendText(text)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

asRenderedString()

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

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

รีเทิร์น

String

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

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

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

asString()

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

ระบบจะแทนที่องค์ประกอบ AutoText เช่น หมายเลขสไลด์ที่สร้างขึ้นและองค์ประกอบที่ไม่ใช่ข้อความในช่วงดังกล่าวด้วยอักขระ 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)

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

เนื่องจากข้อความต้องสิ้นสุดในบรรทัดใหม่ ระบบจะไม่นำบรรทัดใหม่สุดท้ายในข้อความออก แม้ว่าออฟเซ็ตที่ระบุจะมาบดบังข้อความก็ตาม

พารามิเตอร์

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

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

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

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

find(pattern)

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

พารามิเตอร์

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

รีเทิร์น

TextRange[]

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

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

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

find(pattern, startOffset)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
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.
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 ใหม่ที่ครอบคลุมส่วนของช่วงที่ดึงมา

พารามิเตอร์

ชื่อTypeคำอธิบาย
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 ตัวในสตริง

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

insertRange(startOffset, textRange)

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

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

พารามิเตอร์

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

รีเทิร์น

TextRange — ช่วงข้อความที่แทนข้อความที่แทรก

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

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

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

insertRange(startOffset, textRange, matchSourceFormatting)

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

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

พารามิเตอร์

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

รีเทิร์น

TextRange — ช่วงข้อความที่แทนข้อความที่แทรก

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

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

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

insertText(startOffset, text)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
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)

แทนที่ทุกอินสแตนซ์ของการค้นหาข้อความที่ตรงกับการค้นหาด้วยการแทนที่ข้อความ การค้นหานี้ไม่คำนึงถึงตัวพิมพ์เล็กหรือใหญ่

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

replaceAllText(findText, replaceText, matchCase)

แทนที่ทุกอินสแตนซ์ของการค้นหาข้อความที่ตรงกับการค้นหาด้วยการแทนที่ข้อความ

พารามิเตอร์

ชื่อTypeคำอธิบาย
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)

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

    พารามิเตอร์

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

    รีเทิร์น

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

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

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

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