menu

Enumerations

NativeIcon

Defined in: packages/api/src/menu/iconMenuItem.ts:17

A native Icon to be used for the menu item

Platform-specific

• Windows / Linux: Unsupported.

Enumeration Members

Add

Add: "Add";

Defined in: packages/api/src/menu/iconMenuItem.ts:19

An add item template image.

Advanced

Advanced: "Advanced";

Defined in: packages/api/src/menu/iconMenuItem.ts:21

Advanced preferences toolbar icon for the preferences window.

Bluetooth

Bluetooth: "Bluetooth";

Defined in: packages/api/src/menu/iconMenuItem.ts:23

A Bluetooth template image.

Bookmarks

Bookmarks: "Bookmarks";

Defined in: packages/api/src/menu/iconMenuItem.ts:25

Bookmarks image suitable for a template.

Caution

Caution: "Caution";

Defined in: packages/api/src/menu/iconMenuItem.ts:27

A caution image.

ColorPanel

ColorPanel: "ColorPanel";

Defined in: packages/api/src/menu/iconMenuItem.ts:29

A color panel toolbar icon.

ColumnView

ColumnView: "ColumnView";

Defined in: packages/api/src/menu/iconMenuItem.ts:31

A column view mode template image.

Computer

Computer: "Computer";

Defined in: packages/api/src/menu/iconMenuItem.ts:33

A computer icon.

EnterFullScreen

EnterFullScreen: "EnterFullScreen";

Defined in: packages/api/src/menu/iconMenuItem.ts:35

An enter full-screen mode template image.

Everyone

Everyone: "Everyone";

Defined in: packages/api/src/menu/iconMenuItem.ts:37

Permissions for all users.

ExitFullScreen

ExitFullScreen: "ExitFullScreen";

Defined in: packages/api/src/menu/iconMenuItem.ts:39

An exit full-screen mode template image.

FlowView

FlowView: "FlowView";

Defined in: packages/api/src/menu/iconMenuItem.ts:41

A cover flow view mode template image.

Folder

Folder: "Folder";

Defined in: packages/api/src/menu/iconMenuItem.ts:43

A folder image.

FolderBurnable

FolderBurnable: "FolderBurnable";

Defined in: packages/api/src/menu/iconMenuItem.ts:45

A burnable folder icon.

FolderSmart

FolderSmart: "FolderSmart";

Defined in: packages/api/src/menu/iconMenuItem.ts:47

A smart folder icon.

FollowLinkFreestanding

FollowLinkFreestanding: "FollowLinkFreestanding";

Defined in: packages/api/src/menu/iconMenuItem.ts:49

A link template image.

FontPanel

FontPanel: "FontPanel";

Defined in: packages/api/src/menu/iconMenuItem.ts:51

A font panel toolbar icon.

GoLeft

GoLeft: "GoLeft";

Defined in: packages/api/src/menu/iconMenuItem.ts:53

A go back template image.

GoRight

GoRight: "GoRight";

Defined in: packages/api/src/menu/iconMenuItem.ts:55

A go forward template image.

Home

Home: "Home";

Defined in: packages/api/src/menu/iconMenuItem.ts:57

Home image suitable for a template.

IChatTheater

IChatTheater: "IChatTheater";

Defined in: packages/api/src/menu/iconMenuItem.ts:59

An iChat Theater template image.

IconView

IconView: "IconView";

Defined in: packages/api/src/menu/iconMenuItem.ts:61

An icon view mode template image.

Info

Info: "Info";

Defined in: packages/api/src/menu/iconMenuItem.ts:63

An information toolbar icon.

InvalidDataFreestanding

InvalidDataFreestanding: "InvalidDataFreestanding";

Defined in: packages/api/src/menu/iconMenuItem.ts:65

A template image used to denote invalid data.

LeftFacingTriangle

LeftFacingTriangle: "LeftFacingTriangle";

Defined in: packages/api/src/menu/iconMenuItem.ts:67

A generic left-facing triangle template image.

ListView

ListView: "ListView";

Defined in: packages/api/src/menu/iconMenuItem.ts:69

A list view mode template image.

LockLocked

LockLocked: "LockLocked";

Defined in: packages/api/src/menu/iconMenuItem.ts:71

A locked padlock template image.

LockUnlocked

LockUnlocked: "LockUnlocked";

Defined in: packages/api/src/menu/iconMenuItem.ts:73

