Class TextStyle

ข้อความรูปแบบ

รูปแบบของข้อความ

เมธอดการอ่านในคลาสนี้จะแสดงผล null หาก TextRange ที่เกี่ยวข้องครอบคลุม การเรียกใช้ข้อความหลายรายการ และการเรียกใช้เหล่านั้นมีค่าที่แตกต่างกันสำหรับเมธอดการอ่านที่เรียกใช้ หากต้องการหลีกเลี่ยงปัญหานี้ ให้ค้นหาสไตล์ข้อความโดยใช้ TextRanges ที่ส่งคืนโดยเมธอด TextRange.getRuns()

หากคุณใช้วิธีที่แก้ไขวิธีที่ข้อความพอดีกับรูปร่าง ระบบจะปิดใช้งานการตั้งค่าการปรับพอดีอัตโนมัติที่ใช้กับ รูปแบบข้อความ

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
getBackgroundColor()Color|nullแสดงสีพื้นหลังของข้อความ หรือ null หากมีหลายรูปแบบในข้อความ
getBaselineOffset()TextBaselineOffset|nullแสดงผลออฟเซ็ตแนวตั้งของข้อความจากตำแหน่งปกติ หรือ null หากข้อความมีหลายรูปแบบ
getFontFamily()String|nullแสดงผลตระกูลแบบอักษรของข้อความ หรือ null หากข้อความมีหลายสไตล์
getFontSize()Number|nullแสดงผลขนาดแบบอักษรของข้อความในหน่วยพอยต์ หรือ null หากข้อความมีหลายรูปแบบ
getFontWeight()Integer|nullแสดงผลน้ำหนักแบบอักษรของข้อความ หรือ null หากข้อความมีหลายรูปแบบ
getForegroundColor()Color|nullแสดงสีพื้นหน้าของข้อความ หรือ null หากข้อความมีหลายรูปแบบ
getLink()Link|nullแสดง Link ในข้อความ หรือ null หากไม่มีลิงก์ หรือหากลิงก์อยู่ใน ส่วนของข้อความ หรือหากมีหลายลิงก์
hasLink()Boolean|nullแสดง true หากมีลิงก์ในข้อความ false หากไม่มี หรือ null หากลิงก์อยู่ในข้อความบางส่วนหรือมีหลายลิงก์
isBackgroundTransparent()Boolean|nullแสดงผล true หากพื้นหลังของข้อความเป็นแบบโปร่งใส false หากไม่ใช่ หรือ null หากข้อความมีหลายสไตล์
isBold()Boolean|nullแสดงผล true หากข้อความแสดงผลเป็นตัวหนา false หากไม่เป็น หรือ null หาก ข้อความมีหลายรูปแบบ
isItalic()Boolean|nullแสดงผล true หากข้อความเป็นตัวเอียง false หากไม่ใช่ หรือ null หากข้อความมีหลายรูปแบบ
isSmallCaps()Boolean|nullแสดงผล true หากข้อความเป็นตัวพิมพ์เล็ก false หากไม่ใช่ หรือ null หากข้อความมีหลายรูปแบบ
isStrikethrough()Boolean|nullแสดงผล true หากข้อความมีการขีดทับ false หากไม่มี หรือ null หาก ข้อความมีหลายสไตล์
isUnderline()Boolean|nullแสดงผล true หากข้อความมีขีดเส้นใต้ false หากไม่มี หรือ null หากข้อความมีหลายรูปแบบ
removeLink()TextStyleนำ Link ออก
setBackgroundColor(color)TextStyleตั้งค่าสีพื้นหลังของข้อความ
setBackgroundColor(red, green, blue)TextStyleตั้งค่าสีพื้นหลังของข้อความเป็นค่า RGB ที่กำหนดจาก 0 ถึง 255
setBackgroundColor(hexColor)TextStyleตั้งค่าสีพื้นหลังของข้อความเป็นสตริงสีเลขฐานสิบหกที่ระบุ
setBackgroundColor(color)TextStyleตั้งค่าสีพื้นหลังของข้อความเป็น ThemeColorType ที่ระบุ
setBackgroundColorTransparent()TextStyleตั้งค่าสีพื้นหลังของข้อความเป็นแบบโปร่งใส
setBaselineOffset(offset)TextStyleตั้งค่าออฟเซ็ตแนวตั้งของข้อความที่สัมพันธ์กับตำแหน่งปกติ
setBold(bold)TextStyleกำหนดว่าจะแสดงข้อความเป็นตัวหนาหรือไม่
setFontFamily(fontFamily)TextStyleกำหนดชุดแบบอักษรของข้อความ
setFontFamilyAndWeight(fontFamily, fontWeight)TextStyleกำหนดชุดแบบอักษรและน้ำหนักของข้อความ
setFontSize(fontSize)TextStyleกำหนดขนาดแบบอักษรของข้อความในหน่วยพอยต์
setForegroundColor(foregroundColor)TextStyleตั้งค่าสีพื้นหน้าของข้อความ
setForegroundColor(red, green, blue)TextStyleตั้งค่าสีพื้นหน้าของข้อความเป็นค่า RGB ที่กำหนดจาก 0 ถึง 255
setForegroundColor(hexColor)TextStyleกำหนดสีพื้นหน้าของข้อความเป็นสตริงสีฐานสิบหกที่ระบุ
setForegroundColor(color)TextStyleตั้งค่าสีพื้นหน้าของข้อความเป็น ThemeColorType ที่ระบุ
setItalic(italic)TextStyleกำหนดว่าข้อความจะเป็นตัวเอียงหรือไม่
setLinkSlide(slideIndex)TextStyleตั้งค่า Link เป็น Slide ที่ระบุโดยใช้ดัชนีแบบอิงตาม 0 ของสไลด์
setLinkSlide(slide)TextStyleตั้งค่า Link เป็น Slide ที่ระบุ โดยลิงก์จะตั้งค่าตามรหัสสไลด์ที่ระบุ
setLinkSlide(slidePosition)TextStyleตั้งค่า Link เป็น Slide ที่ระบุโดยใช้ตำแหน่งสัมพัทธ์ของสไลด์
setLinkUrl(url)TextStyleตั้งค่า Link เป็นสตริง URL ที่ไม่ใช่สตริงว่างที่ระบุ
setSmallCaps(smallCaps)TextStyleกำหนดว่าจะแสดงข้อความเป็นตัวพิมพ์เล็กหรือตัวพิมพ์ใหญ่
setStrikethrough(strikethrough)TextStyleกำหนดว่าจะขีดทับข้อความหรือไม่
setUnderline(underline)TextStyleกำหนดว่าข้อความมีขีดเส้นใต้หรือไม่

