MenuItemButton class

A button for use in a MenuBar, in a menu created with MenuAnchor, or on its own, that can be activated by click or keyboard navigation.

This widget represents a leaf entry in a menu hierarchy that is typically part of a MenuBar, but may be used independently, or as part of a menu created with a MenuAnchor.

Menus using MenuItemButton can have a SingleActivator or CharacterActivator assigned to them as their MenuItemButton.shortcut, which will display an appropriate shortcut hint. Even though the shortcut labels are displayed in the menu, shortcuts are not automatically handled. They must be available in whatever context they are appropriate, and handled via another mechanism.

If shortcuts should be generally enabled, but are not easily defined in a context surrounding the menu bar, consider registering them with a ShortcutRegistry (one is already included in the WidgetsApp, and thus also MaterialApp and CupertinoApp), as shown in the example below. To be sure that selecting a menu item and triggering the shortcut do the same thing, it is recommended that they call the same callback.

See also:

• MenuBar, a class that creates a top level menu bar in a Material Design style.
• MenuAnchor, a widget that creates a region with a submenu and shows it when requested.
• SubmenuButton, a menu item similar to this one which manages a submenu.
• PlatformMenuBar, which creates a menu bar that is rendered by the host platform instead of by Flutter (on macOS, for example).
• ShortcutRegistry, a registry of shortcuts that apply for the entire application.
• VoidCallbackIntent, to define intents that will call a VoidCallback and work with the Actions and Shortcuts system.
• CallbackShortcuts to define shortcuts that call a callback without involving Actions.