MenuItem QML Type

Presents an item within a Menu. More...

Import Statement: import QtQuick.Controls 2.0
Since: Qt 5.7
Inherits:

AbstractButton

Properties

Signals

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.

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).

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.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.0/qml-qtquick-controls2-menuitem.html