Class CellImage

CellImage

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

أماكن إقامة

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