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عرض ورقة البيانات التي تظهر فيها هذه الصورة
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
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 ميغابايت.

المعلمات

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

الإرجاع

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

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