An unlocked padlock template image.

MenuMixedState

MenuMixedState: "MenuMixedState";

Defined in: packages/api/src/menu/iconMenuItem.ts:75

A horizontal dash, for use in menus.

MenuOnState

MenuOnState: "MenuOnState";

Defined in: packages/api/src/menu/iconMenuItem.ts:77

A check mark template image, for use in menus.

MobileMe

MobileMe: "MobileMe";

Defined in: packages/api/src/menu/iconMenuItem.ts:79

A MobileMe icon.

MultipleDocuments

MultipleDocuments: "MultipleDocuments";

Defined in: packages/api/src/menu/iconMenuItem.ts:81

A drag image for multiple items.

Network

Network: "Network";

Defined in: packages/api/src/menu/iconMenuItem.ts:83

A network icon.

Path

Path: "Path";

Defined in: packages/api/src/menu/iconMenuItem.ts:85

A path button template image.

PreferencesGeneral

PreferencesGeneral: "PreferencesGeneral";

Defined in: packages/api/src/menu/iconMenuItem.ts:87

General preferences toolbar icon for the preferences window.

QuickLook

QuickLook: "QuickLook";

Defined in: packages/api/src/menu/iconMenuItem.ts:89

A Quick Look template image.

Refresh

Refresh: "Refresh";

Defined in: packages/api/src/menu/iconMenuItem.ts:93

A refresh template image.

RefreshFreestanding

RefreshFreestanding: "RefreshFreestanding";

Defined in: packages/api/src/menu/iconMenuItem.ts:91

A refresh template image.

Remove

Remove: "Remove";

Defined in: packages/api/src/menu/iconMenuItem.ts:95

A remove item template image.

RevealFreestanding

RevealFreestanding: "RevealFreestanding";

Defined in: packages/api/src/menu/iconMenuItem.ts:97

A reveal contents template image.

RightFacingTriangle

RightFacingTriangle: "RightFacingTriangle";

Defined in: packages/api/src/menu/iconMenuItem.ts:99

A generic right-facing triangle template image.

Share

Share: "Share";

Defined in: packages/api/src/menu/iconMenuItem.ts:101

A share view template image.

Slideshow

Slideshow: "Slideshow";

Defined in: packages/api/src/menu/iconMenuItem.ts:103

A slideshow template image.

SmartBadge

SmartBadge: "SmartBadge";

Defined in: packages/api/src/menu/iconMenuItem.ts:105

A badge for a smart item.

StatusAvailable

StatusAvailable: "StatusAvailable";

Defined in: packages/api/src/menu/iconMenuItem.ts:107

Small green indicator, similar to iChat’s available image.

StatusNone

StatusNone: "StatusNone";

Defined in: packages/api/src/menu/iconMenuItem.ts:109

Small clear indicator.

StatusPartiallyAvailable

StatusPartiallyAvailable: "StatusPartiallyAvailable";

Defined in: packages/api/src/menu/iconMenuItem.ts:111

Small yellow indicator, similar to iChat’s idle image.

StatusUnavailable

StatusUnavailable: "StatusUnavailable";

Defined in: packages/api/src/menu/iconMenuItem.ts:113

Small red indicator, similar to iChat’s unavailable image.

StopProgress

StopProgress: "StopProgress";

Defined in: packages/api/src/menu/iconMenuItem.ts:117

A stop progress button template image.

StopProgressFreestanding

StopProgressFreestanding: "StopProgressFreestanding";

Defined in: packages/api/src/menu/iconMenuItem.ts:115

A stop progress template image.

TrashEmpty

TrashEmpty: "TrashEmpty";

Defined in: packages/api/src/menu/iconMenuItem.ts:119

An image of the empty trash can.

TrashFull

TrashFull: "TrashFull";

Defined in: packages/api/src/menu/iconMenuItem.ts:121

An image of the full trash can.

User

User: "User";

Defined in: packages/api/src/menu/iconMenuItem.ts:123

Permissions for a single user.

UserAccounts

UserAccounts: "UserAccounts";

Defined in: packages/api/src/menu/iconMenuItem.ts:125

User account toolbar icon for the preferences window.

UserGroup

UserGroup: "UserGroup";

Defined in: packages/api/src/menu/iconMenuItem.ts:127

Permissions for a group of users.

UserGuest

UserGuest: "UserGuest";

Defined in: packages/api/src/menu/iconMenuItem.ts:129

