Class Menu

選單

在 Google App 使用者介面的執行個體中，自訂選單。指令碼只能與已開啟文件或表單目前執行個體的 UI 互動，且指令碼僅限容器繫結至文件或表單的情況。詳情請參閱選單指南。

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

將選單插入編輯器使用者介面的執行個體。