تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class CellImage

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

أماكن إقامة

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