Class OverGridImage

OverGridImage

تمثّل هذه السمة صورة فوق الشبكة في جدول بيانات.

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
assignScript(functionName)	OverGridImage	تعيّن هذه السمة الدالة التي تحمل اسم الدالة المحدّد لهذه الصورة.
getAltTextDescription()	String	تعرض هذه السمة وصف النص البديل لهذه الصورة.
getAltTextTitle()	String	تعرض هذه السمة عنوان النص البديل لهذه الصورة.
getAnchorCell()	Range	تعرض هذه الدالة الخلية التي تم تثبيت صورة فيها.
getAnchorCellXOffset()	Integer	تعرض هذه السمة الإزاحة الأفقية بالبكسل من خلية الربط.
getAnchorCellYOffset()	Integer	تعرض هذه السمة الإزاحة الرأسية بالبكسل من خلية الربط.
getHeight()	Integer	تعرض هذه السمة الارتفاع الفعلي لهذه الصورة بالبكسل.
getInherentHeight()	Integer	تعرض هذه السمة الارتفاع الأصلي لهذه الصورة بالبكسل.
getInherentWidth()	Integer	تعرض هذه السمة الارتفاع الأصلي لهذه الصورة بالبكسل.
getScript()	String	تعرض هذه السمة اسم الدالة المخصّصة لهذه الصورة.
getSheet()	Sheet	تعرض هذه الدالة ورقة البيانات التي تظهر فيها هذه الصورة.
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	تضبط هذه السمة العرض الفعلي لهذه الصورة بالبكسل.

الطرق المتوقّفة

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
getUrl()	String	تعرض هذه السمة عنوان URL الخاص بمصدر الصورة.

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

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
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let 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
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let 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

---

getWidth()

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

// Logs the width of all images in a spreadsheet
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let 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
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let 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

الطرق المتوقّفة

getUrl()

تمّت إزالة هذا العمود. بالنسبة إلى معظم الصور المُدرَجة حديثًا، لا يتوفّر عنوان URL المصدر.

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

الإرجاع

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

التفويض

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

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