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

Class CellImageBuilder

أداة إنشاء لحساب "CellImage" تنشئ أداة الإنشاء هذه قيمة الصورة اللازمة لإضافة صورة إلى خلية.

أماكن إقامة

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

الطُرق

الطريقة	نوع القيمة التي يتم إرجاعها	وصف قصير
`build()`	`CellImage`	تنشئ هذه الدالة نوع قيمة الصورة المطلوبة لإضافة صورة إلى خلية.
`getAltTextDescription()`	`String`	لعرض وصف النص البديل لهذه الصورة.
`getAltTextTitle()`	`String`	تعرض عنوان النص البديل لهذه الصورة.
`getContentUrl()`	`String`	لعرض عنوان URL تستضيفه Google للصورة.
`getUrl()`	`String`	للحصول على عنوان URL لمصدر الصورة، يتم عرض `null` إذا كان عنوان URL غير متاح.
`setAltTextDescription(description)`	`CellImage`	لضبط وصف النص البديل لهذه الصورة.
`setAltTextTitle(title)`	`CellImage`	لضبط عنوان النص البديل لهذه الصورة.
`setSourceUrl(url)`	`CellImageBuilder`	لضبط عنوان URL لمصدر الصورة.
`toBuilder()`	`CellImageBuilder`	تنشئ أداة إنشاء تحول صورة إلى نوع قيمة صورة بحيث يمكنك وضعها في خلية.

الوثائق التفصيلية

`build()`

تنشئ هذه الدالة نوع قيمة الصورة المطلوبة لإضافة صورة إلى خلية. يتم إنشاء قيمة الصورة من خصائص الصور التي تمت إضافتها إلى أداة الإنشاء، مثل عنوان URL المصدر.

استرجاع الكرة

CellImage - تمثيل للصورة التي ستتم إضافتها إلى خلية.

`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

`setAltTextDescription(description)`

لضبط وصف النص البديل لهذه الصورة.

المَعلمات

الاسم	Type	الوصف
`description`	`String`	وصف النص البديل الجديد للصورة

استرجاع الكرة

CellImage - هذه الصورة للتسلسل.

التفويض

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

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

`setAltTextTitle(title)`

لضبط عنوان النص البديل لهذه الصورة.

المَعلمات

الاسم	Type	الوصف
`title`	`String`	عنوان النص البديل الجديد للصورة

استرجاع الكرة

CellImage - هذه الصورة للتسلسل.

التفويض

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

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

`setSourceUrl(url)`

لضبط عنوان URL لمصدر الصورة.

المَعلمات

الاسم	Type	الوصف
`url`	`String`	عنوان URL للصورة

استرجاع الكرة

CellImageBuilder: أداة الإنشاء هذه مخصّصة للسلاسل

`toBuilder()`

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

استرجاع الكرة

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