Class CellImageBuilder

CellImageBuilder

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

أماكن إقامة

الموقعTypeالوصف
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)

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

المَعلمات

الاسمTypeالوصف
descriptionStringوصف النص البديل الجديد للصورة

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

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

التفويض

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

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

setAltTextTitle(title)

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

المَعلمات

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

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

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

التفويض

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

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

setSourceUrl(url)

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

المَعلمات

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

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

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


toBuilder()

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

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

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