Permissions for guests.

Classes

CheckMenuItem

Defined in: packages/api/src/menu/checkMenuItem.ts:20

A check menu item inside a Menu or Submenu and usually contains a text and a check mark or a similar toggle that corresponds to a checked and unchecked states.

Extends

• MenuItemBase

Accessors

id

Get Signature

get id(): string;

Defined in: packages/api/src/menu/base.ts:128

The id of this item.

Returns

string

Inherited from

MenuItemBase.id

rid

Get Signature

get rid(): number;

Defined in: packages/api/src/core.ts:318

Returns

number

Inherited from

MenuItemBase.rid

Methods

close()

close(): Promise<void>;

Defined in: packages/api/src/core.ts:330

Destroys and cleans up this resource from memory. You should not call any method on this object anymore and should drop any reference to it.

Returns

Promise<void>

Inherited from

MenuItemBase.close

isChecked()

isChecked(): Promise<boolean>;

Defined in: packages/api/src/menu/checkMenuItem.ts:71

Returns whether this check menu item is checked or not.

Returns

Promise<boolean>

isEnabled()

isEnabled(): Promise<boolean>;

Defined in: packages/api/src/menu/checkMenuItem.ts:48

Returns whether this check menu item is enabled or not.

Returns

Promise<boolean>

setAccelerator()

setAccelerator(accelerator): Promise<void>;

Defined in: packages/api/src/menu/checkMenuItem.ts:62

Sets the accelerator for this check menu item.

Parameters

Parameter	Type
accelerator	string | null

Returns

Promise<void>

setChecked()

setChecked(checked): Promise<void>;

Defined in: packages/api/src/menu/checkMenuItem.ts:76

Sets whether this check menu item is checked or not.

Parameters

Parameter	Type
checked	boolean

Returns

Promise<void>

setEnabled()

setEnabled(enabled): Promise<void>;

Defined in: packages/api/src/menu/checkMenuItem.ts:53

Sets whether this check menu item is enabled or not.

Parameters

Parameter	Type
enabled	boolean

Returns

Promise<void>

setText()

setText(text): Promise<void>;

Defined in: packages/api/src/menu/checkMenuItem.ts:39

Sets the text for this check menu item.

Parameters

Parameter	Type
text	string

Returns

Promise<void>

text()

text(): Promise<string>;

Defined in: packages/api/src/menu/checkMenuItem.ts:34

Returns the text of this check menu item.

Returns

Promise<string>

new()

static new(opts): Promise<CheckMenuItem>;

Defined in: packages/api/src/menu/checkMenuItem.ts:27

Create a new check menu item.

Parameters

Parameter	Type
opts	CheckMenuItemOptions

Returns

Promise<CheckMenuItem>

---

IconMenuItem

Defined in: packages/api/src/menu/iconMenuItem.ts:151

An icon menu item inside a Menu or Submenu and usually contains an icon and a text.

Extends

• MenuItemBase

Accessors

id

Get Signature

get id(): string;

Defined in: packages/api/src/menu/base.ts:128

The id of this item.

Returns

string

Inherited from

MenuItemBase.id

rid

Get Signature

get rid(): number;

Defined in: packages/api/src/core.ts:318

Returns

number

Inherited from

MenuItemBase.rid

Methods

close()

close(): Promise<void>;

Defined in: packages/api/src/core.ts:330

Destroys and cleans up this resource from memory. You should not call any method on this object anymore and should drop any reference to it.

Returns

Promise<void>

Inherited from

MenuItemBase.close

isEnabled()

isEnabled(): Promise<boolean>;

Defined in: packages/api/src/menu/iconMenuItem.ts:177

Returns whether this icon menu item is enabled or not.

Returns

Promise<boolean>

setAccelerator()

setAccelerator(accelerator): Promise<void>;

Defined in: packages/api/src/menu/iconMenuItem.ts:191

Sets the accelerator for this icon menu item.

Parameters

Parameter	Type
accelerator	string | null

Returns

Promise<void>

setEnabled()

setEnabled(enabled): Promise<void>;

Defined in: packages/api/src/menu/iconMenuItem.ts:182

Sets whether this icon menu item is enabled or not.

Parameters

Parameter	Type
enabled	boolean

Returns

Promise<void>

setIcon()

setIcon(icon): Promise<void>;

Defined in: packages/api/src/menu/iconMenuItem.ts:200

Sets an icon for this icon menu item

Parameters

Parameter	Type
icon	MenuIcon | null

Returns

Promise<void>

setText()

setText(text): Promise<void>;

Defined in: packages/api/src/menu/iconMenuItem.ts:168

Sets the text for this icon menu item.

Parameters

Parameter	Type
text	string

Returns

Promise<void>

text()

text(): Promise<string>;

Defined in: packages/api/src/menu/iconMenuItem.ts:163

Returns the text of this icon menu item.

Returns

Promise<string>

new()

static new(opts): Promise<IconMenuItem>;

Defined in: packages/api/src/menu/iconMenuItem.ts:158

Create a new icon menu item.

Parameters

Parameter	Type
opts	IconMenuItemOptions

Returns

Promise<IconMenuItem>

---

Menu

Defined in: packages/api/src/menu/menu.ts:48

A type that is either a menu bar on the window on Windows and Linux or as a global menu in the menubar on macOS.

Platform-specific

• macOS: if using Menu for the global menubar, it can only contain Submenus.

Extends

• MenuItemBase

Accessors

id

Get Signature

get id(): string;

Defined in: packages/api/src/menu/base.ts:128

The id of this item.

Returns

string

Inherited from

MenuItemBase.id

rid

Get Signature

get rid(): number;

Defined in: packages/api/src/core.ts:318

Returns

number

Inherited from

MenuItemBase.rid

Methods

append()

append<T>(items): Promise<void>;

Defined in: packages/api/src/menu/menu.ts:73

Add a menu item to the end of this menu.

Platform-specific

• macOS: Only Submenus can be added to a Menu.

Type Parameters

Type Parameter
T extends | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | MenuItemOptions | SubmenuOptions | IconMenuItemOptions | PredefinedMenuItemOptions | CheckMenuItemOptions

Parameters

Parameter	Type
items	T | T[]

Returns

Promise<void>

close()

close(): Promise<void>;

Defined in: packages/api/src/core.ts:330

Destroys and cleans up this resource from memory. You should not call any method on this object anymore and should drop any reference to it.

Returns

Promise<void>

Inherited from

MenuItemBase.close

get()

get(id): Promise<
  | Submenu
  | MenuItem
  | PredefinedMenuItem
  | CheckMenuItem
  | IconMenuItem
| null>;

Defined in: packages/api/src/menu/menu.ts:196

Retrieves the menu item matching the given identifier.

Parameters

Parameter	Type
id	string

Returns

Promise< | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | null>

insert()

insert<T>(items, position): Promise<void>;

Defined in: packages/api/src/menu/menu.ts:131

Add a menu item to the specified position in this menu.

Platform-specific

• macOS: Only Submenus can be added to a Menu.

Type Parameters

Type Parameter
T extends | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | MenuItemOptions | SubmenuOptions | IconMenuItemOptions | PredefinedMenuItemOptions | CheckMenuItemOptions

Parameters

Parameter	Type
items	T | T[]
position	number

Returns

Promise<void>

items()

items(): Promise<(
  | Submenu
  | MenuItem
  | PredefinedMenuItem
  | CheckMenuItem
| IconMenuItem)[]>;

Defined in: packages/api/src/menu/menu.ts:184

Returns a list of menu items that has been added to this menu.

Returns

Promise<( | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem)[]>

popup()

popup(at?, window?): Promise<void>;

Defined in: packages/api/src/menu/menu.ts:219

Popup this menu as a context menu on the specified window.

Parameters

Parameter	Type	Description
at?	| PhysicalPosition | LogicalPosition | Position	If a position is provided, it is relative to the window’s top-left corner. If there isn’t one provided, the menu will pop up at the current location of the mouse.
window?	Window	-

Returns

Promise<void>

prepend()

prepend<T>(items): Promise<void>;

Defined in: packages/api/src/menu/menu.ts:102

Add a menu item to the beginning of this menu.

Platform-specific

• macOS: Only Submenus can be added to a Menu.

Type Parameters

Type Parameter
T extends | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | MenuItemOptions | SubmenuOptions | IconMenuItemOptions | PredefinedMenuItemOptions | CheckMenuItemOptions

Parameters

Parameter	Type
items	T | T[]

Returns

Promise<void>

remove()

remove(item): Promise<void>;

Defined in: packages/api/src/menu/menu.ts:155

Remove a menu item from this menu.

Parameters

