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)

向菜单添加项。菜单项的标签应采用句首字母大写形式（仅首个字母大写）。

参数

名称	类型	说明
caption	String	菜单项的标签，仅第一个字词采用大写形式。
functionName	String	在用户选择该项时调用的函数的名称。您可以使用所包含的库中的函数，例如 Library.libFunction1。

返回

Menu - 此 Menu，用于链接。

---

addSeparator()

向菜单添加视觉分隔符。

返回

Menu - 此 Menu，用于链接。

---

addSubMenu(menu)

向菜单添加子菜单。

参数

名称	类型	说明
menu	Menu	子菜单，其构建方式与顶级菜单类似。

返回

Menu - 此 Menu，用于链接。

---

addToUi()

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