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