组件/导航组件引入于 1.2.0

ECommandPalette 命令面板

import EUI 1.0

示例与代码

搜索并执行命令

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Column { width: Math.min(420, parent ? parent.width : 420) spacing: 8 EButton { text: qsTr("打开命令面板") onClicked: palette.open() } ECommandPalette { id: palette shortcut: "" model: [{text: qsTr("打开"), command: "open", iconSource: EIcons.FOLDER}, {text: qsTr("保存"), command: "save", iconSource: EIcons.COPY}, {text: qsTr("复制"), command: "copy", iconSource: EIcons.COPY}] } }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

按关键词搜索

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Column { width: Math.min(420, parent ? parent.width : 420) spacing: 8 EButton { text: qsTr("打开命令面板") onClicked: palette.open() } ECommandPalette { id: palette shortcut: "" model: [{text: qsTr("打开"), command: "open", keywords: qsTr("document 文件")}, {text: qsTr("保存"), command: "save"}] } }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

禁用命令

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Column { width: Math.min(420, parent ? parent.width : 420) spacing: 8 EButton { text: qsTr("打开命令面板") onClicked: palette.open() } ECommandPalette { id: palette shortcut: "" model: [{text: qsTr("打开"), command: "open", enabled: false}, {text: qsTr("保存"), command: "save"}] } }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

执行后保持打开

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Column { width: Math.min(420, parent ? parent.width : 420) spacing: 8 EButton { text: qsTr("打开命令面板") onClicked: palette.open() } ECommandPalette { id: palette shortcut: "" model: [{text: qsTr("打开"), command: "open", iconSource: EIcons.FOLDER}, {text: qsTr("保存"), command: "save", iconSource: EIcons.COPY}, {text: qsTr("复制"), command: "copy", iconSource: EIcons.COPY}] closeOnTrigger: false } }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

执行 Qt Action

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Column { width: Math.min(420, parent ? parent.width : 420) spacing: 8 EButton { text: qsTr("打开命令面板") onClicked: palette.open() } ECommandPalette { id: palette shortcut: "" model: [{action: saveAction}] } Action { id: saveAction text: qsTr("保存") } }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

属性

属性说明取值与默认值

closeOnTriggerbool

成功执行命令后关闭面板。

默认值true

currentIndexint

当前选中的命令或步骤索引。

-1：未选择
0 起：条目索引

默认值-1

enabledbool

是否允许交互；false 时控件禁用。

默认值true

fontfont

字体配置，控制字体、字号及文字样式。

常用字段：
family、pixelSize、pointSize
bold、italic、weight
underline、strikeout
letterSpacing、wordSpacing

默认值Qt.font({ pixelSize: 16 })

heightreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitHeight

modelvar

项目模型；组件示例及使用指南说明其字段。

默认值[]

placeholderTextstring

搜索输入框的占位文字。

默认值EControlConfig.textFor(control, "CommandSearch", ELocale.texts)

querystring

命令搜索文本，按空白分词并忽略大小写。

默认值""

shortcutstring

打开或关闭命令面板的快捷键；空字符串禁用。

默认值"Ctrl+Shift+P"

visiblebool

是否显示组件。

默认值true

visibleRowsint

命令列表最多直接显示的行数。

默认值8

widthreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitWidth

filteredItemsvar只读

匹配当前查询且未隐藏的命令列表。

默认值由运行时计算

信号

签名作用

failed(string message)

操作失败时触发，message 为错误信息。

command(var value, var item)

执行命令时触发，包含命令值和对应菜单项。

方法

签名作用

trigger(index)

触发给定项目的命令，相当于选择该命令项。