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)

لتخصيص الدالة باسم الدالة المحدد لهذه الصورة.

المعلّمات

الاسمالنوعالوصف
functionNameStringاسم الدالة التي يتم تحديدها. ويجب أن تكون هذه الوظيفة عامة في المستوى الأعلى، وليست وظيفة شرطة سفلية مثل 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 ميغابايت.

المعلّمات

الاسمالنوعالوصف
blobBlobSourceالصورة الجديدة كفقاعة تخزين.

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

OverGridImage — هذه الصورة للسلاسل.

التفويض

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

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

replace(url)

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

المعلّمات

الاسمالنوعالوصف
urlStringعنوان 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)

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

المعلّمات

الاسمالنوعالوصف
descriptionStringالوصف النصي الجديد للصورة.

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

OverGridImage — هذه الصورة للسلاسل.

التفويض

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

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

setAltTextTitle(title)

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

المعلّمات

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

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

OverGridImage — هذه الصورة للسلاسل.

التفويض

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

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

setAnchorCell(cell)

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

المعلّمات

الاسمالنوعالوصف
cellRangeخلية الارتساء الجديدة.

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

OverGridImage — هذه الصورة للسلاسل.

التفويض

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

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

setAnchorCellXOffset(offset)

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

المعلّمات

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

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

OverGridImage — هذه الصورة للسلاسل.

التفويض

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

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

setAnchorCellYOffset(offset)

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

المعلّمات

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

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

OverGridImage — هذه الصورة للسلاسل.

التفويض

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

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

setHeight(height)

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

المعلّمات

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

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

OverGridImage - صورة لسلسلة الكتب.

التفويض

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

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

setWidth(width)

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

المعلّمات

الاسمالنوعالوصف
widthIntegerالعرض المطلوب بالبكسل.

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

OverGridImage - صورة لسلسلة الكتب.

التفويض

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

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