Back to Qt.io
Contact Us Blog Download Qt

MenuItem QML Type

Presents an item within a Menu. More...

Import Statement: import QtQuick.Controls
Inherits:

AbstractButton

Properties

  • arrow : Item (since QtQuick.Controls 2.3 (Qt 5.10))
  • highlighted : bool
  • menu : Menu (since QtQuick.Controls 2.3 (Qt 5.10))
  • subMenu : Menu (since QtQuick.Controls 2.3 (Qt 5.10))

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

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

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.


© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.