提供一种行云设计风格的 Menu 控件. 更多...

类 Menu 继承关系图:

属性
bool	closeOnInactive

int	maxVisibleItems
	maxVisibleItems 用于控制菜单中的最大项数

DPalette	backgroundColor
	backgroundColor 属性控制 Menu 的背景颜色。

var	model
	`model` 属性是 Menu 的模型，`model`用于控制菜单的数据添加和删除，动态进行数据创建等等。

Component	header
	header 属性可指定 Menu 的自定义的头部组件。

Component	footer
	footer 属性可指定 Menu 的自定义的底部组件。

bool	existsChecked
	existsChecked 属性可判断当前的 Menu 中是否存在已经选中的 MenuItem，如果存在则返回 true ，否则返回 false。

bool	active

详细描述

提供一种行云设计风格的 Menu 控件.

Menu 控件大多被用于应用菜单，例如功能菜单、右键菜单等。 DTK 实现的菜单比原有样式的菜单更流畅;更定制化，它能够兼容 Menu 的所有接口，并且能够做到内部的 MenuItem 自动适配菜单的宽高。
除此之外，Menu 还支持添加头部控件和尾部控件，当需要添加自定义搜索内容时，头部控件可以添加 SearchEdit 来实现。
Menu 的最大项目个数在 DTK 的设计中是 16，当超过该数值时，Menu 会出现滚动选项，同时菜单的上部和下部会出现上下移动的按钮，鼠标放置时可自动进行移动。
Menu 的基本用于如下代码所示：

Menu {
    MenuItem { text: qsTr("打开") }
    MenuItem { text: qsTr("在新窗口打开") }
    MenuItem { text: qsTr("在新标签中打开") }
    MenuItem { text: qsTr("以管理员身份打开") }
    MenuSeparator {}
    MenuItem { text: qsTr("复制") }
    MenuSeparator {}
    MenuItem { text: qsTr("共享文件夹")}
    MenuItem { text: qsTr("创建链接")}
    MenuItem { text: qsTr("发送到桌面")}
    MenuItem { text: qsTr("在终端中打开")}
    Menu { title: qsTr("自定义")}
    MenuItem { text: qsTr("压缩")}
    MenuItem { text: qsTr("属性")}
}

如上代码， Menu 内部控件需要使用 Menu、MenuItem 或者 MenuSeparator，其中 MenuItem 用来显示实际的菜单项，包含图表和文本， MenuSeparator 用来显示菜单中的分隔符。在菜单中内部的子菜单，可以使用 Menu 叠加的方式完成。
对于自定义头部控件，这里使用一个 SearchEdit 的示例表示：

Menu {
    id: searchAndArrowMenu
    width: 160
    header: SearchEdit {
        placeholder: qsTr("搜索")
        onTextChanged: {
            proxyModel.filterText = text
            proxyModel.update()
        }
    }
    model: ObjectModelProxy {
        id: proxyModel
        property string filterText
        filterAcceptsItem: function(item) {
            return item.text.includes(filterText)
        }
        sourceModel: searchAndArrowMenu.contentModel
    }
 
    maxVisibleItems: 10
    MenuItem { text: qsTr("Greek(cp869)") }
    MenuItem { text: qsTr("Cyrillic (ISO 8859-5)") }
    MenuItem { text: qsTr("Cyrillic(KOI8-R)") }
    MenuItem { text: qsTr("Devanagari(x-mac-davanagari)") }
    MenuItem { text: qsTr("Gurmukhi(x-mac-gurmukhi)") }
    MenuItem { text: qsTr("Thai (ISO 8859-11)") }
    MenuItem { text: qsTr("Simplified Chinese(x-mac-sim-chinese)") }
    MenuItem { text: qsTr("Chinese(GBK)"); checked: true}
    MenuItem { text: qsTr("Chinese(GB 18030)") }
    MenuItem { text: qsTr("Chinese(ISO 2022-CN)") }
    MenuItem { text: qsTr("Simplified Chinese (GB2312)") }
    MenuItem { text: qsTr("Tibetan (x-mac-tibetan)") }
    MenuItem { text: qsTr("Central European(ISO Latin 2)") }
    MenuItem { text: qsTr("Central Eu 188 opx(ISO Latin 4)") }
    MenuItem { text: qsTr("Baltic (ISO Latin 7)") }
}

属性说明

◆ active

bool Menu::active

read

备注: This property is read-only

◆ existsChecked

bool Menu::existsChecked

read

existsChecked 属性可判断当前的 Menu 中是否存在已经选中的 MenuItem，如果存在则返回 true ，否则返回 false。

备注: This property is read-only

注解: 此属性为只读属性

◆ maxVisibleItems

int Menu::maxVisibleItems

read

maxVisibleItems 用于控制菜单中的最大项数

默认情况下，该值是 16。当 Menu中的项数超过最大可视项目数量，其他的菜单项会处于滚动显示的状态。
并且在菜单的头部和尾部会添加向上和向下滚动的按钮，当鼠标放置在上面时，菜单自动滚动。

◆ model

var Menu::model

read

model 属性是 Menu 的模型，model用于控制菜单的数据添加和删除，动态进行数据创建等等。

一般情况下， Menu 只需要手动添加 MenuItem 而不需要指定model，当需要对model的数据进行过滤时，可以使用 ObjectModelProxy 包装该模型。一般可用于控制 MenuItem 的显示和隐藏，创建和删除。手动控制 MenuItem 中 visible 属性会在 Menu 中留下一个视觉上的空位，因此不推荐直接使用 visible 属性控制 MenuItem 的隐藏。

该类的文档由以下文件生成:

src/qml/Menu.qml
docs/qml/Menu.zh_CN.dox