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 برمی‌گرداند.
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 با استفاده از یک API درج شده باشد، این روش URL ارائه شده در هنگام درج تصویر را برمی گرداند.

بازگشت

String - URL تصویر در صورت موجود بودن؛ اگر تصویر در دسترس نباشد یا URL منبع نداشته باشد، null برمی‌گرداند.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • 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 ارائه شده جایگزین می کند. حداکثر اندازه حباب پشتیبانی شده 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