Class OverGridImage

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

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

روش ها

روش نوع برگشت شرح مختصر
assign Script(functionName) Over Grid Image تابعی را با نام تابع مشخص شده به این تصویر اختصاص می دهد.
get Alt Text Description() String توضیحات متن جایگزین را برای این تصویر برمی گرداند.
get Alt Text Title() String عنوان متن جایگزین را برای این تصویر برمی گرداند.
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 Url() String آدرس منبع تصویر را دریافت می کند. اگر URL در دسترس نباشد، null برمی گرداند.
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 توضیحات متن جایگزین را برای این تصویر تنظیم می کند.
set Alt Text Title(title) Over Grid Image عنوان متن جایگزین را برای این تصویر تنظیم می کند.
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 عرض واقعی این تصویر را بر حسب پیکسل تنظیم می کند.

مستندات دقیق

assign Script(functionName)

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

پارامترها

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

بازگشت

Over Grid Image - این تصویر برای زنجیر کردن.

مجوز

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

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

get Alt Text Description()

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

بازگشت

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

مجوز

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

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

get Alt Text Title()

عنوان متن جایگزین را برای این تصویر برمی گرداند.

بازگشت

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

مجوز

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

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

get Anchor Cell()

سلولی را که یک تصویر در آن لنگر انداخته است برمی گرداند.

بازگشت

Range - سلول لنگر.

مجوز

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

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

get Anchor Cell XOffset()

افست پیکسل افقی را از سلول لنگر برمی‌گرداند.

بازگشت

Integer - افست پیکسل افقی.

مجوز

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

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

get Anchor Cell YOffset()

افست پیکسل عمودی را از سلول لنگر برمی‌گرداند.

بازگشت

Integer - افست پیکسل عمودی.

مجوز

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

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

get Height()

ارتفاع واقعی این تصویر را بر حسب پیکسل برمی گرداند.

// 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

get Inherent Height()

ارتفاع ذاتی این تصویر را بر حسب پیکسل برمی گرداند.

بازگشت

Integer - ارتفاع ذاتی بر حسب پیکسل.

مجوز

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

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

get Inherent Width()

ارتفاع ذاتی این تصویر را بر حسب پیکسل برمی گرداند.

بازگشت

Integer - عرض ذاتی در پیکسل.

مجوز

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

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

get Script()

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

بازگشت

String - نام تابع.

مجوز

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

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

get Sheet()

برگه ای که این تصویر در آن ظاهر می شود را برمی گرداند.

// 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

get Url()

آدرس منبع تصویر را دریافت می کند. اگر URL در دسترس نباشد، null برمی گرداند. اگر تصویر توسط URL با استفاده از یک API درج شده باشد، این روش URL ارائه شده در هنگام درج تصویر را برمی گرداند.

بازگشت

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

مجوز

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

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

get Width()

عرض واقعی این تصویر را بر حسب پیکسل برمی گرداند.

// 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)

این تصویر را با تصویر مشخص شده توسط Blob Source ارائه شده جایگزین می کند. حداکثر اندازه حباب پشتیبانی شده 2 مگابایت است.

پارامترها

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

بازگشت

Over Grid Image - این تصویر برای زنجیر کردن.

مجوز

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

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

replace(url)

این تصویر را با تصویری از URL مشخص شده جایگزین می کند.

پارامترها

نام تایپ کنید توضیحات
url String URL تصویر جدید.

بازگشت

Over Grid Image - این تصویر برای زنجیر کردن.

مجوز

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

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

reset Size()

این تصویر را به ابعاد ذاتی آن بازنشانی می کند.

بازگشت

Over Grid Image - این تصویر برای زنجیر کردن.

مجوز

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

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

set Alt Text Description(description)

توضیحات متن جایگزین را برای این تصویر تنظیم می کند.

پارامترها

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

بازگشت

Over Grid Image - این تصویر برای زنجیر کردن.

مجوز

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

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

set Alt Text Title(title)

عنوان متن جایگزین را برای این تصویر تنظیم می کند.

پارامترها

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

بازگشت

Over Grid Image - این تصویر برای زنجیر کردن.

مجوز

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

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

set Anchor Cell(cell)

سلولی را که یک تصویر در آن لنگر انداخته است را تنظیم می کند.

پارامترها

نام تایپ کنید توضیحات
cell Range سلول لنگر جدید.

بازگشت

Over Grid Image - این تصویر برای زنجیر کردن.

مجوز

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

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

set Anchor Cell XOffset(offset)

افست پیکسل افقی را از سلول لنگر تنظیم می کند.

پارامترها

نام تایپ کنید توضیحات
offset Integer افست پیکسل افقی جدید.

بازگشت

Over Grid Image - این تصویر برای زنجیر کردن.

مجوز

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

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

set Anchor Cell YOffset(offset)

افست پیکسل عمودی را از سلول لنگر تنظیم می کند.

پارامترها

نام تایپ کنید توضیحات
offset Integer افست پیکسل عمودی جدید.

بازگشت

Over Grid Image - این تصویر برای زنجیر کردن.

مجوز

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

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

set Height(height)

ارتفاع واقعی این تصویر را بر حسب پیکسل تنظیم می کند.

پارامترها

نام تایپ کنید توضیحات
height Integer ارتفاع مورد نظر بر حسب پیکسل

بازگشت

Over Grid Image - تصویر برای زنجیر کردن.

مجوز

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

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

set Width(width)

عرض واقعی این تصویر را بر حسب پیکسل تنظیم می کند.

پارامترها

نام تایپ کنید توضیحات
width Integer عرض مورد نظر بر حسب پیکسل

بازگشت

Over Grid Image - تصویر برای زنجیر کردن.

مجوز

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

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