MenuItem QML Type

Presents an item within a Menu. More...

Import Statement: import QtQuick.Controls 2.4
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

arrow : Item

This property holds the sub-menu arrow item.

This QML 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 QML 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 QML 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.