Parameter	Type
item	| Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem

Returns

Promise<void>

removeAt()

removeAt(position): Promise<
  | Submenu
  | MenuItem
  | PredefinedMenuItem
  | CheckMenuItem
  | IconMenuItem
| null>;

Defined in: packages/api/src/menu/menu.ts:166

Remove a menu item from this menu at the specified position.

Parameters

Parameter	Type
position	number

Returns

Promise< | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | null>

setAsAppMenu()

setAsAppMenu(): Promise<Menu | null>;

Defined in: packages/api/src/menu/menu.ts:237

Sets the app-wide menu and returns the previous one.

If a window was not created with an explicit menu or had one set explicitly, this menu will be assigned to it.

Returns

Promise<Menu | null>

setAsWindowMenu()

setAsWindowMenu(window?): Promise<Menu | null>;

Defined in: packages/api/src/menu/menu.ts:251

Sets the window menu and returns the previous one.

Platform-specific

• macOS: Unsupported. The menu on macOS is app-wide and not specific to one window, if you need to set it, use Menu.setAsAppMenu instead.

Parameters

Parameter	Type
window?	Window

Returns

Promise<Menu | null>

default()

static default(): Promise<Menu>;

Defined in: packages/api/src/menu/menu.ts:60

Create a default menu.

Returns

Promise<Menu>

new()

static new(opts?): Promise<Menu>;

Defined in: packages/api/src/menu/menu.ts:55

Create a new menu.

Parameters

Parameter	Type
opts?	MenuOptions

Returns

Promise<Menu>

---

MenuItem

Defined in: packages/api/src/menu/menuItem.ts:23

A menu item inside a Menu or Submenu and contains only text.

Extends

• MenuItemBase

Accessors

id

Get Signature

get id(): string;

Defined in: packages/api/src/menu/base.ts:128

The id of this item.

Returns

string

Inherited from

MenuItemBase.id

rid

Get Signature

get rid(): number;

Defined in: packages/api/src/core.ts:318

Returns

number

Inherited from

MenuItemBase.rid

Methods

close()

close(): Promise<void>;

Defined in: packages/api/src/core.ts:330

Destroys and cleans up this resource from memory. You should not call any method on this object anymore and should drop any reference to it.

Returns

Promise<void>

Inherited from

MenuItemBase.close

isEnabled()

isEnabled(): Promise<boolean>;

Defined in: packages/api/src/menu/menuItem.ts:49

Returns whether this menu item is enabled or not.

Returns

Promise<boolean>

setAccelerator()

setAccelerator(accelerator): Promise<void>;

Defined in: packages/api/src/menu/menuItem.ts:63

Sets the accelerator for this menu item.

Parameters

Parameter	Type
accelerator	string | null

Returns

Promise<void>

setEnabled()

setEnabled(enabled): Promise<void>;

Defined in: packages/api/src/menu/menuItem.ts:54

Sets whether this menu item is enabled or not.

Parameters

Parameter	Type
enabled	boolean

Returns

Promise<void>

setText()

setText(text): Promise<void>;

Defined in: packages/api/src/menu/menuItem.ts:40

Sets the text for this menu item.

Parameters

Parameter	Type
text	string

Returns

Promise<void>

text()

text(): Promise<string>;

Defined in: packages/api/src/menu/menuItem.ts:35

Returns the text of this menu item.

Returns

Promise<string>

new()

static new(opts): Promise<MenuItem>;

Defined in: packages/api/src/menu/menuItem.ts:30

Create a new menu item.

Parameters

Parameter	Type
opts	MenuItemOptions

Returns

Promise<MenuItem>

---

PredefinedMenuItem

Defined in: packages/api/src/menu/predefinedMenuItem.ts:112

A predefined (native) menu item which has a predefined behavior by the OS or by tauri.

Extends

• MenuItemBase

Accessors

id

Get Signature

get id(): string;

Defined in: packages/api/src/menu/base.ts:128

The id of this item.

Returns

string

Inherited from

MenuItemBase.id

rid

Get Signature

get rid(): number;

Defined in: packages/api/src/core.ts:318

Returns

number

Inherited from

MenuItemBase.rid

Methods

close()

close(): Promise<void>;

Defined in: packages/api/src/core.ts:330

Destroys and cleans up this resource from memory. You should not call any method on this object anymore and should drop any reference to it.

Returns

Promise<void>

Inherited from

MenuItemBase.close

setText()

setText(text): Promise<void>;

Defined in: packages/api/src/menu/predefinedMenuItem.ts:133

Sets the text for this predefined menu item.

Parameters

Parameter	Type
text	string

Returns

Promise<void>

text()

text(): Promise<string>;

Defined in: packages/api/src/menu/predefinedMenuItem.ts:128

Returns the text of this predefined menu item.

Returns

Promise<string>

new()

static new(opts?): Promise<PredefinedMenuItem>;

Defined in: packages/api/src/menu/predefinedMenuItem.ts:119

Create a new predefined menu item.

Parameters

Parameter	Type
opts?	PredefinedMenuItemOptions

Returns

Promise<PredefinedMenuItem>

---

Submenu

Defined in: packages/api/src/menu/submenu.ts:60

A type that is a submenu inside a Menu or Submenu.

Extends

• MenuItemBase

Accessors

id

Get Signature

get id(): string;

Defined in: packages/api/src/menu/base.ts:128

The id of this item.

Returns

string

Inherited from

MenuItemBase.id

rid

Get Signature

get rid(): number;

Defined in: packages/api/src/core.ts:318

Returns

number

Inherited from

MenuItemBase.rid

Methods

append()

append<T>(items): Promise<void>;

Defined in: packages/api/src/menu/submenu.ts:106

Add a menu item to the end of this submenu.

Platform-specific

• macOS: Only Submenus can be added to a Menu.

Type Parameters

Type Parameter
T extends | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | MenuItemOptions | SubmenuOptions | IconMenuItemOptions | PredefinedMenuItemOptions | CheckMenuItemOptions

Parameters

Parameter	Type
items	T | T[]

Returns

Promise<void>

close()

close(): Promise<void>;

Defined in: packages/api/src/core.ts:330

Destroys and cleans up this resource from memory. You should not call any method on this object anymore and should drop any reference to it.

Returns

Promise<void>

Inherited from

MenuItemBase.close

get()

get(id): Promise<
  | Submenu
  | MenuItem
  | PredefinedMenuItem
  | CheckMenuItem
  | IconMenuItem
| null>;

Defined in: packages/api/src/menu/submenu.ts:229

Retrieves the menu item matching the given identifier.

Parameters

Parameter	Type
id	string

Returns

Promise< | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | null>

insert()

insert<T>(items, position): Promise<void>;

Defined in: packages/api/src/menu/submenu.ts:164

Add a menu item to the specified position in this submenu.

Platform-specific

• macOS: Only Submenus can be added to a Menu.

Type Parameters

Type Parameter
T extends | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | MenuItemOptions | SubmenuOptions | IconMenuItemOptions | PredefinedMenuItemOptions | CheckMenuItemOptions

Parameters

Parameter	Type
items	T | T[]
position	number

Returns

Promise<void>

isEnabled()

isEnabled(): Promise<boolean>;

Defined in: packages/api/src/menu/submenu.ts:86

Returns whether this submenu is enabled or not.

Returns

Promise<boolean>

items()

items(): Promise<(
  | Submenu
  | MenuItem
  | PredefinedMenuItem
  | CheckMenuItem
| IconMenuItem)[]>;

Defined in: packages/api/src/menu/submenu.ts:217

Returns a list of menu items that has been added to this submenu.

Returns

Promise<( | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem)[]>

popup()

popup(at?, window?): Promise<void>;

Defined in: packages/api/src/menu/submenu.ts:251

Popup this submenu as a context menu on the specified window.

If the position, is provided, it is relative to the window’s top-left corner.

Parameters

Parameter	Type
at?	| PhysicalPosition | LogicalPosition
window?	Window

Returns

Promise<void>

prepend()

prepend<T>(items): Promise<void>;

Defined in: packages/api/src/menu/submenu.ts:135

Add a menu item to the beginning of this submenu.

Platform-specific

• macOS: Only Submenus can be added to a Menu.

Type Parameters

Type Parameter
T extends | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | MenuItemOptions | SubmenuOptions | IconMenuItemOptions | PredefinedMenuItemOptions | CheckMenuItemOptions

Parameters

Parameter	Type
items	T | T[]

Returns

Promise<void>

remove()

remove(item): Promise<void>;

Defined in: packages/api/src/menu/submenu.ts:188

Remove a menu item from this submenu.

Parameters

Parameter	Type
item	| Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem

Returns

Promise<void>

