umlapp.h

Go to the documentation of this file.

/*
    SPDX-License-Identifier: GPL-2.0-or-later
    SPDX-FileCopyrightText: 2002-2022 Umbrello UML Modeller Authors <umbrello-devel@kde.org>
*/
 
#ifndef UML_H
#define UML_H
 
#include "basictypes.h"
#include "multipagedialogbase.h"
 
// kde includes
#include <kxmlguiwindow.h>
#include <ksharedconfig.h>
 
// qt includes
#include <QPointer>
#include <QUrl>
 
// forward declaration of the UML classes
class BirdView;
class BirdViewDockWidget;
class CodeDocument;
class CodeGenerator;
class CodeGenerationPolicy;
class CodeGenPolicyExt;
class DocWindow;
class UMLAppPrivate;
class UMLClassifier;
class UMLDoc;
class UMLListView;
class UMLView;
class WorkToolBar;
class SettingsDialog;
class UMLViewImageExporterAll;
class RefactoringAssistant;
class XhtmlGenerator;
class StatusBarToolButton;
class DiagramPrintPage;
 
// KDE forward declarations
class KActionMenu;
class KRecentFilesAction;
class KToggleAction;
class KTabWidget;
class QMenu;
class KAction;
 
// Qt forward declarations
class QStackedWidget;
class QToolButton;
class QDockWidget;
class QVBoxLayout;
class QKeyEvent;
class QMenu;
class QMimeData;
class QPrinter;
class QUndoCommand;
class QUndoView;
class QUndoStack;
class QPushButton;
class QLabel;
class QListWidget;
class QSlider;
 
class UMLApp : public KXmlGuiWindow
{
    Q_OBJECT
public:
    explicit UMLApp(QWidget *parent = nullptr);
    ~UMLApp();
 
    void setup();
 
    static UMLApp* app();
 
    void openDocumentFile(const QUrl& url=QUrl());
 
    void newDocument();
 
    UMLDoc *document() const;
 
    UMLListView* listView() const;
    WorkToolBar* workToolBar() const;
    DocWindow * docWindow() const;
    QListWidget *logWindow() const;
    bool logToConsole() const;
    void log(const QString& s);
    void logDebug(const QString& s);
    void logInfo(const QString& s);
    void logWarn(const QString& s);
    void logError(const QString& s);
 
    QCursor defaultCursor() const;
 
    void setModified(bool _m);
 
    void enablePrint(bool enable);
 
    bool isPasteState() const;
    bool isCutCopyState() const;
 
    bool isUndoEnabled() const;
    void enableUndo(bool enable);
 
    bool isUndoActionEnabled() const;
    void enableUndoAction(bool enable);
 
    bool isRedoActionEnabled() const;
    void enableRedoAction(bool enable);
 
    bool isSimpleCodeGeneratorActive() const;
 
    void setGenerator(CodeGenerator* gen, bool giveWarning = true);
    CodeGenerator* setGenerator(Uml::ProgrammingLanguage::Enum pl);
    CodeGenerator* generator() const;
 
    CodeGenerator* createGenerator();
    void initGenerator();
 
    void refactor(UMLClassifier* classifier);
 
    void viewCodeDocument(UMLClassifier* classifier);
 
    void setDiagramMenuItemsState(bool bState);
 
    QWidget* mainViewWidget() const;
 
    void setCurrentView(UMLView* view, bool updateTreeView = true);
    UMLView* currentView() const;
 
    void setImageMimeType(const QString& mimeType);
    QString imageMimeType() const;
 
    bool editCutCopy(bool bFromView);
 
    QTabWidget *tabWidget();
 
    QString statusBarMsg() const;
 
    CodeGenerationPolicy *commonPolicy() const;
 
    void setPolicyExt(CodeGenPolicyExt *policy);
    CodeGenPolicyExt *policyExt() const;
 
    void clearUndoStack();
 
    void undo();
    void redo();
 
    void executeCommand(QUndoCommand* cmd);
 
    void beginMacro(const QString & text);
    void endMacro();
 
