Class CellImageBuilder

CellImageBuilder

أداة إنشاء لـ CellImage ينشئ أداة الإنشاء هذه قيمة الصورة اللازمة لإضافة صورة إلى خلية.

الخصائص

الموقع	النوع	الوصف
valueType	ValueType	تمثّل هذه السمة نوع قيمة صورة الخلية، وهو ValueType.IMAGE.

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
build()	CellImage	تُنشئ هذه الدالة نوع قيمة الصورة اللازم لإضافة صورة إلى خلية.
getAltTextDescription()	String	تعرض هذه السمة وصف النص البديل لهذه الصورة.
getAltTextTitle()	String	تعرض هذه السمة عنوان النص البديل لهذه الصورة.
getContentUrl()	String	تعرض هذه الطريقة عنوان URL للصورة مستضافًا على Google.
setAltTextDescription(description)	CellImage	تضبط هذه السمة وصف النص البديل لهذه الصورة.
setAltTextTitle(title)	CellImage	تضبط هذه السمة عنوان النص البديل لهذه الصورة.
setSourceUrl(url)	CellImageBuilder	تضبط هذه السمة عنوان URL لمصدر الصورة.
toBuilder()	CellImageBuilder	تنشئ هذه الدالة أداة إنشاء صور خلايا استنادًا إلى خصائص الصورة الحالية.

الطرق المتوقّفة

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
getUrl()	String	تعرض هذه السمة عنوان URL الخاص بمصدر الصورة.

مستندات تفصيلية

build()

تُنشئ هذه الدالة نوع قيمة الصورة اللازم لإضافة صورة إلى خلية. يتم إنشاء قيمة الصورة من خصائص الصورة التي تمت إضافتها إلى أداة الإنشاء، مثل عنوان URL المصدر.

الإرجاع

CellImage: تمثّل الصورة التي ستتم إضافتها إلى خلية.

---

getAltTextDescription()

تعرض هذه السمة وصف النص البديل لهذه الصورة.

الإرجاع

String: وصف النص البديل

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

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

---

getAltTextTitle()

تعرض هذه السمة عنوان النص البديل لهذه الصورة.

الإرجاع

String: عنوان النص البديل

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

• 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)

تضبط هذه السمة وصف النص البديل لهذه الصورة.

المَعلمات

الاسم	النوع	الوصف
description	String	وصف النص البديل الجديد للصورة

الإرجاع

CellImage: هذه الصورة، للتسلسل

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

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

---

setAltTextTitle(title)

تضبط هذه السمة عنوان النص البديل لهذه الصورة.

المَعلمات

الاسم	النوع	الوصف
title	String	عنوان النص البديل الجديد للصورة

الإرجاع

CellImage: هذه الصورة، للتسلسل

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

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

---

setSourceUrl(url)

تضبط هذه السمة عنوان URL لمصدر الصورة.

المَعلمات

الاسم	النوع	الوصف
url	String	تمثّل عنوان URL الخاص بالصورة.

الإرجاع

‫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: أداة إنشاء تنشئ نوع قيمة صورة استنادًا إلى خصائص الصورة المحدّدة.

الطرق المتوقّفة

getUrl()

تمّت إزالة هذا العمود. بالنسبة إلى معظم الصور المُدرَجة حديثًا، لا يتوفّر عنوان URL المصدر.

تعرض هذه السمة عنوان URL الخاص بمصدر الصورة. تعرِض هذه السمة سلسلة فارغة إذا كان عنوان URL غير متاح. بالنسبة إلى معظم الصور التي تم إدراجها حديثًا، لا يتوفّر عنوان URL المصدر بغض النظر عن طريقة إدراج الصورة.

الإرجاع

‫String: عنوان URL لمصدر الصورة إذا كان متاحًا، ويعرض سلسلة فارغة في حال عدم توفّره.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

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