یک منوی سفارشی در یک نمونه از رابط کاربری برای یک برنامه Google. یک اسکریپت فقط برای نمونه فعلی یک سند یا فرم باز میتواند با رابط کاربری تعامل داشته باشد، و تنها در صورتی که اسکریپت به سند یا فرم محدود شده باشد. برای اطلاعات بیشتر، به راهنمای منوها مراجعه کنید.
// Add a custom menu to the active spreadsheet, including a separator and a sub-menu. function onOpen(e) { SpreadsheetApp.getUi() .createMenu('My Menu') .addItem('My Menu Item', 'myFunction') .addSeparator() .addSubMenu(SpreadsheetApp.getUi().createMenu('My Submenu') .addItem('One Submenu Item', 'mySecondFunction') .addItem('Another Submenu Item', 'myThirdFunction')) .addToUi(); }
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
addItem(caption, functionName) | Menu | یک مورد را به منو اضافه می کند. |
addSeparator() | Menu | یک جداکننده بصری به منو اضافه می کند. |
addSubMenu(menu) | Menu | یک منوی فرعی به منو اضافه می کند. |
addToUi() | void | منو را در نمونه رابط کاربری ویرایشگر درج می کند. |
مستندات دقیق
addItem(caption, functionName)
یک مورد را به منو اضافه می کند. برچسب یک آیتم منو باید با حروف جمله باشد (فقط اولین کلمه با حروف بزرگ).
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
caption | String | برچسب مورد منو که فقط کلمه اول را با حروف بزرگ نوشته شده است. |
functionName | String | نام تابعی که باید هنگام انتخاب مورد توسط کاربر فراخوانی شود. می توانید از توابع کتابخانه های موجود مانند Library.libFunction1 استفاده کنید. |
بازگشت
addSubMenu(menu)
addToUi()
منو را در نمونه رابط کاربری ویرایشگر درج می کند.