Class OverGridImage

تصویر روی شبکه

یک تصویر را روی شبکه در یک صفحه گسترده نشان می‌دهد.

روش‌ها

روش نوع بازگشتی شرح مختصر
assign Script(functionName) Over Grid Image تابعی با نام تابع مشخص شده را به این تصویر اختصاص می‌دهد.
get Alt Text Description() String توضیحات متن جایگزین (alt text) را برای این تصویر برمی‌گرداند.
get Alt Text Title() String عنوان متن جایگزین (alt text) را برای این تصویر برمی‌گرداند.
get Anchor Cell() Range سلولی را که تصویر در آن قرار دارد، برمی‌گرداند.
get Anchor Cell XOffset() Integer میزان انحراف افقی پیکسل از سلول لنگر را برمی‌گرداند.
get Anchor Cell YOffset() Integer میزان انحراف عمودی پیکسل از سلول لنگر را برمی‌گرداند.
get Height() Integer ارتفاع واقعی این تصویر را بر حسب پیکسل برمی‌گرداند.
get Inherent Height() Integer ارتفاع ذاتی این تصویر را بر حسب پیکسل برمی‌گرداند.
get Inherent Width() Integer ارتفاع ذاتی این تصویر را بر حسب پیکسل برمی‌گرداند.
get Script() String نام تابعی که به این تصویر اختصاص داده شده است را برمی‌گرداند.
get Sheet() Sheet صفحه‌ای که تصویر روی آن نمایش داده می‌شود را برمی‌گرداند.
get Width() Integer عرض واقعی این تصویر را بر حسب پیکسل برمی‌گرداند.
remove() void این تصویر را از صفحه گسترده حذف می‌کند.
replace(blob) Over Grid Image این تصویر را با تصویری که توسط Blob Source ارائه شده است، جایگزین می‌کند.
replace(url) Over Grid Image این تصویر را با تصویر موجود در URL مشخص شده جایگزین می‌کند.
reset Size() Over Grid Image این تصویر را به ابعاد ذاتی‌اش برمی‌گرداند.
set Alt Text Description(description) Over Grid Image توضیحات متن جایگزین (alt-text) را برای این تصویر تنظیم می‌کند.
set Alt Text Title(title) Over Grid Image عنوان متن جایگزین (alt text) را برای این تصویر تنظیم می‌کند.
set Anchor Cell(cell) Over Grid Image سلولی را که تصویر در آن قرار دارد، تنظیم می‌کند.
set Anchor Cell XOffset(offset) Over Grid Image میزان انحراف افقی پیکسل‌ها از سلول لنگر را تنظیم می‌کند.
set Anchor Cell YOffset(offset) Over Grid Image فاصله عمودی پیکسل‌ها از سلول لنگر را تنظیم می‌کند.
set Height(height) Over Grid Image ارتفاع واقعی این تصویر را بر حسب پیکسل تنظیم می‌کند.
set Width(width) Over Grid Image عرض واقعی این تصویر را بر حسب پیکسل تنظیم می‌کند.

مستندات دقیق

assignScript(functionName)

تابعی با نام تابع مشخص شده را به این تصویر اختصاص می‌دهد.

پارامترها

نام نوع توضیحات
function Name String نام تابعی که مشخص می‌شود. این باید یک تابع سطح بالای عمومی باشد، نه تابعی که به زیرخط ختم می‌شود، مانند private Function_ .

بازگشت

OverGridImage — این تصویر، برای زنجیره‌سازی.

مجوز

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

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

getAltTextDescription()

توضیحات متن جایگزین (alt text) را برای این تصویر برمی‌گرداند.

بازگشت

String - توضیحات متن جایگزین.

مجوز

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

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

getAltTextTitle()

عنوان متن جایگزین (alt text) را برای این تصویر برمی‌گرداند.

بازگشت

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 پشتیبانی شده ۲ مگابایت است.

پارامترها

نام نوع توضیحات
blob Blob Source تصویر جدید به عنوان یک لکه.

بازگشت

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)

توضیحات متن جایگزین (alt-text) را برای این تصویر تنظیم می‌کند.

پارامترها

نام نوع توضیحات
description String توضیحات متن جایگزین جدید برای تصویر.

بازگشت

OverGridImage — این تصویر، برای زنجیره‌سازی.

مجوز

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

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

setAltTextTitle(title)

عنوان متن جایگزین (alt text) را برای این تصویر تنظیم می‌کند.

پارامترها

نام نوع توضیحات
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

متدهای منسوخ شده