Class OverGridImage

صورةعلى سطحالشبكة

يمثّل صورة تظهر على سطح الشبكة في جدول بيانات.

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
assignScript(functionName)	OverGridImage	تعيين الدالة التي تحمل اسم الدالة المحدّد لهذه الصورة
getAltTextDescription()	String	تعرِض هذه السمة وصف النص البديل لهذه الصورة.
getAltTextTitle()	String	تعرِض هذه السمة عنوان النص البديل لهذه الصورة.
getAnchorCell()	Range	لعرض الخلية التي تمّ تثبيت الصورة فيها.
getAnchorCellXOffset()	Integer	لعرض الإزاحة الأفقية للبكسل من خلية الربط.
getAnchorCellYOffset()	Integer	لعرض الإزاحة العمودية للبكسل من خلية الربط.
getHeight()	Integer	تعرِض هذه السمة الارتفاع الفعلي لهذه الصورة بالبكسل.
getInherentHeight()	Integer	تعرِض هذه السمة الارتفاع الأساسي لهذه الصورة بالبكسل.
getInherentWidth()	Integer	تعرِض هذه السمة الارتفاع الأساسي لهذه الصورة بالبكسل.
getScript()	String	تعرِض هذه الدالة اسم الدالة التي تمّ تعيينها لهذه الصورة.
getSheet()	Sheet	عرض ورقة البيانات التي تظهر فيها هذه الصورة
getUrl()	String	تحصل على عنوان URL لمصدر الصورة، وتُعرِض null إذا لم يكن عنوان URL متاحًا.
getWidth()	Integer	عرض هذه الصورة الفعلي بالبكسل
remove()	void	يؤدي ذلك إلى حذف هذه الصورة من جدول البيانات.
replace(blob)	OverGridImage	استبدال هذه الصورة بالصورة المحدّدة من خلال BlobSource المقدَّمة
replace(url)	OverGridImage	تستبدِل هذه الصورة بالصورة الواردة من عنوان URL المحدّد.
resetSize()	OverGridImage	تعيد ضبط هذه الصورة على أبعادها الأصلية.
setAltTextDescription(description)	OverGridImage	لضبط وصف النص البديل لهذه الصورة.
setAltTextTitle(title)	OverGridImage	لضبط عنوان النص البديل لهذه الصورة.
setAnchorCell(cell)	OverGridImage	لضبط الخلية التي يتم تثبيت الصورة فيها
setAnchorCellXOffset(offset)	OverGridImage	تُستخدَم لضبط الإزاحة الأفقية لوحدات البكسل من خلية الربط.
setAnchorCellYOffset(offset)	OverGridImage	لضبط الإزاحة العمودية لوحدة البكسل من خلية الربط
setHeight(height)	OverGridImage	لضبط الارتفاع الفعلي لهذه الصورة بالبكسل.
setWidth(width)	OverGridImage	لضبط العرض الفعلي لهذه الصورة بالبكسل.

مستندات تفصيلية

assignScript(functionName)

تعيين الدالة التي تحمل اسم الدالة المحدّد لهذه الصورة

المعلَمات

الاسم	النوع	الوصف
functionName	String	اسم الدالة التي يتم تحديدها. يجب أن تكون هذه دالة عامة على مستوى أعلى، وليس دالة تنتهي بشرطة سفلية مثل privateFunction_.

الإرجاع

OverGridImage — هذه الصورة، لإنشاء سلسلة.

التفويض

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

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

---

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

---

getAnchorCell()

لعرض الخلية التي تمّ تثبيت الصورة فيها.

الإرجاع

Range: خلية الربط

التفويض

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

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

---

getAnchorCellXOffset()

لعرض الإزاحة الأفقية للبكسل من خلية الربط.

الإرجاع

Integer: الإزاحة الأفقية لوحدات البكسل

التفويض

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

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

---

getAnchorCellYOffset()

لعرض الإزاحة العمودية للبكسل من خلية الربط.

الإرجاع

‫Integer: إزاحة وحدات البكسل العمودية

التفويض

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

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

---

getHeight()

تعرِض هذه السمة الارتفاع الفعلي لهذه الصورة بالبكسل.

// Logs the height of all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  Logger.log(images[i].getHeight());
}

الإرجاع

‫Integer: ارتفاع الصورة بالبكسل

التفويض

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

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

---

getInherentHeight()

تعرِض هذه السمة الارتفاع الأساسي لهذه الصورة بالبكسل.

الإرجاع

‫Integer: الارتفاع الأساسي بالبكسل

التفويض

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

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

---

getInherentWidth()

تعرِض هذه السمة الارتفاع الأساسي لهذه الصورة بالبكسل.

