Class CellImageBuilder

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
CellImageBuilder

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

أماكن إقامة

الخاصيةالنوعالوصف
valueTypeValueTypeتم ضبط حقل على 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)

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

المعلّمات

الاسمالنوعالوصف
descriptionStringالوصف النصي الجديد للصورة.

تذكرة ذهاب وعودة

CellImage — هذه الصورة للسلاسل.

التفويض

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

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

setAltTextTitle(title)

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

المعلّمات

الاسمالنوعالوصف
titleStringعنوان النص البديل الجديد للصورة.

تذكرة ذهاب وعودة

CellImage — هذه الصورة للسلاسل.

التفويض

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

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

setSourceUrl(url)

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

المعلّمات

الاسمالنوعالوصف
urlStringعنوان URL للصورة.

تذكرة ذهاب وعودة

CellImageBuilder — أداة الإنشاء هذه للسلاسل.


toBuilder()

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

تذكرة ذهاب وعودة

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