Class Drawing

طراحی

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

روش ها

روش نوع برگشت شرح مختصر
get Container Info() Container Info اطلاعاتی در مورد محل قرارگیری نقشه در برگه دریافت می کند.
get Height() Integer ارتفاع واقعی این طراحی را بر حسب پیکسل برمی گرداند.
get On Action() String نام ماکرو پیوست شده به این طراحی را برمی‌گرداند.
get Sheet() Sheet برگه ای را که این طراحی در آن ظاهر می شود برمی گرداند.
get Width() Integer عرض واقعی این طراحی را بر حسب پیکسل برمی گرداند.
get ZIndex() Number z-index این نقاشی را برمی‌گرداند.
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-index این نقاشی را تنظیم می کند.

مستندات دقیق

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 - نام ماکرو متصل به این نقاشی.

مجوز

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

  • 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-index این نقاشی را برمی‌گرداند.

// 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-Index این نقاشی.

مجوز

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

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

موقعیتی را تعیین می کند که طرح روی برگه ظاهر شود. شاخص های ردیف لنگر و موقعیت ستون 1 ایندکس شده اند.

پارامترها

نام تایپ کنید توضیحات
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-index این نقاشی را تنظیم می کند.

پارامترها

نام تایپ کنید توضیحات
zIndex Number Z-Index این نقاشی.

بازگشت

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