aObjectManager.h

Go to the documentation of this file.

/*
 *  File:       aObjectManager.h
 *  Package:    akGui
 *
 *  Created on: July 14, 2020
 *  Author: Alexander Kuester
 *  Copyright (c) 2022 Alexander Kuester
 *  This file is part of the uiCore component.
 *  This file is subject to the terms and conditions defined in
 *  file 'LICENSE', which is part of this source code package.
 */
 
#pragma once
 
 // AK header
#include <akCore/globalDataTypes.h>
#include <akCore/akCore.h>
 
// C++ header
#include <map>                          // map
#include <exception>
 
// Qt header
#include <qstring.h>
#include <qicon.h>
#include <qtoolbutton.h>                // QToolButton popup mode
#include <qpixmap.h>
 
namespace ak {
 
    class aObject;
    class aNotifierObjectManager;
    class aMessenger;
    class aUidManager;
    class aSignalLinker;
    class aToolButtonWidget;
 
    class UICORE_API_EXPORT aObjectManager {
    public:
        aObjectManager(
            aMessenger *                _messenger,
            aUidManager *               _uidManager
        );
 
        virtual ~aObjectManager();
 
        // ###############################################################################################################################################
 
        // Object creation
 
        UID createAction(
            UID                                             _creatorUid,
            const QString &                                     _text,
            const QIcon &                                       _icon,
            QToolButton::ToolButtonPopupMode                    _popupMode = QToolButton::ToolButtonPopupMode::InstantPopup
        );
 
        UID createCheckBox(
            UID                                             _creatorUid,
            const QString &                                     _text = QString(""),
            bool                                                _checked = false
        );
 
        UID createLineEdit(
            UID                                                 _creatorUid,
            const QString &                                         _initialText = QString("")
        );
 
        UID createNiceLineEdit(
            UID                                             _creatorUid,
            const QString &                                     _initialText,
            const QString &                                     _infoLabelText
        );
 
        UID createTimer(
            UID                                             _creatorUid
        );
 
        UID createToolButton(
            UID                                             _creatorUid
        );
 
        UID createToolButton(
            UID                                             _creatorUid,
            const QString &                                     _text
        );
 
        UID createToolButton(
            UID                                             _creatorUid,
            const QString &                                     _text,
            const QIcon &                                       _icon
        );
 
        UID createTabToolBarSubContainer(
            UID                                             _creatorUid,
            UID                                             _parentUid,
            const QString &                                     _text = QString("")
        );
 
        UID createTabToolBarPage(
            UID                                             _creatorUid,
            UID                                             _uiManagerUid,
            const QString &                                     _text = QString("")
        );
 
        /*
        UID createWelcomeScreen(
            UID                                             _creatorUid
        );
        */
 
        UID createWindow(
            UID                                             _creatorUid
        );
 
        // ###############################################################################################################################################
 
        // Object manipulation
 
        aObject * object(
            UID                                             _objectUid
        );
 
        aObject * object(
            const QString &                                     _objectUniqueName
        );
 
        // ###############################################################################################################################################
 
        // Special events
 
        void creatorDestroyed(
            UID                                             _creatorUid
        );
 
        void destroy(
            UID                                             _objectUID,
            bool                                                _ignoreIfObjectHasChildObjects = false
        );
 
        void destroyAll(void);
 
        void setObjectUniqueName(
            UID                                             _objectUid,
            const QString &                                     _uniqueName
        );
 
        UID objectCreator(
            UID                                             _objectUID
        );
 
        bool objectExists(
            UID                                             _objectUID
        );
 
    private:
 
        void addCreatedUid(
            UID                                             _creatorUid,
            UID                                             _createdUid
        );
 
        QWidget * castToWidget(
            UID                                             _objectUid
        );      
 
        // ###############################################################################################################################################
        
        // Object storing
 
        std::map<UID, aObject *>            m_mapObjects;
        std::map<QString, aObject *>        m_mapUniqueNames;           
 
        std::map<UID, std::vector<UID> *>   m_mapCreators;              
        std::map<UID, UID>                  m_mapOwners;                
 
        // ###############################################################################################################################################
 
        aUidManager *                       m_uidManager;                                   
        aMessenger *                        m_messenger;                                    
        aSignalLinker *                     m_signalLinker;                             
        aNotifierObjectManager *            m_notifier;                                 
 
        aObjectManager() = delete;
        aObjectManager(const aObjectManager &) = delete;
        aObjectManager & operator = (aObjectManager &) = delete;
 
    };
 
    class UICORE_API_EXPORT ObjectNotFoundException : public std::exception {
    public:
        ObjectNotFoundException();
    };
 
} // namespace ak