Class Menu

選單

Google 應用程式使用者介面執行個體中的自訂選單。指令碼只能與目前開啟文件或表單的 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()

將選單插入編輯器使用者介面的例項中。