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