أداة الإنشاء لـ CellImage
. تنشئ أداة الإنشاء هذه قيمة الصورة المطلوبة لإضافة
صورة إلى خلية.
أماكن إقامة
الخاصية | النوع | الوصف |
---|---|---|
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)
لضبط وصف النص البديل لهذه الصورة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
description | String | الوصف النصي الجديد للصورة. |
تذكرة ذهاب وعودة
CellImage
— هذه الصورة للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAltTextTitle(title)
لضبط عنوان النص البديل لهذه الصورة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
title | String | عنوان النص البديل الجديد للصورة. |
تذكرة ذهاب وعودة
CellImage
— هذه الصورة للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setSourceUrl(url)
لضبط عنوان URL لمصدر الصورة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
url | String | عنوان URL للصورة. |
تذكرة ذهاب وعودة
CellImageBuilder
— أداة الإنشاء هذه للسلاسل.
toBuilder()
تنشئ أداة إنشاء لتحويل صورة إلى نوع قيمة صورة بحيث يمكنك وضعها في خلية. قبل وضع الصورة في خلية، يجب إنشاؤها كنوع قيمة صورة.
ويمكنك بعد ذلك إضافته إلى خلية باستخدام Range.setValue(value)
أو Range.setValues(values)
.
تذكرة ذهاب وعودة
CellImageBuilder
: أداة إنشاء تنشئ نوع قيمة صورة استنادًا إلى خصائص الصور المحدّدة.