เอกสารโดยละเอียด

getBackgroundColor()

แสดงสีพื้นหลังของข้อความ หรือ null หากมีหลายรูปแบบในข้อความ

รีเทิร์น

Color|null

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

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

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

getBaselineOffset()

แสดงผลออฟเซ็ตแนวตั้งของข้อความจากตำแหน่งปกติ หรือ null หากข้อความมีหลายรูปแบบ

รีเทิร์น

TextBaselineOffset|null

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

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

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

getFontFamily()

แสดงผลตระกูลแบบอักษรของข้อความ หรือ null หากข้อความมีหลายสไตล์

รีเทิร์น

String|null

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

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

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

getFontSize()

แสดงผลขนาดแบบอักษรของข้อความในหน่วยพอยต์ หรือ null หากข้อความมีหลายรูปแบบ

รีเทิร์น

Number|null

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

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

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

getFontWeight()

แสดงผลน้ำหนักแบบอักษรของข้อความ หรือ null หากข้อความมีหลายรูปแบบ

น้ำหนักต้องเป็นจำนวนที่เพิ่มขึ้นทีละ 100 ระหว่าง 100 ถึง 900 ช่วงนี้สอดคล้องกับ ค่าตัวเลขที่อธิบายไว้ในข้อกำหนด CSS 2.1 ส่วนที่ 15.6 โดย ไม่อนุญาตค่าที่ไม่ใช่ตัวเลข น้ำหนักที่มากกว่าหรือเท่ากับ 700 จะถือเป็นตัวหนา ในกรณีนี้ isBold() จะแสดงผล true ค่าเริ่มต้นคือ 400 ("normal")

