ส่วนของเนื้อหาข้อความของ 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 | คำอธิบาย |
---|---|---|
text | String | สตริงที่จะต่อท้ายในย่อหน้า |
รีเทิร์น
Paragraph
— Paragraph
ที่ต่อท้าย
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendRange(textRange)
นำสำเนาของช่วงข้อความที่ให้ไว้ต่อท้ายส่วนท้ายของช่วงข้อความปัจจุบัน
การจัดรูปแบบของข้อความที่แทรกจะตรงกับรูปแบบของข้อความต้นฉบับ
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
textRange | TextRange | ช่วงข้อความที่จะต่อท้าย |
รีเทิร์น
TextRange
— ช่วงข้อความที่แทนข้อความที่ต่อท้าย
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendRange(textRange, matchSourceFormatting)
นำสำเนาของช่วงข้อความที่ให้ไว้ต่อท้ายส่วนท้ายของช่วงข้อความปัจจุบัน
หากตั้งค่าให้ตรงกับการจัดรูปแบบของข้อความปลายทาง ระบบจะแทนที่ AutoText
ภายในช่วงข้อความที่ระบุด้วยค่าที่แสดงผล นอกจากนี้ องค์ประกอบที่ไม่ใช่ข้อความ
ภายในช่วงข้อความที่ระบุจะไม่ต่อท้าย
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
textRange | TextRange | ช่วงข้อความที่จะต่อท้าย |
matchSourceFormatting | Boolean | หากเป็น true ให้เหมือนกับการจัดรูปแบบของข้อความต้นฉบับ หากเป็น false ให้เหมือนกับการจัดรูปแบบของข้อความปลายทาง |
รีเทิร์น
TextRange
— ช่วงข้อความที่แทนข้อความที่ต่อท้าย
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendText(text)
เพิ่มข้อความต่อท้ายช่วงข้อความ ข้อความจะมีการจัดรูปแบบส่วนท้ายของข้อความที่มีอยู่
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
text | String | สตริงที่จะต่อท้าย |
รีเทิร์น
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 | คำอธิบาย |
---|---|---|
startOffset | Integer | จำนวนอักขระหลังดัชนีเริ่มต้นของช่วงข้อความปัจจุบันที่ใช้กำหนดดัชนีเริ่มต้นแบบเหมารวมของช่วงที่จะล้าง ออฟเซ็ตเริ่มต้นต้องเท่ากับหรือมากกว่า 0 และน้อยกว่าหรือเท่ากับ endOffset startOffset และต้องน้อยกว่าความยาวของช่วงปัจจุบันด้วย |
endOffset | Integer | จำนวนอักขระหลังดัชนีเริ่มต้นของช่วงข้อความปัจจุบันที่ใช้เพื่อกำหนดดัชนีสิ้นสุดพิเศษของช่วงที่ต้องการล้าง endOffset ต้องเท่ากับหรือมากกว่า startOffset นอกจากนี้ endOffset ต้องน้อยกว่าหรือเท่ากับความยาวของช่วงปัจจุบัน |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
find(pattern)
แสดงผลช่วงทั้งหมดที่ตรงกับรูปแบบการค้นหาในช่วงข้อความปัจจุบัน การค้นหาคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
pattern | String | รูปแบบนิพจน์ทั่วไปที่จะค้นหา โดยเครื่องหมายแบ็กสแลชในรูปแบบดังกล่าวควรกำหนดเป็นอักขระหลีก |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
find(pattern, startOffset)
แสดงผลช่วงทั้งหมดที่ตรงกับรูปแบบการค้นหาในช่วงข้อความปัจจุบันโดยเริ่มจากออฟเซ็ตเริ่มต้น การค้นหาจะพิจารณาตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
pattern | String | รูปแบบนิพจน์ทั่วไปที่จะค้นหา โดยเครื่องหมายแบ็กสแลชในรูปแบบดังกล่าวควรกำหนดเป็นอักขระหลีก |
startOffset | Integer | จำนวนอักขระหลังดัชนีเริ่มต้นของช่วงข้อความปัจจุบันที่ใช้กำหนดดัชนีเริ่มต้นแบบเหมารวมของช่วงที่จะค้นหา startOffset ต้องน้อยกว่าความยาวของช่วงปัจจุบันด้วย |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getAutoTexts()
แสดงผลข้อความอัตโนมัติภายในช่วงข้อความปัจจุบัน
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 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
getLinks()
แสดงผลคอลเล็กชันของช่วงข้อความที่สอดคล้องกับ 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
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getListParagraphs()
แสดงผลย่อหน้าในรายการที่ทับซ้อนช่วงข้อความปัจจุบัน
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getListStyle()
getParagraphStyle()
แสดงผล ParagraphStyle
ของช่วงข้อความปัจจุบัน
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParagraphs()
แสดงผลย่อหน้าที่ทับซ้อนกับช่วงข้อความปัจจุบัน
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getRange(startOffset, endOffset)
แสดงผล TextRange
ใหม่ที่ครอบคลุมส่วนของช่วงที่ดึงมา
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
startOffset | Integer | จำนวนอักขระหลังดัชนีเริ่มต้นของช่วงข้อความปัจจุบันที่ใช้กำหนดดัชนีเริ่มต้นแบบเหมารวมของช่วงที่แสดงผล ออฟเซ็ตเริ่มต้นต้องเท่ากับหรือมากกว่า 0 และน้อยกว่าหรือเท่ากับ endOffset startOffset และต้องน้อยกว่าความยาวของช่วงปัจจุบันด้วย |
endOffset | Integer | จำนวนอักขระหลังดัชนีเริ่มต้นของช่วงข้อความปัจจุบันที่ใช้เพื่อกำหนดดัชนีสิ้นสุดพิเศษของช่วงที่แสดงผล endOffset ต้องเท่ากับหรือมากกว่า startOffset นอกจากนี้ endOffset ต้องน้อยกว่าหรือเท่ากับความยาวของช่วงปัจจุบัน |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getRuns()
แสดงผลการเรียกใช้ข้อความที่ซ้อนทับช่วงข้อความปัจจุบัน การเรียกใช้ข้อความคือส่วนของข้อความ ที่อักขระทั้งหมดมีรูปแบบข้อความเหมือนกัน
ช่วงที่แสดงผลแต่ละช่วงจะรับประกันได้ว่าจะมีการเรียกใช้เพียงครั้งเดียวเมื่อมีการสร้าง การแก้ไขข้อความหรือรูปแบบอาจทําให้ข้อความไม่แสดงการเรียกใช้ครั้งเดียวอีกต่อไป
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 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()
insertParagraph(startOffset, text)
แทรกย่อหน้าที่ตำแหน่งเริ่มต้น ย่อหน้าจะคงการจัดรูปแบบของช่วงข้อความปัจจุบันที่ออฟเซ็ตเริ่มต้น
ระบบจะแทรกสตริงข้อความที่ระบุเป็นย่อหน้าโดยการเพิ่มอักขระขึ้นบรรทัดใหม่ที่อยู่ล้อมรอบอย่างน้อย 1 ตัวในสตริง
เมื่อสตริงข้อความที่ระบุมีอักขระขึ้นบรรทัดใหม่ (ซึ่งประกอบด้วยหลายย่อหน้า) ระบบจะแสดงย่อหน้าสุดท้ายที่เพิ่ม
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
startOffset | Integer | จำนวนอักขระหลังดัชนีเริ่มต้นของช่วงข้อความปัจจุบันที่ใช้กำหนดดัชนีเริ่มต้นแบบเหมารวมของข้อความที่จะแทรก |
text | String | สตริงที่จะแทรก |
รีเทิร์น
Paragraph
— Paragraph
ที่แทรกไว้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertRange(startOffset, textRange)
แทรกสำเนาของช่วงข้อความที่ให้ไว้ที่ออฟเซ็ตเริ่มต้น
การจัดรูปแบบของข้อความที่แทรกจะตรงกับรูปแบบของข้อความต้นฉบับ
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
startOffset | Integer | จำนวนอักขระหลังดัชนีเริ่มต้นของช่วงข้อความปัจจุบันที่ใช้กำหนดดัชนีเริ่มต้นแบบเหมารวมของข้อความที่จะแทรก |
textRange | TextRange | ช่วงข้อความที่จะแทรก |
รีเทิร์น
TextRange
— ช่วงข้อความที่แทนข้อความที่แทรก
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertRange(startOffset, textRange, matchSourceFormatting)
แทรกสำเนาของช่วงข้อความที่ให้ไว้ที่ออฟเซ็ตเริ่มต้น
หากตั้งค่าให้ตรงกับการจัดรูปแบบของข้อความปลายทาง ระบบจะแทนที่ AutoText
ภายในช่วงข้อความที่ระบุด้วยค่าที่แสดงผล นอกจากนี้ ระบบจะไม่แทรกองค์ประกอบที่ไม่ใช่ข้อความ
ภายในช่วงข้อความที่ระบุ
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
startOffset | Integer | จำนวนอักขระหลังดัชนีเริ่มต้นของช่วงข้อความปัจจุบันที่ใช้กำหนดดัชนีเริ่มต้นแบบเหมารวมของข้อความที่จะแทรก |
textRange | TextRange | ช่วงข้อความที่จะแทรก |
matchSourceFormatting | Boolean | หากเป็น true ให้เหมือนกับการจัดรูปแบบของข้อความต้นฉบับ หากเป็น false ให้เหมือนกับการจัดรูปแบบของข้อความปลายทาง |
รีเทิร์น
TextRange
— ช่วงข้อความที่แทนข้อความที่แทรก
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertText(startOffset, text)
แทรกข้อความที่ออฟเซ็ตเริ่มต้น ข้อความจะคงการจัดรูปแบบข้อความที่มีอยู่ไว้ที่ออฟเซ็ตเริ่มต้น
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
startOffset | Integer | จำนวนอักขระหลังดัชนีเริ่มต้นของช่วงข้อความปัจจุบันที่ใช้กำหนดดัชนีเริ่มต้นแบบเหมารวมของข้อความที่จะแทรก |
text | String | สตริงที่จะแทรก |
รีเทิร์น
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 | คำอธิบาย |
---|---|---|
findText | String | ข้อความที่จะค้นหา |
replaceText | String | ข้อความที่จะแทนที่ข้อความที่ตรงกัน |
รีเทิร์น
Integer
— จำนวนครั้งที่เปลี่ยนแปลง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText, matchCase)
แทนที่ทุกอินสแตนซ์ของการค้นหาข้อความที่ตรงกับการค้นหาด้วยการแทนที่ข้อความ
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
findText | String | ข้อความที่จะค้นหา |
replaceText | String | ข้อความที่จะแทนที่ข้อความที่ตรงกัน |
matchCase | Boolean | หากเป็น 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 | คำอธิบาย |
---|---|---|
newText | String | สตริงที่จะตั้งเป็นข้อความใหม่ |
รีเทิร์น
TextRange
— ช่วงข้อความที่แสดงข้อความในชุด
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations