/**************************************************************************** ** ** Copyright (C) 2016 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of the Qt Quick Controls module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 3 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL3 included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 3 requirements ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 2.0 or (at your option) the GNU General ** Public license version 3 or any later version approved by the KDE Free ** Qt Foundation. The licenses are as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-2.0.html and ** https://www.gnu.org/licenses/gpl-3.0.html. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ import QtQml 2.14 as Qml import QtQuick 2.2 import QtQuick.Controls 1.2 import QtQuick.Controls.Styles 1.1 import QtQuick.Controls.Private 1.0 /*! \qmltype MenuBar \inqmlmodule QtQuick.Controls \since 5.1 \ingroup applicationwindow \ingroup controls \brief Provides a horizontal menu bar. \image menubar.png MenuBar can be added to an \l ApplicationWindow, providing menu options to access additional functionality of the application. \code ApplicationWindow { ... menuBar: MenuBar { Menu { title: "File" MenuItem { text: "Open..." } MenuItem { text: "Close" } } Menu { title: "Edit" MenuItem { text: "Cut" } MenuItem { text: "Copy" } MenuItem { text: "Paste" } } } } \endcode \sa ApplicationWindow::menuBar */ MenuBarPrivate { id: root /*! \qmlproperty Component MenuBar::style \since QtQuick.Controls.Styles 1.2 The style Component for this control. \sa {MenuBarStyle} */ property Component style: Settings.styleComponent(Settings.style, "MenuBarStyle.qml", root) /*! \internal */ property QtObject __style: styleLoader.item __isNative: !__style.hasOwnProperty("__isNative") || __style.__isNative /*! \internal */ __contentItem: Loader { id: topLoader sourceComponent: __menuBarComponent active: !root.__isNative focus: true Keys.forwardTo: [item] property real preferredWidth: parent && active ? parent.width : 0 property bool altPressed: item ? item.__altPressed : false Loader { id: styleLoader property alias __control: topLoader.item sourceComponent: root.style onStatusChanged: { if (status === Loader.Error) console.error("Failed to load Style for", root) } } } /*! \internal */ property Component __menuBarComponent: Loader { id: menuBarLoader Accessible.role: Accessible.MenuBar onStatusChanged: if (status === Loader.Error) console.error("Failed to load panel for", root) visible: status === Loader.Ready sourceComponent: d.style ? d.style.background : undefined width: implicitWidth || root.__contentItem.preferredWidth height: Math.max(row.height + d.heightPadding, item ? item.implicitHeight : 0) Qml.Binding { // Make sure the styled menu bar is in the background target: menuBarLoader.item property: "z" value: menuMouseArea.z - 1 restoreMode: Binding.RestoreBinding } QtObject { id: d property Style style: __style property int openedMenuIndex: -1 property bool preselectMenuItem: false property real heightPadding: style ? style.padding.top + style.padding.bottom : 0 property bool altPressed: false property bool altPressedAgain: false property var mnemonicsMap: ({}) function openMenuAtIndex(index) { if (openedMenuIndex === index) return; var oldIndex = openedMenuIndex openedMenuIndex = index if (oldIndex !== -1) { var menu = root.menus[oldIndex] if (menu.__popupVisible) menu.__dismissAndDestroy() } if (openedMenuIndex !== -1) { menu = root.menus[openedMenuIndex] if (menu.enabled) { if (menu.__usingDefaultStyle) menu.style = d.style.menuStyle var xPos = row.LayoutMirroring.enabled ? menuItemLoader.width : 0 menu.__popup(Qt.rect(xPos, menuBarLoader.height - d.heightPadding, 0, 0), 0) if (preselectMenuItem) menu.__currentIndex = 0 } } } function dismissActiveFocus(event, reason) { if (reason) { altPressedAgain = false altPressed = false openMenuAtIndex(-1) root.__contentItem.parent.forceActiveFocus() } else { event.accepted = false } } function maybeOpenFirstMenu(event) { if (altPressed && openedMenuIndex === -1) { preselectMenuItem = true openMenuAtIndex(0) } else { event.accepted = false } } } property alias __altPressed: d.altPressed // Needed for the menu contents focus: true Keys.onPressed: { var action = null if (event.key === Qt.Key_Alt) { if (!d.altPressed) d.altPressed = true else d.altPressedAgain = true } else if (d.altPressed && (action = d.mnemonicsMap[event.text.toUpperCase()])) { d.preselectMenuItem = true action.trigger() event.accepted = true } } Keys.onReleased: d.dismissActiveFocus(event, d.altPressedAgain && d.openedMenuIndex === -1) Keys.onEscapePressed: d.dismissActiveFocus(event, d.openedMenuIndex === -1) Keys.onUpPressed: d.maybeOpenFirstMenu(event) Keys.onDownPressed: d.maybeOpenFirstMenu(event) Keys.onLeftPressed: { if (d.openedMenuIndex > 0) { var idx = d.openedMenuIndex - 1 while (idx >= 0 && !(root.menus[idx].enabled && root.menus[idx].visible)) idx-- if (idx >= 0) { d.preselectMenuItem = true d.openMenuAtIndex(idx) } } else { event.accepted = false; } } Keys.onRightPressed: { if (d.openedMenuIndex !== -1 && d.openedMenuIndex < root.menus.length - 1) { var idx = d.openedMenuIndex + 1 while (idx < root.menus.length && !(root.menus[idx].enabled && root.menus[idx].visible)) idx++ if (idx < root.menus.length) { d.preselectMenuItem = true d.openMenuAtIndex(idx) } } else { event.accepted = false; } } Keys.forwardTo: d.openedMenuIndex !== -1 ? [root.menus[d.openedMenuIndex].__contentItem] : [] Row { id: row x: d.style ? d.style.padding.left : 0 y: d.style ? d.style.padding.top : 0 width: parent.width - (d.style ? d.style.padding.left + d.style.padding.right : 0) LayoutMirroring.enabled: Qt.application.layoutDirection === Qt.RightToLeft Repeater { id: itemsRepeater model: root.menus Loader { id: menuItemLoader Accessible.role: Accessible.MenuItem Accessible.name: StyleHelpers.removeMnemonics(opts.text) Accessible.onPressAction: d.openMenuAtIndex(opts.index) property var styleData: QtObject { id: opts readonly property int index: __menuItemIndex readonly property string text: !!__menuItem && __menuItem.title readonly property bool enabled: !!__menuItem && __menuItem.enabled readonly property bool selected: menuMouseArea.hoveredItem === menuItemLoader readonly property bool open: !!__menuItem && __menuItem.__popupVisible || d.openedMenuIndex === index readonly property bool underlineMnemonic: d.altPressed } height: Math.max(menuBarLoader.height - d.heightPadding, menuItemLoader.item ? menuItemLoader.item.implicitHeight : 0) readonly property var __menuItem: modelData readonly property int __menuItemIndex: index sourceComponent: d.style ? d.style.itemDelegate : null visible: __menuItem.visible Connections { target: __menuItem function onAboutToHide() { if (d.openedMenuIndex === index) { d.openMenuAtIndex(-1) menuMouseArea.hoveredItem = null } } } Connections { target: __menuItem.__action function onTriggered() { d.openMenuAtIndex(__menuItemIndex) } } Component.onCompleted: { __menuItem.__visualItem = menuItemLoader var title = __menuItem.title var ampersandPos = title.indexOf("&") if (ampersandPos !== -1) d.mnemonicsMap[title[ampersandPos + 1].toUpperCase()] = __menuItem.__action } } } } MouseArea { id: menuMouseArea anchors.fill: parent hoverEnabled: Settings.hoverEnabled onPositionChanged: updateCurrentItem(mouse) onPressed: updateCurrentItem(mouse) onExited: hoveredItem = null property Item currentItem: null property Item hoveredItem: null function updateCurrentItem(mouse) { var pos = mapToItem(row, mouse.x, mouse.y) if (pressed || !hoveredItem || !hoveredItem.contains(Qt.point(pos.x - currentItem.x, pos.y - currentItem.y))) { hoveredItem = row.childAt(pos.x, pos.y) if (!hoveredItem) return false; currentItem = hoveredItem if (pressed || d.openedMenuIndex !== -1) { d.preselectMenuItem = false d.openMenuAtIndex(currentItem.__menuItemIndex) } } return true; } } } }