รีเทิร์น

Integer|null

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

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

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

getForegroundColor()

แสดงสีพื้นหน้าของข้อความ หรือ null หากข้อความมีหลายรูปแบบ

รีเทิร์น

Color|null

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

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

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

แสดง Link ในข้อความ หรือ null หากไม่มีลิงก์ หรือหากลิงก์อยู่ใน ส่วนของข้อความ หรือหากมีหลายลิงก์ โทรหา hasLink() เพื่อตรวจสอบว่าข้อความไม่มีลิงก์หรือไม่ 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const textLink = shape.getText().getTextStyle().getLink();
if (textLink != null) {
  Logger.log(`Shape text has a link of type: ${textLink.getLinkType()}`);
}

รีเทิร์น

Link|null

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

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

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

แสดง true หากมีลิงก์ในข้อความ false หากไม่มี หรือ null หากลิงก์อยู่ในข้อความบางส่วนหรือมีหลายลิงก์

ตั้งค่าลิงก์ในอักขระขึ้นบรรทัดใหม่ไม่ได้ ดังนั้น หาก TextRange มีอักขระขึ้นบรรทัดใหม่ เมธอดนี้จะแสดงผล null หรือ false เสมอ

รีเทิร์น

Boolean|null

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

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

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

isBackgroundTransparent()

แสดงผล true หากพื้นหลังของข้อความเป็นแบบโปร่งใส false หากไม่ใช่ หรือ null หากข้อความมีหลายสไตล์

รีเทิร์น

Boolean|null

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

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

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

isBold()

แสดงผล true หากข้อความแสดงผลเป็นตัวหนา false หากไม่เป็น หรือ null หาก ข้อความมีหลายรูปแบบ

รีเทิร์น

Boolean|null

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

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

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

isItalic()

แสดงผล true หากข้อความเป็นตัวเอียง false หากไม่ใช่ หรือ null หากข้อความมีหลายรูปแบบ

รีเทิร์น

Boolean|null

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

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

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

isSmallCaps()

แสดงผล true หากข้อความเป็นตัวพิมพ์เล็ก false หากไม่ใช่ หรือ null หากข้อความมีหลายรูปแบบ

รีเทิร์น

Boolean|null

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

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

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

isStrikethrough()

แสดงผล true หากข้อความมีการขีดทับ false หากไม่มี หรือ null หาก ข้อความมีหลายสไตล์

รีเทิร์น

Boolean|null

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

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

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

isUnderline()

แสดงผล true หากข้อความมีขีดเส้นใต้ false หากไม่มี หรือ null หากข้อความมีหลายรูปแบบ

รีเทิร์น

Boolean|null

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

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

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

นำ Link ออก

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

const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().removeLink();

รีเทิร์น

TextStyle

setBackgroundColor(color)

ตั้งค่าสีพื้นหลังของข้อความ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorColor

รีเทิร์น

TextStyle

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

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

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

setBackgroundColor(red, green, blue)

ตั้งค่าสีพื้นหลังของข้อความเป็นค่า RGB ที่กำหนดจาก 0 ถึง 255

พารามิเตอร์

ชื่อประเภทคำอธิบาย
redInteger
greenInteger
blueInteger

รีเทิร์น

TextStyle

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

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

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

setBackgroundColor(hexColor)

ตั้งค่าสีพื้นหลังของข้อความเป็นสตริงสีเลขฐานสิบหกที่ระบุ

สตริงเลขฐานสิบหกต้องอยู่ในรูปแบบ "#RRGGBB" เช่น สีชมพูจะแสดงเป็น "#FFC0CB"

พารามิเตอร์

ชื่อประเภทคำอธิบาย
hexColorString

รีเทิร์น

TextStyle

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

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

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

setBackgroundColor(color)

ตั้งค่าสีพื้นหลังของข้อความเป็น ThemeColorType ที่ระบุ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorThemeColorType

รีเทิร์น

TextStyle

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

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

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

