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	لعرض الورقة التي تظهر عليها هذه الصورة.
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	الصورة الجديدة كفقاعة تخزين.

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

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