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

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