Class 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تُنشئ أداة إنشاء صور الخلايا استنادًا إلى خصائص الصورة الحالية.
الطريقةنوع القيمة التي يتم عرضهاوصف قصير
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)

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

المعلمات

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

الإرجاع

CellImage — هذه الصورة، لربط العناصر.

التفويض

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

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

setAltTextTitle(title)

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

المعلمات

الاسمالنوعالوصف
titleStringعنوان النص البديل الجديد للصورة.

الإرجاع

CellImage — هذه الصورة، لإنشاء سلسلة.

التفويض

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

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

setSourceUrl(url)

تُستخدَم لضبط عنوان URL لمصدر الصورة.

المعلمات

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

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

تمّ إيقاف هذا العمود نهائيًا. لا يتوفّر عنوان URL المصدر لمعظم الصور التي تم إدراجها حديثًا.

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

الإرجاع

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

التفويض

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

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