Class CellImage

خليةصورة

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

الخصائص

الموقعالنوعالوصف
valueTypeValueTypeنوع قيمة صورة الخلية، وهي ValueType.IMAGE.

الطُرق

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

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

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

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