الإرجاع

‫Integer: العرض الأساسي بالبكسل

التفويض

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

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

---

getScript()

تعرِض هذه الدالة اسم الدالة التي تمّ تعيينها لهذه الصورة.

الإرجاع

String: اسم الدالة

التفويض

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

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

---

getSheet()

عرض ورقة البيانات التي تظهر فيها هذه الصورة

// Logs the parent sheet of all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  Logger.log(images[i].getSheet());
}

الإرجاع

Sheet: ورقة البيانات التي تظهر عليها الصورة.

التفويض

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

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

---

getUrl()

تحصل على عنوان URL لمصدر الصورة، وتُعرِض null إذا لم يكن عنوان URL متاحًا. إذا تم إدراج الصورة باستخدام عنوان URL من خلال واجهة برمجة تطبيقات، تعرض هذه الطريقة عنوان URL المقدَّم أثناء إدراج الصورة.

الإرجاع

‫String: عنوان URL للصورة في حال توفّره. يتم عرض null إذا لم تكن الصورة متاحة أو لم يكن لديها عنوان URL للمصدر.

التفويض

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

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

---

getWidth()

عرض هذه الصورة الفعلي بالبكسل

// Logs the width of all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  Logger.log(images[i].getWidth());
}

الإرجاع

‫Integer: عرض الصورة بالبكسل

التفويض

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

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

---

remove()

يؤدي ذلك إلى حذف هذه الصورة من جدول البيانات. يؤدي إجراء أي عملية أخرى على الصورة إلى خطأ في النص البرمجي.

// Deletes all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  images[i].remove();
}

التفويض

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

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

---

replace(blob)

استبدال هذه الصورة بالصورة المحدّدة من خلال BlobSource المقدَّمة الحد الأقصى لحجم الكائن الثنائي الكبير (blob) المسموح به هو 2 ميغابايت.

المعلَمات

الاسم	النوع	الوصف
blob	BlobSource	الصورة الجديدة بتنسيق Blob

الإرجاع

OverGridImage — هذه الصورة، لربط العناصر.

التفويض

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

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

---

replace(url)

تستبدِل هذه الصورة بالصورة الواردة من عنوان URL المحدّد.

المعلَمات

الاسم	النوع	الوصف
url	String	عنوان URL للصورة الجديدة

الإرجاع

OverGridImage — هذه الصورة، لربط العناصر.

التفويض

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

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

---

resetSize()

تعيد ضبط هذه الصورة على أبعادها الأصلية.

الإرجاع

OverGridImage — هذه الصورة، لربط العناصر.

التفويض

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

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

---

setAltTextDescription(description)

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

المعلَمات

الاسم	النوع	الوصف
description	String	وصف النص البديل الجديد للصورة

الإرجاع

OverGridImage — هذه الصورة، لإنشاء سلسلة.

التفويض

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

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

---

setAltTextTitle(title)

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

المعلَمات

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

الإرجاع

OverGridImage — هذه الصورة، لربط العناصر.

التفويض

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

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

---

setAnchorCell(cell)

لضبط الخلية التي يتم تثبيت الصورة فيها

المعلَمات

الاسم	النوع	الوصف
cell	Range	خلية الربط الجديدة.

الإرجاع

OverGridImage — هذه الصورة، لربط العناصر.

التفويض

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

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

---

setAnchorCellXOffset(offset)

تُستخدَم لضبط الإزاحة الأفقية لوحدات البكسل من خلية الربط.

المعلَمات

الاسم	النوع	الوصف
offset	Integer	إزاحة البكسل الأفقية الجديدة

الإرجاع

OverGridImage — هذه الصورة، لربط العناصر.

التفويض

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

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

---

setAnchorCellYOffset(offset)

لضبط الإزاحة العمودية لوحدة البكسل من خلية الربط

المعلَمات

الاسم	النوع	الوصف
offset	Integer	إزاحة وحدات البكسل العمودية الجديدة

الإرجاع

OverGridImage — هذه الصورة، لربط العناصر.

التفويض

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

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

---

setHeight(height)

لضبط الارتفاع الفعلي لهذه الصورة بالبكسل.

المعلَمات

الاسم	النوع	الوصف
height	Integer	الارتفاع المطلوب بالبكسل

الإرجاع

OverGridImage: صورة السلسلة

التفويض

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

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

---

setWidth(width)

لضبط العرض الفعلي لهذه الصورة بالبكسل.

المعلَمات

الاسم	النوع	الوصف
width	Integer	العرض المطلوب بالبكسل

الإرجاع

OverGridImage: صورة السلسلة

التفويض

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

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