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