Class Drawing

طراحی

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

روش ها

روش نوع برگشت شرح مختصر
getContainerInfo() ContainerInfo اطلاعاتی در مورد محل قرارگیری نقشه در برگه دریافت می کند.
getHeight() Integer ارتفاع واقعی این طراحی را بر حسب پیکسل برمی گرداند.
getOnAction() String نام ماکرو پیوست شده به این طراحی را برمی‌گرداند.
getSheet() Sheet برگه ای را که این طراحی در آن ظاهر می شود برمی گرداند.
getWidth() Integer عرض واقعی این طراحی را بر حسب پیکسل برمی گرداند.
getZIndex() Number z-index این نقاشی را برمی‌گرداند.
remove() void این طراحی را از صفحه گسترده حذف می کند.
setHeight(height) Drawing ارتفاع واقعی این نقاشی را بر حسب پیکسل تنظیم می کند.
setOnAction(macroName) Drawing یک تابع ماکرو به این نقاشی اختصاص می دهد.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY) Drawing موقعیتی را تعیین می کند که طرح روی برگه ظاهر شود.
setWidth(width) Drawing عرض واقعی این طراحی را بر حسب پیکسل تنظیم می کند.
setZIndex(zIndex) Drawing z-index این نقاشی را تنظیم می کند.

مستندات دقیق

getContainerInfo()

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

بازگشت

ContainerInfo - یک شی حاوی موقعیت ظرف طرح.

مجوز

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

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

getHeight()

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

// Logs the height of all drawings in a sheet
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var 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

getOnAction()

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

// Logs the macro name of all drawings on the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var 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

getSheet()

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

// Logs the parent sheet of all drawings on the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var 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

getWidth()

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

// Logs the width of all drawings in a sheet
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var 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

getZIndex()

z-index این نقاشی را برمی‌گرداند.

// Logs the z-index of all drawings on the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var 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.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  drawings[i].remove();
}

مجوز

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

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

setHeight(height)

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

پارامترها

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

بازگشت

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

مجوز

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

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

setOnAction(macroName)

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

پارامترها

نام تایپ کنید توضیحات
macroName String نام تابع ماکرو

بازگشت

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


setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

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

پارامترها

نام تایپ کنید توضیحات
anchorRowPos Integer سمت بالای نقاشی در این ردیف لنگر انداخته است.
anchorColPos Integer سمت بالای نقاشی در این سر ستون لنگر انداخته است.
offsetX Integer افست افقی از گوشه سلول در پیکسل.
offsetY Integer افست عمودی از گوشه سلول در پیکسل.

بازگشت

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

مجوز

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

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

setWidth(width)

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

پارامترها

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

بازگشت

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

مجوز

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

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

setZIndex(zIndex)

z-index این نقاشی را تنظیم می کند.

پارامترها

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

بازگشت

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