1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
/*
* SPDX-FileCopyrightText: 2017 Kitsune Ral <kitsune-ral@users.sf.net>
*
* SPDX-License-Identifier: LGPL-2.1-or-later
*/
#pragma once
#include <QtCore/QFlags>
#include <QtWidgets/QDialog>
#include <QtWidgets/QDialogButtonBox>
#include <QtWidgets/QVBoxLayout>
class QAbstractButton;
class QLabel;
class Dialog : public QDialog
{
Q_OBJECT
public:
enum UseStatusLine { NoStatusLine, StatusLine };
static constexpr auto NoExtraButtons = QDialogButtonBox::NoButton;
explicit Dialog(const QString& title, QWidget* parent = nullptr,
UseStatusLine useStatusLine = NoStatusLine, const QString& applyTitle = {},
QDialogButtonBox::StandardButtons addButtons = QDialogButtonBox::Reset);
explicit Dialog(const QString& title, QDialogButtonBox::StandardButtons setButtons,
QWidget* parent = nullptr, UseStatusLine useStatusLine = NoStatusLine);
/// Create and add a layout of the given type
/*! This creates a new layout object and adds it to the bottom of
* the dialog client area (i.e., above the button box). */
template <typename LayoutT>
LayoutT* addLayout(int stretch = 0)
{
auto l = new LayoutT;
addLayout(l, stretch);
return l;
}
/// Add a layout to the bottom of the dialog's client area
void addLayout(QLayout* l, int stretch = 0);
/// Add a widget to the bottom of the dialog's client area
void addWidget(QWidget* w, int stretch = 0, Qt::Alignment alignment = {});
static QLabel* makeBuddyLabel(QString labelText, QWidget* field);
QPushButton* button(QDialogButtonBox::StandardButton which);
using QWidget::setTabOrder;
#if QT_VERSION < QT_VERSION_CHECK(6, 6, 0)
static void setTabOrder(std::initializer_list<QWidget*> widgets);
#endif
public slots:
/// Show or raise the dialog
void reactivate();
/// Set the status line of the dialog window
void setStatusMessage(const QString& msg);
/// Return to the dialog after a failed apply
void applyFailed(const QString& errorMessage);
protected:
/// (Re-)Load data in the dialog
/*! \sa buttonClicked */
virtual void load() {}
/// Check data in the dialog before accepting
/*! \sa apply, buttonClicked */
virtual bool validate() { return true; }
/// Apply changes and close the dialog
/*!
* This method is invoked upon clicking the "apply" button (by default
* it's the one with `AcceptRole`), if validate() returned true.
* \sa buttonClicked, validate
*/
virtual void apply() { accept(); }
/// React to a click of a button in the dialog box
/*!
* This virtual function is invoked every time one of push buttons
* in the dialog button box is clicked; it defines how the dialog reacts
* to each button. By default, it calls validate() and, if it succeeds,
* apply() on buttons with `AcceptRole`; cancels the dialog on
* `RejectRole`; and reloads the fields on `ResetRole`. Override this
* method to change this behaviour.
* \sa validate, apply, reject, load
*/
virtual void buttonClicked(QAbstractButton* button);
QDialogButtonBox* buttonBox() const { return buttons; }
QLabel* statusLine() const { return statusLabel; }
void setPendingApplyMessage(const QString& msg) { pendingApplyMessage = msg; }
private:
QString pendingApplyMessage;
QLabel* statusLabel;
QDialogButtonBox* buttons;
QVBoxLayout outerLayout;
};
|
