Adaptado para superclasse | Adapted to superclass

CustomTitlebar tornou-se uma superclasse. Agora ele está em sua primeira produção.

Release: 0.9.1.0

EN

CustomTitlebar has become a superclass. And now it is on its first release.

Release: 0.9.1.0

Author: mauromascarenhas

CustomTitlebar.pro

@@ -4,7 +4,8 @@
 # Developer: Mauro Mascarenhas de Araújo
 # Contact: mauro.mascarenhas@nintersoft.com
 # License: Nintersoft Open Source Code Licence
-# Date: 15 of June of 2017
+# Date: 31 of May of 2018
+# Version: 0.9.1.0
 #
 #-------------------------------------------------
 
@@ -29,13 +30,13 @@ DEFINES += QT_DEPRECATED_WARNINGS
 
 SOURCES += \
         main.cpp \
-        frmmain.cpp \
-    titlebar.cpp
+        titlebar.cpp \
+        nmainwindow.cpp
 
 HEADERS += \
-        frmmain.h \
-    titlebar.h
+         titlebar.h \
+         nmainwindow.h
 
 FORMS += \
-        frmmain.ui \
-    titlebar.ui
+        titlebar.ui \
+        nmainwindow.ui

README.md

@@ -1,7 +1,13 @@
 # CustomTitlebar
-CustomTitlebar é um programa base desenvolvido com a biblioteca Qt, no qual é possível basear-se nele a fim de desenvolver outros programas que usarão bordas personalizadas (não geradas pelo SO) - veja as capturas de tela para maiores detalhes.
 
