MenuItem QML Type

Presents an item within a Menu. 更多...

import 語句：	`import QtQuick.Controls`
繼承：	AbstractButton

所有成員列錶，包括繼承成員

特性

arrow : Item (since QtQuick.Controls 2.3 (Qt 5.10))
highlighted : bool
implicitTextPadding : real (從 6.8 起)
menu : Menu (since QtQuick.Controls 2.3 (Qt 5.10))
subMenu : Menu (since QtQuick.Controls 2.3 (Qt 5.10))
textPadding : real (從 6.8 起)

信號

void triggered ()

詳細描述

MenuItem is a convenience type that implements the AbstractButton API, providing a familiar way to respond to menu items being triggered ，例如。

MenuItem inherits its API from AbstractButton . For instance, you can set text and icon 使用 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()
        }
    }
}

另請參閱 Customizing Menu , Menu ，和菜單控件 .

特性文檔編製

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

This property holds the sub-menu arrow item.

該特性在 QtQuick.Controls 2.3 (Qt 5.10) 引入。

另請參閱 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.

默認值為 false .

另請參閱 Menu::currentIndex .

implicitTextPadding : real [since 6.8]

This property holds the minimum space needed from the left edge of the contentItem to the text. It's used to calculate a common textPadding among all the MenuItems inside a Menu .

該特性在 Qt 6.8 引入。

另請參閱 textPadding .

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

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

該特性在 QtQuick.Controls 2.3 (Qt 5.10) 引入。

subMenu : Menu [read-only, since 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.

該特性在 QtQuick.Controls 2.3 (Qt 5.10) 引入。

textPadding : real [read-only, since 6.8]

This property holds the maximum implicitTextPadding found among all the menu items inside the same menu .

This property can be used by the style to ensure that all MenuItems inside the same Menu end up aligned with respect to the text .

A Menu can consist of meny different MenuItems, some can be checkable, some can have an icon, and some will just contain text. And very often, a style wants to make sure that the text inside all of them ends up left-aligned (or right-aligned for mirrored items). By letting each MenuItem assign its own minimum text padding to implicitTextPadding (taking icons and checkmarks into account), but using textPadding to actually position the text , all MenuItems should end up being aligned

In order for this to work, all MenuItems should set implicitTextPadding to be the minimum space needed from the left edge of the contentItem to the text.

該特性在 Qt 6.8 引入。

另請參閱 implicitTextPadding .

信號文檔編製

void triggered ()

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

注意： 相應處理程序是 onTriggered .