removeAt()

removeAt(position): Promise<
  | Submenu
  | MenuItem
  | PredefinedMenuItem
  | CheckMenuItem
  | IconMenuItem
| null>;

Defined in: packages/api/src/menu/submenu.ts:199

Remove a menu item from this submenu at the specified position.

Parameters

Parameter	Type
position	number

Returns

Promise< | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | null>

setAsHelpMenuForNSApp()

setAsHelpMenuForNSApp(): Promise<void>;

Defined in: packages/api/src/menu/submenu.ts:291

Set this submenu as the Help menu for the application on macOS.

This will cause macOS to automatically add a search box to the menu.

If no menu is set as the Help menu, macOS will automatically use any menu which has a title matching the localized word “Help”.

Platform-specific

• Windows / Linux: Unsupported.

Returns

Promise<void>

setAsWindowsMenuForNSApp()

setAsWindowsMenuForNSApp(): Promise<void>;

Defined in: packages/api/src/menu/submenu.ts:273

Set this submenu as the Window menu for the application on macOS.

This will cause macOS to automatically add window-switching items and certain other items to the menu.

Platform-specific

• Windows / Linux: Unsupported.

Returns

Promise<void>

setEnabled()

setEnabled(enabled): Promise<void>;

Defined in: packages/api/src/menu/submenu.ts:91

Sets whether this submenu is enabled or not.

Parameters

Parameter	Type
enabled	boolean

Returns

Promise<void>

setIcon()

setIcon(icon): Promise<void>;

Defined in: packages/api/src/menu/submenu.ts:298

Sets an icon for this submenu

Parameters

Parameter	Type
icon	MenuIcon | null

Returns

Promise<void>

setText()

setText(text): Promise<void>;

Defined in: packages/api/src/menu/submenu.ts:77

Sets the text for this submenu.

Parameters

Parameter	Type
text	string

Returns

Promise<void>

text()

text(): Promise<string>;

Defined in: packages/api/src/menu/submenu.ts:72

Returns the text of this submenu.

Returns

Promise<string>

new()

static new(opts): Promise<Submenu>;

Defined in: packages/api/src/menu/submenu.ts:67

Create a new submenu.

Parameters

Parameter	Type
opts	SubmenuOptions

Returns

Promise<Submenu>

Interfaces

AboutMetadata

Defined in: packages/api/src/menu/predefinedMenuItem.ts:10

A metadata for the about predefined menu item.

Properties

Property	Type	Description	Defined in
authors?	string[]	The authors of the application. Platform-specific - macOS: Unsupported.	packages/api/src/menu/predefinedMenuItem.ts:30
comments?	string	Application comments. Platform-specific - macOS: Unsupported.	packages/api/src/menu/predefinedMenuItem.ts:38
copyright?	string	The copyright of the application.	packages/api/src/menu/predefinedMenuItem.ts:40
credits?	string	The credits. Platform-specific - Windows / Linux: Unsupported.	packages/api/src/menu/predefinedMenuItem.ts:72
icon?	| string | Image | Uint8Array | ArrayBuffer | number[]	The application icon. Platform-specific - Windows: Unsupported.	packages/api/src/menu/predefinedMenuItem.ts:80
license?	string	The license of the application. Platform-specific - macOS: Unsupported.	packages/api/src/menu/predefinedMenuItem.ts:48
name?	string	Sets the application name.	packages/api/src/menu/predefinedMenuItem.ts:12
shortVersion?	string	The short version, e.g. “1.0”. Platform-specific - Windows / Linux: Appended to the end of version in parentheses.	packages/api/src/menu/predefinedMenuItem.ts:22
version?	string	The application version.	packages/api/src/menu/predefinedMenuItem.ts:14
website?	string	The application website. Platform-specific - macOS: Unsupported.	packages/api/src/menu/predefinedMenuItem.ts:56
websiteLabel?	string	The website label. Platform-specific - macOS: Unsupported.	packages/api/src/menu/predefinedMenuItem.ts:64

---

CheckMenuItemOptions

Defined in: packages/api/src/menu/checkMenuItem.ts:10

Options for creating a new check menu item.

Extends

• MenuItemOptions

Properties

