Class Drawing

طراحی

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

روش‌ها

روش نوع بازگشتی شرح مختصر
get Container Info() Container Info اطلاعاتی در مورد محل قرارگیری ترسیم در صفحه دریافت می‌کند.
get Height() Integer ارتفاع واقعی این ترسیم را بر حسب پیکسل برمی‌گرداند.
get On Action() String|null نام ماکروی متصل به این ترسیم را برمی‌گرداند.
get Sheet() Sheet برگه‌ای را که این ترسیم روی آن ظاهر می‌شود، برمی‌گرداند.
get Width() Integer عرض واقعی این ترسیم را بر حسب پیکسل برمی‌گرداند.
get ZIndex() Number شاخص z این ترسیم را برمی‌گرداند.
remove() void این ترسیم را از صفحه گسترده حذف می‌کند.
set Height(height) Drawing ارتفاع واقعی این ترسیم را بر حسب پیکسل تنظیم می‌کند.
set On Action(macroName) Drawing یک تابع ماکرو را به این ترسیم اختصاص می‌دهد.
set Position(anchorRowPos, anchorColPos, offsetX, offsetY) Drawing موقعیتی را که نقاشی روی صفحه ظاهر می‌شود، تنظیم می‌کند.
set Width(width) Drawing عرض واقعی این ترسیم را بر حسب پیکسل تنظیم می‌کند.
set ZIndex(zIndex) Drawing شاخص z این ترسیم را تنظیم می‌کند.

مستندات دقیق

get Container Info()

اطلاعاتی در مورد محل قرارگیری ترسیم در صفحه دریافت می‌کند.

بازگشت

Container Info - شیء حاوی موقعیت کانتینر ترسیم.

مجوز

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

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

get Height()

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

// Logs the height of all drawings in a sheet
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getHeight());
}

بازگشت

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

مجوز

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

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

get On Action()

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

// Logs the macro name of all drawings on the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getOnAction());
}

بازگشت

String|null — نام ماکرویی که به این ترسیم پیوست شده است.

مجوز

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

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

get Sheet()

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

// Logs the parent sheet of all drawings on the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getSheet());
}

بازگشت

Sheet - برگه‌ای که طرح روی آن ظاهر می‌شود.

مجوز

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

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

get Width()

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

// Logs the width of all drawings in a sheet
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getWidth());
}

بازگشت

Integer - عرض تصویر ترسیم شده بر حسب پیکسل.

مجوز

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

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

get ZIndex()

شاخص z این ترسیم را برمی‌گرداند.

// Logs the z-index of all drawings on the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getZIndex());
}

بازگشت

Number — شاخص Z این نقشه.

مجوز

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

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

remove()

این ترسیم را از صفحه گسترده حذف می‌کند. هرگونه عملیات بیشتر روی ترسیم منجر به خطای اسکریپت می‌شود.

// Deletes all drawings from the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  drawings[i].remove();
}

مجوز

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

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

set Height(height)

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

پارامترها

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

بازگشت

Drawing — این نقاشی، برای زنجیر زدن.

مجوز

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

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

set On Action(macroName)

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

پارامترها

نام نوع توضیحات
macro Name String نام تابع ماکرو.

بازگشت

Drawing — این نقاشی، برای زنجیر زدن.

set Position(anchorRowPos, anchorColPos, offsetX, offsetY)

موقعیت مکانی که ترسیم روی صفحه نمایش داده می‌شود را تعیین می‌کند. شاخص‌های موقعیت ردیف و ستون لنگر، ۱-ایندکس هستند.

پارامترها

نام نوع توضیحات
anchor Row Pos Integer قسمت بالایی نقاشی در این ردیف ثابت شده است.
anchor Col Pos Integer ضلع بالایی نقاشی در این ستون ثابت شده است.
offsetX Integer فاصله افقی از گوشه سلول بر حسب پیکسل.
offsetY Integer فاصله عمودی از گوشه سلول بر حسب پیکسل.

بازگشت

Drawing — این نقاشی، برای زنجیر زدن.

مجوز

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

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

set Width(width)

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

پارامترها

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

بازگشت

Drawing — این نقاشی، برای زنجیر زدن.

مجوز

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

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

set ZIndex(zIndex)

شاخص z این ترسیم را تنظیم می‌کند.

پارامترها

نام نوع توضیحات
zIndex Number شاخص Z این نقاشی.

بازگشت

Drawing — این نقاشی، برای زنجیر زدن.