kmenu.h

Go to the documentation of this file.

/****************************************************************************
**
** This file is part of KDWinutils, KDAB's MFC to Qt migration tool.
**
** Copyright (C) 2024 Klarälvdalens Datakonsult AB, a KDAB Group company <info@kdab.com>
** All rights reserved.
**
** This file is intended solely for use by the migration tools and services
** provided by Klarälvdalens Datakonsult AB.
**
**  Any other use or distribution of this software that is not otherwise agreed
**  upon in writing and signed by an authorized representative of Klarälvdalens
**  Datakonsult AB, KDAB (USA) LLC, KDAB (Deutschland) GmbH & Co. K.G.,
**  KDAB (France) SAS, KDAB (UK), Ltd., or any future subsidiary of Klarälvdalens
**  Datakonsult AB is hereby prohibited.
**
**  Contact info@kdab.com if any conditions stated above are unclear to you.
**
****************************************************************************/
 
#pragma once
 
#include "../corelib/kstring.h"
#include "../kdwinutils_global.h"
 
#include <QMenu>
 
#include <cstdint>
 
class QAction;
 
KDWINUTILS_BEGIN_NAMESPACE
 
class KRect;
 
class KDWINUTILS_EXPORT KMenu : public QMenu
{
    Q_OBJECT
public:
    explicit KMenu(QWidget *parent = nullptr);
 
    enum class AppendType {
        String,
        Separator,
        Popup,
    };
 
    enum class ModifyBy {
        Command,
        Position,
    };
 
    // Uses AppendToMenu to add a menu action, then connects the trigger of that action to the provided slot
    void AppendAndConnect(KMenu::AppendType appendType, std::uintptr_t nID, const KString &label,
                          std::function<void(std::uintptr_t nID)> slot);
 
    QAction *AppendToMenu(AppendType nFlags, std::uintptr_t nIDNewItem = 0, const KString &lpszNewItem = {});
 
    void CheckMenuItem(unsigned int nIDCheckItem, Qt::CheckState nCheck);
 
    bool TrackPopupMenu(unsigned int nFlags, int x, int y, QWidget *pWnd = nullptr, KRect *lpRect = 0);
 
    bool ModifyMenuItem(unsigned int nPosition, ModifyBy nFlags, std::uintptr_t nIDNewItem = 0,
                        const KString &lpszNewItem = {});
 
private:
    QMap<std::uintptr_t, QAction *> m_actionMap;
};
 
KDWINUTILS_END_NAMESPACE