Property	Type	Description	Inherited from	Defined in
accelerator?	string	Specify an accelerator for the new menu item.	MenuItemOptions.accelerator	packages/api/src/menu/menuItem.ts:17
action?	(id) => void	Specify a handler to be called when this menu item is activated.	MenuItemOptions.action	packages/api/src/menu/menuItem.ts:19
checked?	boolean	Whether the new check menu item is enabled or not.	-	packages/api/src/menu/checkMenuItem.ts:12
enabled?	boolean	Whether the new menu item is enabled or not.	MenuItemOptions.enabled	packages/api/src/menu/menuItem.ts:15
id?	string	Specify an id to use for the new menu item.	MenuItemOptions.id	packages/api/src/menu/menuItem.ts:11
text	string	The text of the new menu item.	MenuItemOptions.text	packages/api/src/menu/menuItem.ts:13

---

IconMenuItemOptions

Defined in: packages/api/src/menu/iconMenuItem.ts:133

Options for creating a new icon menu item.

Extends

• MenuItemOptions

Properties

Property	Type	Description	Inherited from	Defined in
accelerator?	string	Specify an accelerator for the new menu item.	MenuItemOptions.accelerator	packages/api/src/menu/menuItem.ts:17
action?	(id) => void	Specify a handler to be called when this menu item is activated.	MenuItemOptions.action	packages/api/src/menu/menuItem.ts:19
enabled?	boolean	Whether the new menu item is enabled or not.	MenuItemOptions.enabled	packages/api/src/menu/menuItem.ts:15
icon?	MenuIcon	Icon to be used for the new icon menu item. Note that you may need the image-ico or image-png Cargo features to use this API. To enable it, change your Cargo.toml file: [dependencies] tauri = { version = "...", features = ["...", "image-png"] }	-	packages/api/src/menu/iconMenuItem.ts:144
id?	string	Specify an id to use for the new menu item.	MenuItemOptions.id	packages/api/src/menu/menuItem.ts:11
text	string	The text of the new menu item.	MenuItemOptions.text	packages/api/src/menu/menuItem.ts:13

---

MenuItemOptions

Defined in: packages/api/src/menu/menuItem.ts:9

Options for creating a new menu item.

Extended by

• CheckMenuItemOptions
• IconMenuItemOptions

Properties

Property	Type	Description	Defined in
accelerator?	string	Specify an accelerator for the new menu item.	packages/api/src/menu/menuItem.ts:17
action?	(id) => void	Specify a handler to be called when this menu item is activated.	packages/api/src/menu/menuItem.ts:19
enabled?	boolean	Whether the new menu item is enabled or not.	packages/api/src/menu/menuItem.ts:15
id?	string	Specify an id to use for the new menu item.	packages/api/src/menu/menuItem.ts:11
text	string	The text of the new menu item.	packages/api/src/menu/menuItem.ts:13

---

MenuOptions

Defined in: packages/api/src/menu/menu.ts:23

Options for creating a new menu.

Properties

Property	Type	Description	Defined in
id?	string	Specify an id to use for the new menu.	packages/api/src/menu/menu.ts:25
items?	( | Submenu | MenuItem | PredefinedMenuItem | CheckMenuItem | IconMenuItem | MenuItemOptions | SubmenuOptions | IconMenuItemOptions | PredefinedMenuItemOptions | CheckMenuItemOptions)[]	List of items to add to the new menu.	packages/api/src/menu/menu.ts:27

---

PredefinedMenuItemOptions

Defined in: packages/api/src/menu/predefinedMenuItem.ts:84

Options for creating a new predefined menu item.

Properties

Property	Type	Description	Defined in
item	| "Separator" | "Copy" | "Cut" | "Paste" | "SelectAll" | "Undo" | "Redo" | "Minimize" | "Maximize" | "Fullscreen" | "Hide" | "HideOthers" | "ShowAll" | "CloseWindow" | "Quit" | "Services" | "BringAllToFront" | { About: | AboutMetadata | null; }	The predefined item type	packages/api/src/menu/predefinedMenuItem.ts:88
text?	string	The text of the new predefined menu item.	packages/api/src/menu/predefinedMenuItem.ts:86

Type Aliases

SubmenuOptions

type SubmenuOptions = Omit<MenuItemOptions, "accelerator" | "action"> & MenuOptions & object;

Defined in: packages/api/src/menu/submenu.ts:50

Type Declaration

Name	Type	Description	Defined in
icon?	MenuIcon	Icon to be used for the submenu. Note: you may need the image-ico or image-png Cargo features to use this API.	packages/api/src/menu/submenu.ts:56