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 - This Menu，用於鏈結。

addSeparator()

在選單中新增視覺分隔符。

回攻員

Menu - This Menu，用於鏈結。

addSubMenu(menu)

在選單中新增子選單。

參數

名稱類型說明
menuMenu子選單，結構與頂層選單類似。

回攻員

Menu - This Menu，用於鏈結。

addToUi()

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