setBackgroundColorTransparent()

ตั้งค่าสีพื้นหลังของข้อความเป็นแบบโปร่งใส

รีเทิร์น

TextStyle

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

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

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

setBaselineOffset(offset)

ตั้งค่าออฟเซ็ตแนวตั้งของข้อความที่สัมพันธ์กับตำแหน่งปกติ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
offsetTextBaselineOffset

รีเทิร์น

TextStyle

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

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

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

setBold(bold)

กำหนดว่าจะแสดงข้อความเป็นตัวหนาหรือไม่

การเปลี่ยนความหนาของข้อความจะอัปเดตความหนาของแบบอักษรที่ใช้ในการแสดงข้อความ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
boldBoolean

รีเทิร์น

TextStyle

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

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

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

setFontFamily(fontFamily)

กำหนดชุดแบบอักษรของข้อความ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
fontFamilyString

รีเทิร์น

TextStyle

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

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

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

setFontFamilyAndWeight(fontFamily, fontWeight)

กำหนดชุดแบบอักษรและน้ำหนักของข้อความ

น้ำหนักต้องเป็นจำนวนที่เพิ่มขึ้นทีละ 100 ระหว่าง 100 ถึง 900 ช่วงนี้สอดคล้องกับ ค่าตัวเลขที่อธิบายไว้ในข้อกำหนด CSS 2.1 ส่วนที่ 15.6 โดย ไม่อนุญาตค่าที่ไม่ใช่ตัวเลข น้ำหนักที่มากกว่าหรือเท่ากับ 700 จะถือเป็นตัวหนา ในกรณีนี้ isBold() จะแสดงผล true ค่าเริ่มต้นคือ 400 ("normal")

พารามิเตอร์

ชื่อประเภทคำอธิบาย
fontFamilyString
fontWeightInteger

รีเทิร์น

TextStyle

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

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

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

setFontSize(fontSize)

กำหนดขนาดแบบอักษรของข้อความในหน่วยพอยต์

พารามิเตอร์

ชื่อประเภทคำอธิบาย
fontSizeNumber

รีเทิร์น

TextStyle

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

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

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

setForegroundColor(foregroundColor)

ตั้งค่าสีพื้นหน้าของข้อความ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
foregroundColorColor

รีเทิร์น

TextStyle

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

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

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

setForegroundColor(red, green, blue)

ตั้งค่าสีพื้นหน้าของข้อความเป็นค่า RGB ที่กำหนดจาก 0 ถึง 255

พารามิเตอร์

ชื่อประเภทคำอธิบาย
redInteger
greenInteger
blueInteger

รีเทิร์น

TextStyle

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

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

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

setForegroundColor(hexColor)

กำหนดสีพื้นหน้าของข้อความเป็นสตริงสีฐานสิบหกที่ระบุ

สตริงเลขฐานสิบหกต้องอยู่ในรูปแบบ "#RRGGBB" เช่น สีชมพูจะแสดงเป็น "#FFC0CB"

พารามิเตอร์

ชื่อประเภทคำอธิบาย
hexColorString

รีเทิร์น

TextStyle

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

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

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

setForegroundColor(color)

ตั้งค่าสีพื้นหน้าของข้อความเป็น ThemeColorType ที่ระบุ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorThemeColorType

รีเทิร์น

TextStyle

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

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

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

setItalic(italic)

กำหนดว่าข้อความจะเป็นตัวเอียงหรือไม่

พารามิเตอร์

ชื่อประเภทคำอธิบาย
italicBoolean

รีเทิร์น

TextStyle

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

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

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

setLinkSlide(slideIndex)

ตั้งค่า Link เป็น Slide ที่ระบุโดยใช้ดัชนีแบบอิงตาม 0 ของสไลด์

การตั้งค่าลิงก์จะเปลี่ยนรูปแบบของข้อความให้มีขีดเส้นใต้และมีThemeColorType.HYPERLINKสีพื้นหน้า คุณเปลี่ยนการตั้งค่านี้ได้ผ่านsetForegroundColor(hexColor)และsetUnderline(underline)

