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

Class CellImage

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

أماكن إقامة

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