Class CellImage

CellImage

تمثّل قيمة صورة في خلية. لإضافة صورة إلى خلية، عليك إنشاء قيمة صورة جديدة للصورة باستخدام SpreadsheetApp.newCellImage() وCellImageBuilder. يمكنك بعد ذلك استخدام Range.setValue(value) أو Range.setValues(values) لإضافة قيمة الصورة إلى الخلية.

الخصائص

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

الطُرق

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

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

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

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

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.

---

toBuilder()

تنشئ هذه الدالة أداة إنشاء صور خلايا استنادًا إلى خصائص الصورة الحالية. استخدِم CellImageBuilder.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