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

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