เนื่องจากตั้งค่าลิงก์ในอักขระขึ้นบรรทัดใหม่ไม่ได้ ระบบจึงจะละเว้นอักขระขึ้นบรรทัดใหม่ใน TextRange 

// Set a link to the first slide of the presentation.
const presentation = SlidesApp.getActivePresentation();
const slide = presentation.getSlides()[0];
const textRange = slide.getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(0);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
slideIndexIntegerดัชนีแบบ 0 ของสไลด์

รีเทิร์น

TextStyle

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

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

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

setLinkSlide(slide)

ตั้งค่า Link เป็น Slide ที่ระบุ โดยลิงก์จะตั้งค่าตามรหัสสไลด์ที่ระบุ

การตั้งค่าลิงก์จะเปลี่ยนรูปแบบของข้อความให้มีขีดเส้นใต้และมีThemeColorType.HYPERLINKสีพื้นหน้า คุณเปลี่ยนการตั้งค่านี้ได้ผ่านsetForegroundColor(hexColor)และsetUnderline(underline)

เนื่องจากตั้งค่าลิงก์ในอักขระขึ้นบรรทัดใหม่ไม่ได้ ระบบจึงจะละเว้นอักขระขึ้นบรรทัดใหม่ใน TextRange 

// Set a link to the first slide of the presentation.
const presentation = SlidesApp.getActivePresentation();
const slide = presentation.getSlides()[0];
const textRange = slide.getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(slide);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
slideSlideSlide ที่จะลิงก์

รีเทิร์น

TextStyle

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

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

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

setLinkSlide(slidePosition)

ตั้งค่า Link เป็น Slide ที่ระบุโดยใช้ตำแหน่งสัมพัทธ์ของสไลด์

การตั้งค่าลิงก์จะเปลี่ยนรูปแบบของข้อความให้มีขีดเส้นใต้และมีThemeColorType.HYPERLINKสีพื้นหน้า คุณเปลี่ยนการตั้งค่านี้ได้ผ่านsetForegroundColor(hexColor)และsetUnderline(underline)

เนื่องจากตั้งค่าลิงก์ในอักขระขึ้นบรรทัดใหม่ไม่ได้ ระบบจึงจะละเว้นอักขระขึ้นบรรทัดใหม่ใน TextRange 

// Set a link to the first slide of the presentation.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
slidePositionSlidePositionSlidePosition ที่เกี่ยวข้อง

รีเทิร์น

TextStyle

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

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

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

setLinkUrl(url)

ตั้งค่า Link เป็นสตริง URL ที่ไม่ใช่สตริงว่างที่ระบุ

การตั้งค่าลิงก์จะเปลี่ยนรูปแบบของข้อความให้มีขีดเส้นใต้และมีThemeColorType.HYPERLINKสีพื้นหน้า คุณเปลี่ยนการตั้งค่านี้ได้ผ่านsetForegroundColor(hexColor)และsetUnderline(underline)

เนื่องจากตั้งค่าลิงก์ในอักขระขึ้นบรรทัดใหม่ไม่ได้ ระบบจึงจะละเว้นอักขระขึ้นบรรทัดใหม่ใน TextRange 

// Set a link to the URL.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().setLinkUrl('https://slides.google.com');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
urlStringสตริง URL

รีเทิร์น

TextStyle

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

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

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

setSmallCaps(smallCaps)

กำหนดว่าจะแสดงข้อความเป็นตัวพิมพ์เล็กหรือตัวพิมพ์ใหญ่

พารามิเตอร์

ชื่อประเภทคำอธิบาย
smallCapsBoolean

รีเทิร์น

TextStyle

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

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

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

setStrikethrough(strikethrough)

กำหนดว่าจะขีดทับข้อความหรือไม่

พารามิเตอร์

ชื่อประเภทคำอธิบาย
strikethroughBoolean

รีเทิร์น

TextStyle

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

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

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

setUnderline(underline)

กำหนดว่าข้อความมีขีดเส้นใต้หรือไม่

พารามิเตอร์

ชื่อประเภทคำอธิบาย
underlineBoolean

รีเทิร์น

TextStyle

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

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

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