Class CellImage

خليةصورة

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

أماكن إقامة

الموقعالنوعالوصف
valueTypeValueTypeحقل تم ضبطه على ValueType.IMAGE، يمثّل نوع قيمة الصورة.

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getAltTextDescription()Stringتعرِض هذه السمة وصف النص البديل لهذه الصورة.
getAltTextTitle()Stringتعرِض هذه السمة عنوان النص البديل لهذه الصورة.
getContentUrl()Stringتعرِض هذه السمة عنوان URL للصورة مستضافًا على Google.
getUrl()Stringتحصل على عنوان URL لمصدر الصورة، وتُعرِض null إذا لم يكن عنوان URL متاحًا.
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 المعروض بعد فترة زمنية قصيرة.

الإرجاع

String: عنوان URL للصورة المستضافة على Google

getUrl()

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

الإرجاع

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

التفويض

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

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

toBuilder()

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

الإرجاع

CellImageBuilder: أداة إنشاء تنشئ نوع قيمة صورة استنادًا إلى سمات الصورة المحدّدة.