Refactoring / partitioning of Qt GUI widget source file

Question

I have created a traditional Qt (widget based) GUI, something like this: MainWindow::MainWindow(parent) : QMainWindow(parent)

This is designed by Qt Creator as forms (mainwindow.ui), aka Design Mode. Everything works fine. But the GUI code with all widgets, initializing the corresponding models, and functionality gets quit long. I'd like to refactor to small units. Things I came up with:

I tried using specialized (derived) widgets. Example: A created MyTableView::QTableView contains the specialized model, as well the signal/slot handling between model and widget. This reduces the amount of code in MainWindow. However, I do loose the capability to design the GUI via Qt Creator's Design mode.
The best thing I came up with so far, was to spilt the source code (multiple cpp files). It still represents one class, but less code in one file.

So, how could I better partition my GUI class?

Is "MyTableView" in your original project (the long one that you want to clean up) or is it in your "best refactored" project? Why do you think the derived widget "loose the ability to design GUI in Qt designer"? — Martian Puss, Mar 06 '14 at 03:12
I was not aware of the "register with QtDesigner" issue (elephant's answer). Need to get into this topic, but when I just derive from QTableView, I cannot not add such widgets via designer. MyTableView was one trial to get smaller classes, but I have given the idea up, as it was stopping me from using it in Design Mode. As just said, maybe the missing part was the registration. — Horst Walter, Mar 06 '14 at 10:40

score 1 · Answer 1 · answered Mar 06 '14 at 04:56

1

You could create your own Qt widgets and register them with QtDesigner. Then will you be able to use them on forms as mere QLabels and friends. See this link

answered Mar 06 '14 at 04:56

elephant

149
1
6

score 1 · Answer 2 · answered Mar 06 '14 at 09:01

In a recent project, we had pretty restrictive uncoupling requirements (especially not to be too strongly linked to Qt). What we used to do based on MVC-like pattern is:

Implement a controller that controls the application workflow
Add a GUI "adapter" class per screen that communicates with the controller. Let's say HomeScreen class, SecondScreen class
Each adapter class contains a given number of widgets: TimelineWidget, FormWidget
Each widget is composed of a ui member (Ui::TimelineWidget ui) that is generated from a .ui file designd with Qt designer

Note that this structure might not be suitable for small projects.

score 1 · Accepted Answer · answered Mar 06 '14 at 11:31

If you still want to uncouple the initialization of widgets by derived widgets, you can use "promote to ..." option in Qt designer. Steps:

class MyTableView : public QTableView {}, and so initialization of table view is moved to the constructor of MyTableView.
In Qt Designer, open the ui form (MainWidow.ui), and drag and drop a QTableView on it;
Right mouse click the QTableView, in prompt menu, there's a "promote to" option, open it
In the dialog of "promoting widget", specify your custom QTableView's class name and header file, say MyTableView, MyTableView.h. This step requires existing custom class and header file.

Borrowed a picture:

Promotion was the missing part between my solution 1 and enabling it for Design Mode. Thanks! — Horst Walter, Mar 06 '14 at 12:33
Complementary info on promoted widgets and style sheets: http://stackoverflow.com/q/6533091/356726 — Horst Walter, Mar 07 '14 at 00:22

Refactoring / partitioning of Qt GUI widget source file

3 Answers3