    void setActiveLanguage(Uml::ProgrammingLanguage::Enum pl);
    Uml::ProgrammingLanguage::Enum activeLanguage() const;
    Uml::ProgrammingLanguage::Enum defaultLanguage() const;
 
    bool activeLanguageIsCaseSensitive() const;
 
    QString activeLanguageScopeSeparator() const;
 
    KConfig* config();
    void importFiles(QStringList& fileList, const QString &rootPath = QString());
 
    static bool shuttingDown();
 
    void deleteBirdView();
 
protected:
    virtual void keyPressEvent(QKeyEvent* e);
    virtual void keyReleaseEvent(QKeyEvent* e);
 
    virtual void customEvent(QEvent* e);
 
    void handleCursorKeyReleaseEvent(QKeyEvent* e);
 
    void saveOptions();
    void readOptions();
 
    void initActions();
    void initStatusBar();
    void initWidgets();
 
    virtual bool queryClose();
 
    virtual void saveProperties(KConfigGroup & cfg);
    virtual void readProperties(const KConfigGroup & cfg);
 
    void updateLangSelectMenu(Uml::ProgrammingLanguage::Enum activeLanguage);
 
public Q_SLOTS:
    void slotExecGenerationWizard();
    void slotImportingWizard();
 
    void slotFileNew();
    void slotFileOpen();
 
    void slotFileOpenRecent(const QUrl& url);
    void slotFileSave();
    bool slotFileSaveAs();
    void slotFileClose();
    bool slotPrintSettings();
    void slotPrintPreview();
    void slotPrintPreviewPaintRequested(QPrinter *printer);
    void slotFilePrint();
    void slotFileQuit();
    void slotFileExportDocbook();
    void slotFileExportXhtml();
    void slotFind();
    void slotFindNext();
    void slotFindPrevious();
    void slotEditCut();
    void slotEditCopy();
    void slotEditPaste();
    void slotStatusMsg(const QString &text);
    void slotClassDiagram();
    void slotObjectDiagram();
    void slotSequenceDiagram();
    void slotCollaborationDiagram();
    void slotUseCaseDiagram();
    void slotStateDiagram();
    void slotActivityDiagram();
    void slotComponentDiagram();
    void slotDeploymentDiagram();
    void slotEntityRelationshipDiagram();
    void slotAlignLeft();
    void slotAlignRight();
    void slotAlignTop();
    void slotAlignBottom();
    void slotAlignVerticalMiddle();
    void slotAlignHorizontalMiddle();
    void slotAlignVerticalDistribute();
    void slotAlignHorizontalDistribute();
    void slotClipDataChanged();
    void slotCopyChanged();
    void slotPrefs(MultiPageDialogBase::PageType page = MultiPageDialogBase::GeneralPage);
    void slotApplyPrefs();
    void slotImportClass();
    void slotImportProject();
    void slotUpdateViews();
    void slotCurrentViewClearDiagram();
    void slotCurrentViewToggleSnapToGrid();
    void slotCurrentViewToggleShowGrid();
    void slotCurrentViewExportImage();
    void slotViewsExportImages();
    void slotCurrentProperties();
    void slotClassWizard();
    void slotAddDefaultDatatypes();
    void slotCurrentViewChanged();
    void slotSnapToGridToggled(bool gridOn);
    void slotShowGridToggled(bool gridOn);
    void slotSelectAll();
    void slotDeleteSelected();
    void slotDeleteDiagram();
    void slotCloseDiagram(int index);
    void slotGenerateAllCode();
 
    void slotSetZoom(QAction* action);
    void slotZoomSliderMoved(int value);
    void slotZoomFit();
    void slotZoom100();
    void slotZoomOut();
    void slotZoomIn();
 
    void slotBirdViewChanged(const QPointF& newCenter);
 
    void setupZoomMenu();
 
    void slotEditUndo();
    void slotEditRedo();
 
    void slotTabChanged(int index);
    void slotChangeTabLeft();
    void slotChangeTabRight();
    void slotMoveTabLeft();
    void slotMoveTabRight();
 
