Class CellImageBuilder

CellImageBuilder

ผู้สร้างสำหรับ CellImage ตัวสร้างนี้จะสร้างค่ารูปภาพที่จําเป็นในการเพิ่มรูปภาพลงในเซลล์

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้ประเภทคำอธิบาย
valueTypeValueTypeประเภทค่าของรูปภาพเซลล์ ซึ่งก็คือ ValueType.IMAGE

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
build()CellImageสร้างประเภทค่ารูปภาพที่จําเป็นต่อการเพิ่มรูปภาพลงในเซลล์
getAltTextDescription()Stringแสดงคำอธิบายข้อความแสดงแทนของรูปภาพนี้
getAltTextTitle()Stringแสดงชื่อข้อความแสดงแทนของรูปภาพนี้
getContentUrl()Stringแสดงผล URL ที่โฮสต์โดย Google ไปยังรูปภาพ
setAltTextDescription(description)CellImageตั้งค่าคำอธิบายข้อความแสดงแทนสำหรับรูปภาพนี้
setAltTextTitle(title)CellImageตั้งชื่อข้อความแสดงแทนสำหรับรูปภาพนี้
setSourceUrl(url)CellImageBuilderตั้งค่า URL แหล่งที่มาของรูปภาพ
toBuilder()CellImageBuilderสร้างเครื่องมือสร้างรูปภาพเซลล์ตามพร็อพเพอร์ตี้รูปภาพปัจจุบัน

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

build()

สร้างประเภทค่ารูปภาพที่จําเป็นต่อการเพิ่มรูปภาพลงในเซลล์ ค่ารูปภาพสร้างขึ้นจากพร็อพเพอร์ตี้รูปภาพที่เพิ่มลงในเครื่องมือสร้าง เช่น URL แหล่งที่มา

รีเทิร์น

CellImage — การนําเสนอรูปภาพที่จะเพิ่มลงในเซลล์

getAltTextDescription()

แสดงคำอธิบายข้อความแสดงแทนของรูปภาพนี้

รีเทิร์น

String — คำอธิบายข้อความแสดงแทน

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

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

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

getAltTextTitle()

แสดงชื่อข้อความแสดงแทนของรูปภาพนี้

รีเทิร์น

String — ชื่อข้อความแสดงแทน

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

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

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

getContentUrl()

แสดงผล URL ที่โฮสต์โดย Google ไปยังรูปภาพ URL นี้ติดแท็กด้วยบัญชีของผู้ขอ เพื่อให้ทุกคนที่มี URL เข้าถึงรูปภาพได้อย่างมีประสิทธิภาพในฐานะผู้ขอต้นฉบับ คุณอาจเสียสิทธิ์เข้าถึงรูปภาพหากการตั้งค่าการแชร์ของสเปรดชีตมีการเปลี่ยนแปลง URL ที่แสดงจะหมดอายุหลังจากผ่านไประยะหนึ่ง 

const range = SpreadsheetApp.getActiveSpreadsheet().getRange("Sheet1!A1");
const value = range.getValue();
if (value.valueType == SpreadsheetApp.ValueType.IMAGE) {
  console.log(value.getContentUrl());
}

รีเทิร์น

String — URL ของรูปภาพที่โฮสต์โดย Google

setAltTextDescription(description)

ตั้งค่าคำอธิบายข้อความแสดงแทนสำหรับรูปภาพนี้

พารามิเตอร์

ชื่อประเภทคำอธิบาย
descriptionStringคำอธิบายข้อความแสดงแทนใหม่สำหรับรูปภาพ

รีเทิร์น

CellImage — รูปภาพนี้สําหรับการต่อเชื่อม

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

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

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

setAltTextTitle(title)

ตั้งชื่อข้อความแสดงแทนสำหรับรูปภาพนี้

พารามิเตอร์

ชื่อประเภทคำอธิบาย
titleStringชื่อข้อความแสดงแทนใหม่สำหรับรูปภาพ

รีเทิร์น

CellImage — รูปภาพนี้สําหรับการต่อเชื่อม

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

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

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

setSourceUrl(url)

ตั้งค่า URL แหล่งที่มาของรูปภาพ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
urlStringURL ของรูปภาพ

รีเทิร์น

CellImageBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

toBuilder()

สร้างเครื่องมือสร้างรูปภาพเซลล์ตามพร็อพเพอร์ตี้รูปภาพปัจจุบัน ใช้ setSourceUrl(url) เพื่อตั้งค่า URL ต้นทางของรูปภาพใหม่ จากนั้นคุณสามารถเพิ่มลงในเซลล์ได้โดยใช้ Range.setValue(value) หรือ Range.setValues(values) 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const range = ss.getRange("Sheet1!A1");
const value = range.getValue();
if (value.valueType == SpreadsheetApp.ValueType.IMAGE) {
  const newImage =
      value.toBuilder()
          .setSourceUrl(
              'https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png',
              )
          .build();
  const newRange = ss.getRange("Sheet1!A2");
  newRange.setValue(newImage);
}

รีเทิร์น

CellImageBuilder — ตัวสร้างที่สร้างประเภทค่ารูปภาพตามพร็อพเพอร์ตี้รูปภาพที่ระบุ

วิธีการที่เลิกใช้งาน