דף זה תורגם על ידי Cloud Translation API.

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

הוספת התפריט למופע של ממשק המשתמש של העורך.