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 .