Class CellImageBuilder

أداةإنشاءالصورفي الخلايا

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