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 - این نقاشی، برای زنجیر کردن.