แก้ไขและจัดรูปแบบข้อความโดยใช้ช่วงข้อความ ซึ่งแสดงด้วยประเภท
TextRange TextRange แสดงถึงส่วนของข้อความภายในรูปร่างหรือ
ภายในเซลล์ตาราง การเรียก getText ในรูปร่างหรือเซลล์ตารางจะแสดงผลช่วงข้อความที่ครอบคลุมข้อความทั้งหมด
หากคุณใช้วิธีที่แก้ไขวิธีที่ข้อความพอดีกับรูปร่าง ระบบจะปิดใช้งานการตั้งค่าการปรับพอดีอัตโนมัติ ที่ใช้กับรูปร่าง
ใช้ช่วงข้อความ
ช่วงข้อความมีดัชนี 2 รายการที่กำหนดขอบเขตของส่วนข้อความ
ที่ครอบคลุมโดยช่วงข้อความ ได้แก่ ดัชนีเริ่มต้นและดัชนีสิ้นสุด กำหนดดัชนีเหล่านี้โดยใช้ฟังก์ชัน getStartIndex และ getEndIndex
ดัชนีเริ่มต้นของช่วงข้อความจะนับรวม และดัชนีสิ้นสุด จะไม่นับรวม ดัชนีทั้ง 2 รายการเป็นแบบอิงตาม 0
หากต้องการอ่านเนื้อหาของช่วงข้อความ ให้ใช้ฟังก์ชัน asString หรือ asRenderedString
หากต้องการดึงข้อมูลช่วงย่อยจากภายในช่วงข้อความ ให้ใช้ฟังก์ชัน getRange
สคริปต์ต่อไปนี้จะสร้างกล่องข้อความ ในสไลด์แรกและตั้งค่าเนื้อหาข้อความ เป็น "Hello world!" จากนั้นจะดึงข้อมูลช่วงย่อยที่ครอบคลุมเฉพาะ "Hello"
ช่วงข้อความที่รูปร่างหรือเซลล์ตารางแสดงผลจะครอบคลุมข้อความทั้งหมดเสมอ แม้ว่าจะมีการแทรกและลบข้อความก็ตาม ดังนั้นตัวอย่างนี้จึงสร้างข้อความบันทึกต่อไปนี้
Start: 0; End: 13; Content: Hello world!
Start: 0; End: 5; Content: Hello
แทรกและลบข้อความ
คุณแทรกและลบข้อความในรูปร่างและเซลล์ตารางได้โดยใช้ช่วงข้อความ
insertTextและappendTextช่วยให้คุณแทรกข้อความได้setTextจะแทนที่ข้อความของช่วงข้อความด้วยข้อความที่ระบุclearจะลบข้อความจากภายในช่วงข้อความ
สคริปต์ต่อไปนี้แสดงการใช้ฟังก์ชันเหล่านี้
สคริปต์นี้จะสร้างกล่องข้อความในสไลด์แรกและตั้งค่าเนื้อหาข้อความเป็น "Hello world!" จากนั้นจะลบอักขระที่ 6 ถึง 11 ("world") และ แทรกข้อความ "galaxy" ที่ดัชนี 6 แทน ตัวอย่างนี้จะสร้างข้อความบันทึกต่อไปนี้
Start: 0; End: 14; Content: Hello galaxy!
ค้นหาและแทนที่
ใช้ฟังก์ชัน replaceAllText ในงานนำเสนอหรือหน้าเว็บเพื่อค้นหาและแทนที่ทั่วทั้งงานนำเสนอหรือหน้าเว็บที่เฉพาะเจาะจง
find ฟังก์ชันใน TextRange จะแสดงอินสแตนซ์ของสตริงภายใน
ช่วง ใช้ร่วมกับ setText เพื่อค้นหาและแทนที่
ภายในรูปร่างหรือเซลล์ตารางได้
ย่อหน้า รายการ และการเรียกใช้
TextRange มีฟังก์ชันที่แสดงผลคอลเล็กชันเอนทิตีข้อความที่มีประโยชน์
ฟังก์ชันบางอย่าง ได้แก่
getParagraphs,ซึ่งแสดงย่อหน้าทั้งหมดที่ทับซ้อนกับช่วงข้อความ ย่อหน้าคือลำดับของข้อความที่สิ้นสุดด้วยอักขระขึ้นบรรทัดใหม่ "\n"getListParagraphs,ซึ่งจะแสดงผลรายการในข้อความปัจจุบันgetRuns,ซึ่งจะแสดงข้อความที่ทับซ้อนกับช่วงข้อความปัจจุบัน A การเรียกใช้ข้อความคือส่วนของข้อความที่อักขระทั้งหมดมีรูปแบบข้อความเดียวกัน
การจัดรูปแบบข้อความ
รูปแบบข้อความจะเป็นตัวกำหนดการแสดงอักขระข้อความในงานนำเสนอ ซึ่งรวมถึงแบบอักษร สี และไฮเปอร์ลิงก์
ฟังก์ชัน getTextStyle ของช่วงข้อความจะให้ออบเจ็กต์ TextStyle
ที่ใช้สำหรับ
จัดรูปแบบข้อความ ออบเจ็กต์ TextStyle ครอบคลุมข้อความเดียวกันกับออบเจ็กต์หลัก
TextRange
ตัวอย่างก่อนหน้านี้จะสร้างกล่องข้อความในสไลด์แรกก่อน แล้วตั้งค่าเนื้อหาเป็น "Hello " จากนั้นจะต่อท้ายด้วยข้อความ "world!" ข้อความที่เพิ่มใหม่
จะแสดงเป็นตัวหนา ลิงก์ไปยัง www.example.com และตั้งค่าสี
เป็นสีแดง
เมื่ออ่านรูปแบบ ฟังก์ชันจะแสดงผลเป็น Null หากช่วงมีค่าหลายค่า สำหรับรูปแบบ ดังนั้นตัวอย่างนี้จึงสร้างคำสั่งบันทึกต่อไปนี้
Text: Hello; Bold: false
Text: world!; Bold: true
Text: Hello world!; Bold: null
นอกจากนี้ยังมีสไตล์อื่นๆ อีกมากมายที่ใช้กับข้อความได้ ดูรายละเอียดเพิ่มเติมได้ในTextStyleเอกสารอ้างอิง
การจัดรูปแบบย่อหน้า
รูปแบบย่อหน้าจะมีผลกับทั้งย่อหน้า และรวมถึงสิ่งต่างๆ เช่น การจัดแนวข้อความและระยะห่างบรรทัด ฟังก์ชัน getParagraphStyle ใน TextRange มีออบเจ็กต์
ParagraphStyle
สำหรับการจัดรูปแบบย่อหน้าทั้งหมดที่ทับซ้อนกับช่วงข้อความหลัก
ตัวอย่างต่อไปนี้จะสร้างกล่องข้อความในสไลด์แรกที่มี 4 ย่อหน้า จากนั้นจะจัดกึ่งกลาง 3 ย่อหน้าแรก
การจัดรูปแบบรายการ
ListStyle สามารถใช้จัดรูปแบบย่อหน้าทั้งหมดที่ทับซ้อนกับช่วงข้อความขององค์ประกอบระดับบนสุดได้เช่นเดียวกับ ParagraphStyle
ตัวอย่างก่อนหน้าจะสร้างกล่องข้อความในสไลด์แรกซึ่งมี 4 ย่อหน้า โดยย่อหน้าที่ 2 จะมีการเยื้อง 1 ครั้ง และย่อหน้าที่ 3 จะมีการเยื้อง 2 ครั้ง จากนั้นจะใช้ค่าที่กำหนดล่วงหน้าของรายการกับย่อหน้าทั้งหมด สุดท้าย ระบบจะบันทึกระดับการซ้อนของแต่ละ ย่อหน้า ระดับการซ้อนของย่อหน้ามาจาก จำนวนแท็บก่อนข้อความของย่อหน้า ดังนั้นสคริปต์จะสร้างข้อความบันทึกต่อไปนี้
Paragraph 1's nesting level: 0
Paragraph 2's nesting level: 1
Paragraph 3's nesting level: 2
Paragraph 4's nesting level: 0