    void slotXhtmlDocGenerationFinished(bool status);
    bool slotOpenFileInEditor(const QUrl &file, int startCursor = 0, int endCursor = 0);
 
private Q_SLOTS:
    void setLang_actionscript();
    void setLang_ada();
    void setLang_cpp();
    void setLang_csharp();
    void setLang_d();
    void setLang_idl();
    void setLang_java();
    void setLang_javascript();
    void setLang_mysql();
    void setLang_pascal();
    void setLang_perl();
    void setLang_php();
    void setLang_php5();
    void setLang_postgresql();
    void setLang_python();
    void setLang_ruby();
    void setLang_sql();
    void setLang_tcl();
    void setLang_vala();
    void setLang_xmlschema();
    void setLang_none();
    void slotDiagramPopupMenu(const QPoint& point);
 
private:
    static UMLApp* s_instance;  
    UMLAppPrivate *m_d;
 
    QMenu* findMenu(const QString &name);
 
    QAction* createZoomAction(int zoom, int currentZoom);
    void setZoom(int zoom, bool withView = true);
 
    void resetStatusMsg();
 
    void setProgLangAction(Uml::ProgrammingLanguage::Enum pl, const char* name, const char* action);
 
    static bool canDecode(const QMimeData* mimeSource);
 
    void readOptionState() const;
 
    void initClip();
    void initSavedCodeGenerators();
 
    void createDiagram(Uml::DiagramType::Enum type);
 
    void createBirdView(UMLView* view);
 
    QMenu* m_langSelect;  
    QMenu* m_zoomSelect;  
 
    Uml::ProgrammingLanguage::Enum  m_activeLanguage;  
    CodeGenerator*            m_codegen;         
    CodeGenerationPolicy*     m_commoncodegenpolicy;
    CodeGenPolicyExt*         m_policyext;       
    // Only used for new code generators ({Cpp, Java, Ruby, D}CodeGenerator).
 
    KSharedConfigPtr m_config;  
 
    QPointer<UMLView> m_view;
 
    UMLDoc* m_doc;
 
    QDockWidget* m_mainDock;           
    QDockWidget* m_propertyDock;       
    RefactoringAssistant* m_refactoringAssist;  
 
    // KAction pointers to enable/disable actions
    KRecentFilesAction* fileOpenRecent;
    QAction* printPreview;
    QAction* filePrint;
    QAction* editCut;
    QAction* editCopy;
    QAction* editPaste;
    QAction* editUndo;
    QAction* editRedo;
 
    KActionMenu* newDiagram;
    QAction* viewClearDiagram;
 
    KToggleAction* viewSnapToGrid;
    KToggleAction* viewShowGrid;
    QAction* viewExportImage;
    QAction* viewProperties;
 
    QAction* zoom100Action;
 
    QAction* m_langAct[Uml::ProgrammingLanguage::Reserved + 1];
    QAction* deleteSelectedWidget;
    QAction* deleteDiagram;
    QToolButton* m_newSessionButton;
    WorkToolBar* m_toolsbar;
    QTimer* m_clipTimer;
    QTimer* m_copyTimer;
 
    bool m_loading;  
 
    QStackedWidget* m_viewStack;
 
    QTabWidget* m_tabWidget;
 
    QVBoxLayout* m_layout;
 
    QString m_imageMimeType;  
 
    SettingsDialog* m_settingsDialog;  
 
    UMLViewImageExporterAll* m_imageExporterAll;  
 
    QLabel*      m_zoomValueLbl;
    QWidget*     m_defaultZoomWdg;
    QPushButton* m_pZoomOutPB;
    QPushButton* m_pZoomInPB;
    StatusBarToolButton* m_pZoomFitSBTB;
    StatusBarToolButton* m_pZoomFullSBTB;
    QSlider* m_pZoomSlider;
    QLabel* m_statusBarMessage;
    XhtmlGenerator* m_xhtmlGenerator;
 
    QUndoStack* m_pUndoStack;  
    bool m_undoEnabled; 
 
    bool m_hasBegunMacro;  
 
    QPointer<DiagramPrintPage> m_printSettings; 
    QPrinter *m_printer;               
    static bool s_shuttingDown;
 
Q_SIGNALS:
    void sigCutSuccessful();
 
    friend class UMLAppPrivate;
    friend class UMLView;
};
 
#endif // UML_H