MenuItem QML Type | Qt Quick Controls 6.3.1

- Qt 6.3
- Qt Quick Controls
- QML Types
- MenuItem
- Qt 6.3.1 Reference Documentation

# MenuItem QML Type

Presents an item within a Menu. More...

Import Statement: | import QtQuick.Controls
Since: | Qt 5.7
Inherits: | AbstractButton

- List of all members, including inherited members

## Properties

- arrow : Item
- highlighted : bool
- menu : Menu
- subMenu : Menu

## Signals

- void triggered()

## Detailed Description

MenuItem is a convenience type that implements the AbstractButton API, providing a familiar way to respond to menu items being triggered, for example.

MenuItem inherits its API from AbstractButton. For instance, you can set text and icon using the AbstractButton API.

     Button {
         id: fileButton
         text: "File"
         onClicked: menu.open()

         Menu {
             id: menu

             MenuItem {
                 text: "New..."
                 onTriggered: document.reset()
             }
             MenuItem {
                 text: "Open..."
                 onTriggered: openDialog.open()
             }
             MenuItem {
                 text: "Save"
                 onTriggered: saveDialog.open()
             }
         }
     }

See also Customizing Menu, Menu, and Menu Controls.

## Property Documentation

[since QtQuick.Controls 2.3 (Qt 5.10)] arrow : Item

This property holds the sub-menu arrow item.

This property was introduced in QtQuick.Controls 2.3 (Qt 5.10).

See also Customizing Menu.

highlighted : bool

This property holds whether the menu item is highlighted by the user.

A menu item can be highlighted by mouse hover or keyboard navigation.

The default value is `false`.

See also Menu::currentIndex.

[read-only, since QtQuick.Controls 2.3 (Qt 5.10)] menu : Menu

This property holds the menu that contains this menu item, or `null` if the item is not in a menu.

This property was introduced in QtQuick.Controls 2.3 (Qt 5.10).

[read-only, since QtQuick.Controls 2.3 (Qt 5.10)] subMenu : Menu

This property holds the sub-menu that this item presents in the parent menu, or `null` if this item is not a sub-menu item.

This property was introduced in QtQuick.Controls 2.3 (Qt 5.10).

## Signal Documentation

void triggered()

This signal is emitted when the menu item is triggered by the user.

Note: The corresponding handler is `onTriggered`.