-Características:
+CustomTitlebar é um projeto cuja classe principal (NMainWindow) deriva da classe QMainWindow da biblioteca Qt.
+Ao derivar a janela principal da classe NMainWindow, você poderá desenvolver programas que usarão bordas personalizadas (não geradas pelo SO) - veja as capturas de tela para maiores detalhes.
+
+## Suporte e Documentação
+
+Você poderá obter o suporte e documentação para o uso deste projeto em sua [página no site da Nintersoft](https://www.nintersoft.com/portfolio/custom-titlebar/) ou ainda em sua [página de documentação](https://docwiki.nintersoft.com/custom-titlebar/).
+
+## Características:
 - Redimensionável (100% funcional)
 - Botões personalizáveis
 - Atualização do título da janela (QMainWindow::setWindowTitle(QString)) funcionando;
@@ -24,26 +30,31 @@ Mauro Mascarenhas - Nintersoft.
 
 ## EN
 # CustomTitlebar
-CustomTitlebar is a base program which uses Qt library and can be used to develop other bordeless programs that needs custom borders (the frame is not dynamically generated by the OS), - have a look at the screenshots folder for more details.
 
-Features:
+CustomTitlebar is a project where the main class (NMainWindow) inherits its properties from QMainWindow, which is part of Qt Library.
+Inheriting the main window from the NMainWindow class, will allow you to develop programs which will use customized borders (not generated by the OS) - have a look at the screenshots for major details.
+
+## Support and Documentation
+
+You are able to get the proper support and documentation in order to use this project on its [page at Nintersoft's website](https://www.nintersoft.com/en/portfolio/custom-titlebar/) or yet on its [documentation page](https://docwiki.nintersoft.com/en/custom-titlebar/).
+
+## Features:
 - Resizeable (100% functional)
 - BotõesCustomizable buttons
 - Window title update (QMainWindow::setWindowTitle(QString)) working properly;
 
-CustomTitlebar open source code
+## CustomTitlebar open source code
 - You can download and make some modifications in the source code, according to our Open Source Policy (by Nintersoft).
 - The licence is available in the root of the project folder.
 
-Once this project is supported by Nintersoft open source licence you either can (checked) or musn't (unchecked):
+Once this project is supported by Nintersoft open source code licence you are either allowed to (checked), or musn't (unchecked):
 - [x] Download or clone into your repository and make changes.
 - [x] Share the improvements you made in the source with the community.
 - [ ] Sell parts of the source of this project (even when already compiled).
 - [ ] Use your own logo or slogan.
 - [x] You must read the rest of the licence in the root of the project folder and know better your rights and obligations.
 
-
-If you clone this directory into yours, please put a linkback to our webpage and the correct references for out team, also leaving the original README in your repository.
+If you clone this directory into yours, please insert a linkback to our webpage and the correct references to our team, also leaving the original README in your repository.
 
 Graciously,
 Mauro Mascarenhas - Nintersoft.

Sample Program/CustomFrameTestIn.zip

@@ -0,0 +1,42 @@
+#-------------------------------------------------
+#
+# Project created by QtCreator 2018-05-29T00:56:56
+#
+#-------------------------------------------------
+
+QT       += core gui
+
+greaterThan(QT_MAJOR_VERSION, 4): QT += widgets
+
+TARGET = CustomFrameTestIn
+TEMPLATE = app
+
+# The following define makes your compiler emit warnings if you use
+# any feature of Qt which has been marked as deprecated (the exact warnings
+# depend on your compiler). Please consult the documentation of the
+# deprecated API in order to know how to port your code away from it.
+DEFINES += QT_DEPRECATED_WARNINGS
+
+# You can also make your code fail to compile if you use deprecated APIs.
+# In order to do so, uncomment the following line.
+# You can also select to disable deprecated APIs only up to a certain version of Qt.
+#DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000    # disables all the APIs deprecated before Qt 6.0.0
+
+
+INCLUDEPATH += ./nmainwindow
+
+SOURCES += \
+        main.cpp \
+        nmainwindow/titlebar.cpp \
+        nmainwindow/nmainwindow.cpp \
+        testwindow.cpp
+
+HEADERS += \
+        nmainwindow/titlebar.h \
+        nmainwindow/nmainwindow.h \
+        testwindow.h
+
+FORMS += \
+        nmainwindow/titlebar.ui \
+        nmainwindow/nmainwindow.ui \
+        testwindow.ui

Sample Program/CustomFrameTestIn/CustomFrameTestIn.pro

@@ -0,0 +1,11 @@
+#include "testwindow.h"
+#include <QApplication>
+
+int main(int argc, char *argv[])
+{
+    QApplication a(argc, argv);
+    TestWindow w;
+    w.show();
+
+    return a.exec();
+}

Sample Program/CustomFrameTestIn/main.cpp

@@ -1,9 +1,20 @@
-#include "frmmain.h"
-#include "ui_frmmain.h"
+/*-------------------------------------------------
+#
+# Project developed by Nintersoft team
+# Developer: Mauro Mascarenhas de Araújo
+# Contact: mauro.mascarenhas@nintersoft.com
+# License: Nintersoft Open Source Code Licence
+# Date: 31 of May of 2018
+#
+------------------------------------------------- */
 
-frmMain::frmMain(QWidget *parent) :
+#include "nmainwindow.h"
+#include "ui_nmainwindow.h"
+
+NMainWindow::NMainWindow(QWidget *parent) :
     QMainWindow(parent),
-    ui(new Ui::frmMain)
+    ui(new Ui::NMainWindow),
+    RESIZE_LIMIT(2)
 {
     ui->setupUi(this);
     setWindowFlags(Qt::Widget | Qt::FramelessWindowHint);
@@ -17,37 +28,84 @@ frmMain::frmMain(QWidget *parent) :
 
     setWindowTitle("Custom Window Border");
     locked = LockMoveType::None;
+
+    ui->headerWidget->setTitleBarWidget(ui->titleBar);
+    if (ui->titleBar->mainWindow() != this)
+        ui->titleBar->setMainWindow(this);
+
+    if (this->maximumSize() == this->minimumSize())
+        setMaximizeButtonEnabled(false);
+
+    /*
+     *  End of non client area implementation
+     */
 }
 
-frmMain::~frmMain()
+NMainWindow::~NMainWindow()
 {
     delete ui;
 }
 
-void frmMain::mousePressEvent(QMouseEvent *event)
+void NMainWindow::setCustomWidgets(QWidget *newCentralWidget, QStatusBar *newStatusBar){
+    setCustomStatusBar(newStatusBar);
+    setNewCentralWidget(newCentralWidget);
+}
+
+void NMainWindow::setCustomStatusBar(QStatusBar *newStatusBar){
+    if (!newStatusBar) return;
+    newStatusBar->installEventFilter(this);
+    newStatusBar->setMouseTracking(true);
+}
+
+void NMainWindow::setNewCentralWidget(QWidget *newCentralWidget){
+    if (!newCentralWidget) return;
+    newCentralWidget->installEventFilter(this);
+    newCentralWidget->setMouseTracking(true);
+
+    if (newCentralWidget->layout())
+        newCentralWidget->layout()->setContentsMargins(10, 0, 10, 0);
+}
+
+void NMainWindow::setCloseButtonEnabled(bool enable){
+    ui->titleBar->setCloseButtonEnabled(enable);
+}
+
+void NMainWindow::setMaximizeButtonEnabled(bool enable){
+    ui->titleBar->setMaximizeButtonEnabled(enable);
+}
+
+void NMainWindow::setMinimizeButtonEnabled(bool enable){
+    ui->titleBar->setMinimizeButtonEnabled(enable);
+}
+
+/*
+ * GUI Functions (do not change them, unless its really necessary)
+ */
+
+void NMainWindow::mousePressEvent(QMouseEvent *event)
 {
     if(event->button() == Qt::LeftButton)
     {
-        int x = event->x(), y = event->y(), bottom = this->height() - 5, right = this->width() - 5;
-        if (x < 5 && y < 5){
+        int x = event->x(), y = event->y(), bottom = this->height() - RESIZE_LIMIT, right = this->width() - RESIZE_LIMIT;
+        if (x < RESIZE_LIMIT && y < RESIZE_LIMIT){
             posCursor = event->globalPos() - this->geometry().topLeft();
             locked = LockMoveType::TopLeft;
         }
-        else if (x < 5 && y > bottom){
+        else if (x < RESIZE_LIMIT && y > bottom){
             posCursor = event->globalPos() - this->geometry().bottomLeft();
             locked = LockMoveType::BottomLeft;
         }
-        else if (x > right && y < 5){
+        else if (x > right && y < RESIZE_LIMIT){
             posCursor = event->globalPos() - this->geometry().topRight();
             locked = LockMoveType::TopRight;
         }
         else if (x > right && y > bottom){
             posCursor = event->globalPos() - this->geometry().bottomRight();
             locked = LockMoveType::BottomRight;
         }
-        else if (x < 5 || y < 5){
+        else if (x < RESIZE_LIMIT || y < RESIZE_LIMIT){
             posCursor = event->globalPos() - this->geometry().topLeft();
-            locked = x < 5 ? LockMoveType::Left : LockMoveType::Top;
+            locked = x < RESIZE_LIMIT ? LockMoveType::Left : LockMoveType::Top;
         }
         else if (x > right || y > bottom){
             posCursor = event->globalPos() - this->geometry().bottomRight();
@@ -57,7 +115,7 @@ void frmMain::mousePressEvent(QMouseEvent *event)
     }
 }
 
-void frmMain::undefMouseMoveEvent(QObject* object, QMouseEvent* event){
+void NMainWindow::undefMouseMoveEvent(QObject* object, QMouseEvent* event){
     if (locked != LockMoveType::None){
         switch (locked) {
         case LockMoveType::TopLeft:
@@ -96,49 +154,49 @@ void frmMain::undefMouseMoveEvent(QObject* object, QMouseEvent* event){
         return;
     }
 
-    int x = event->x(), y = event->y(), right = this->width() - 5;
+    int x = event->x(), y = event->y(), right = this->width() - RESIZE_LIMIT;
     if (object->objectName() == "statusBar"){
-        if (x < 5 && y > 14){
+        if (x < RESIZE_LIMIT && y > (19 - RESIZE_LIMIT)){
             this->setCursor(QCursor(Qt::SizeBDiagCursor));
             return;
         }
-        else if (x > right && y > 14){
+        else if (x > right && y > (19 - RESIZE_LIMIT)){
             this->setCursor(QCursor(Qt::SizeFDiagCursor));
             return;
         }
-        else if (y > 14){
+        else if (y > (19 - RESIZE_LIMIT)){
             this->setCursor(QCursor(Qt::SizeVerCursor));
             return;
         }
     }
     else if (object->objectName() == "titleBar"){
-        if (x < 5 && y < 5){
+        if (x < RESIZE_LIMIT && y < RESIZE_LIMIT){
             this->setCursor(QCursor(Qt::SizeFDiagCursor));
             return;
         }
-        if (x > right && y < 5){
+        if (x > right && y < RESIZE_LIMIT){
             this->setCursor(QCursor(Qt::SizeBDiagCursor));
             return;
         }
-        else if (y < 5){
+        else if (y < RESIZE_LIMIT){
             this->setCursor(QCursor(Qt::SizeVerCursor));
             return;
         }
     }
-    if (x < 5 || x > right){
+    if (x < RESIZE_LIMIT || x > right){
         this->setCursor(QCursor(Qt::SizeHorCursor));
     }
     else {
         this->setCursor(QCursor(Qt::ArrowCursor));
     }
 }
 
-void frmMain::mouseReleaseEvent(QMouseEvent *event){
+void NMainWindow::mouseReleaseEvent(QMouseEvent *event){
     locked = LockMoveType::None;
     event->accept();
 }
 
-bool frmMain::eventFilter(QObject* object, QEvent* event)
+bool NMainWindow::eventFilter(QObject* object, QEvent* event)
 {
     if(event->type() == QEvent::MouseMove)
         undefMouseMoveEvent(object, static_cast<QMouseEvent*>(event));

frmmain.cpp …mFrameTestIn/nmainwindow/nmainwindow.cppfrmmain.cpp renamed to Sample Program/CustomFrameTestIn/nmainwindow/nmainwindow.cpp frmmain.cpp renamed to Sample Program/CustomFrameTestIn/nmainwindow/nmainwindow.cpp

@@ -0,0 +1,67 @@
+/*-------------------------------------------------
+#
+# Project developed by Nintersoft team
+# Developer: Mauro Mascarenhas de Araújo
+# Contact: mauro.mascarenhas@nintersoft.com
+# License: Nintersoft Open Source Code Licence
+# Date: 31 of May of 2018
+#
+------------------------------------------------- */
+
+#ifndef NMAINWINDOW_H
+#define NMAINWINDOW_H
+
+#include <QMainWindow>
+#include <QMouseEvent>
+#include <QPoint>
+#include <QDebug>
+
+#include "titlebar.h"
+
+namespace Ui {
+class NMainWindow;
+}
+
+class NMainWindow : public QMainWindow
+{
+    Q_OBJECT
+
+public:
+    explicit NMainWindow(QWidget *parent = 0);
+    ~NMainWindow();
+
+    void setCustomWidgets(QWidget *newCentralWidget, QStatusBar *newStatusBar);
+    void setNewCentralWidget(QWidget *newCentralWidget);
+    void setCustomStatusBar(QStatusBar *newStatusBar);
+
+    void setCloseButtonEnabled(bool enable);
+    void setMaximizeButtonEnabled(bool enable);
+    void setMinimizeButtonEnabled(bool enable);
+
+protected:
+    void mousePressEvent(QMouseEvent *event);
+    void mouseReleaseEvent(QMouseEvent *event);
+    void undefMouseMoveEvent(QObject *object, QMouseEvent* event);
+    bool eventFilter(QObject *watched, QEvent *event);
+    
+    enum LockMoveType{
+        Left,
+        Right,
+        Top,
+        Bottom,
+        TopLeft,
+        TopRight,
+        BottomLeft,
+        BottomRight,
+        None
+    };
+
+private:
+    Ui::NMainWindow *ui;
+    const int RESIZE_LIMIT;
+
+    QPoint posCursor;
+    LockMoveType locked;
+};
+
+#endif // NMAINWINDOW_H