Class Menu

菜单

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)

将菜单项添加到菜单中。菜单项的标签应采用句首字母大写形式(仅将第一个单词首字母大写)。

参数

名称类型说明
captionString菜单项的标签,仅包含第一个单词的首字母。
functionNameString在用户选择项目时要调用的函数的名称。您可以使用包含的库中的函数,例如 Library.libFunction1

返回

Menu - 此 Menu,用于串联。


addSeparator()

为菜单添加视觉分隔符。

返回

Menu - 此 Menu,用于串联。


addSubMenu(menu)

向菜单中添加一个子菜单。

参数

名称类型说明
menuMenu子菜单,采用顶级菜单的结构。

返回

Menu - 此 Menu,用于串联。


addToUi()

将菜单插入编辑器界面的实例中。