菜单项

Previous菜单 Next系统托盘

Last updated 4 years ago

Was this helpful?

菜单项

在程序菜单或上下文菜单中插入新的菜单项

进程:

您可以在末尾查看示例.

`new MenuItem(options)`

options Object
- click Function (可选) - 单击菜单项被调用 click(menuItem,browserWindow)
  - menuItem MenuItem
  - browserWindow BrowserWindow
  - event Event
- role String (可选) - 定义菜单项操作,指定为 click 属性时该项将会被忽略. 详见.
- type String (可选) - 可选normal, separator, submenu, checkbox 或 radio.
- label String - (可选)
- sublabel String - (可选)
- accelerator (可选)
- icon ( | String) (可选)
- enabled Boolean (可选) - false表示菜单项显示为不可点击的灰色
- visible Boolean (可选) - false表示菜单项完全隐藏。
- checked Boolean (可选) - 仅 checkbox或 radio类型菜单项才需要指定。
- submenu (MenuItemConstructorOptions[] | Menu) (可选) - 应为 submenu 类型菜单项而指定,如果指定了 submenu，则 type：'submenu'可以省略。如果它的值不是 Menu,将自动转为 Menu.buildFromTemplate。
- id String - 菜单的唯一id。如果id已被使用,它将被用作这个菜单项的参考位置 position 属性。
- position String - 定义菜单的具体位置信息。

Roles任务

roles 可使菜单项具有预定义行为.

在创建菜单项时,如果有匹配的方法,建议直接指定 role 属性而不是尝试在 click函数中手动实现该行为,这样可以给用户最好的使用体验。

当使用 role时, label和 accelerator 的值是可选的,默认将根据平台使用适当的值。

role属性值可以为:

undo
redo
cut
copy
paste
pasteandmatchstyle
selectall
delete
minimize - 最小化当前窗口
close - 关闭当前窗口
quit- 退出应用
reload -重新加载当前窗口
forcereload - 重新加载当前窗口并忽略缓存。
toggledevtools - 在当前窗口中切换开发人员工具
togglefullscreen - 在当前窗口切换全屏模式
resetzoom - 聚焦页缩放级别重置为原始大小
zoomin - 聚焦页放大10％
zoomout - 聚焦页缩小10％
editMenu - 默认的 编辑菜单 (撤销, 复制等等)
windowMenu - 默认的 窗口菜单 (最小化, 关闭等等)

在 macOS 上也可使用下列 role :

about - 映射到 orderFrontStandardAboutPanel动作
hide - 映射到 hide动作
hideothers - 映射到 hideOtherApplications动作
unhide - 映射到 unhideAllApplications动作
startspeaking - 映射到 startSpeaking动作
stoppeaking - 映射到 stopSpeaking动作
front - 映射到 arrangeInFront动作
zoom - 映射到 performZoom动作
window - 子菜单是一个 Window菜单
help - 子菜单是一个 帮助菜单
services - 子菜单是一个 服务菜单

当在macOS上指定 role时, label 和 accelerator是唯一会影响MenuItem的选项。其他选项将被忽略。

实例属性

`menuItem.enabled`

属性:是否启用该项

此属性可以动态更改。

`menuItem.visible`

属性:是否可见该项

此属性可以动态更改。

`menuItem.checked`

属性:该项是否已选中

checkbox 菜单项将在选中时打开或关闭 checked属性 radio菜单项将在点击时打开其checked属性,并将关闭同一菜单中所有相邻项的该属性。

如果需要其他行为,您可以直接添加一个 click函数。

此属性可以动态更改。

`menuItem.label`

属性:菜单项内容字符串

`menuItem.click`

属性:点击菜单项时需要触发的函数

Previous菜单 Next系统托盘

Last updated 4 years ago

Was this helpful?

在程序菜单或上下文菜单中插入新的菜单项

进程:

您可以在末尾查看示例.

`new MenuItem(options)`

options Object
- click Function (可选) - 单击菜单项被调用 click(menuItem,browserWindow)
  - menuItem MenuItem
  - browserWindow BrowserWindow
  - event Event
- role String (可选) - 定义菜单项操作,指定为 click 属性时该项将会被忽略. 详见.
- type String (可选) - 可选normal, separator, submenu, checkbox 或 radio.
- label String - (可选)
- sublabel String - (可选)
- accelerator (可选)
- icon ( | String) (可选)
- enabled Boolean (可选) - false表示菜单项显示为不可点击的灰色
- visible Boolean (可选) - false表示菜单项完全隐藏。
- checked Boolean (可选) - 仅 checkbox或 radio类型菜单项才需要指定。
- submenu (MenuItemConstructorOptions[] | Menu) (可选) - 应为 submenu 类型菜单项而指定,如果指定了 submenu，则 type：'submenu'可以省略。如果它的值不是 Menu,将自动转为 Menu.buildFromTemplate。
- id String - 菜单的唯一id。如果id已被使用,它将被用作这个菜单项的参考位置 position 属性。
- position String - 定义菜单的具体位置信息。

Roles任务

roles 可使菜单项具有预定义行为.

在创建菜单项时,如果有匹配的方法,建议直接指定 role 属性而不是尝试在 click函数中手动实现该行为,这样可以给用户最好的使用体验。

当使用 role时, label和 accelerator 的值是可选的,默认将根据平台使用适当的值。

role属性值可以为:

undo
redo
cut
copy
paste
pasteandmatchstyle
selectall
delete
minimize - 最小化当前窗口
close - 关闭当前窗口
quit- 退出应用
reload -重新加载当前窗口
forcereload - 重新加载当前窗口并忽略缓存。
toggledevtools - 在当前窗口中切换开发人员工具
togglefullscreen - 在当前窗口切换全屏模式
resetzoom - 聚焦页缩放级别重置为原始大小
zoomin - 聚焦页放大10％
zoomout - 聚焦页缩小10％
editMenu - 默认的 编辑菜单 (撤销, 复制等等)
windowMenu - 默认的 窗口菜单 (最小化, 关闭等等)

在 macOS 上也可使用下列 role :

about - 映射到 orderFrontStandardAboutPanel动作
hide - 映射到 hide动作
hideothers - 映射到 hideOtherApplications动作
unhide - 映射到 unhideAllApplications动作
startspeaking - 映射到 startSpeaking动作
stoppeaking - 映射到 stopSpeaking动作
front - 映射到 arrangeInFront动作
zoom - 映射到 performZoom动作
window - 子菜单是一个 Window菜单
help - 子菜单是一个 帮助菜单
services - 子菜单是一个 服务菜单

当在macOS上指定 role时, label 和 accelerator是唯一会影响MenuItem的选项。其他选项将被忽略。

实例属性

`menuItem.enabled`

属性:是否启用该项

此属性可以动态更改。

`menuItem.visible`

属性:是否可见该项

此属性可以动态更改。

`menuItem.checked`

属性:该项是否已选中

checkbox 菜单项将在选中时打开或关闭 checked属性 radio菜单项将在点击时打开其checked属性,并将关闭同一菜单中所有相邻项的该属性。

如果需要其他行为,您可以直接添加一个 click函数。

此属性可以动态更改。

`menuItem.label`

属性:菜单项内容字符串

`menuItem.click`

属性:点击菜单项时需要触发的函数