mirror of
https://github.com/qTox/qTox.git
synced 2024-03-22 14:00:36 +08:00
67e9aeec63
The qTox Project is not associated with the Tox Project in any way, with the exception of "qTox" using the Tox Projet's "toxcore" collection of libraries. In particular, the Tox Projet does not own copyright over the qTox Project's "qTox" collection of software, source code, and assets. The qTox Project's assets are under the sole copyright of the qTox contributors, and no partiular rights are granted to the Tox Project.
111 lines
4.8 KiB
C++
111 lines
4.8 KiB
C++
/*
|
|
Copyright © 2015 by The qTox Project
|
|
|
|
This file is part of qTox, a Qt-based graphical interface for Tox.
|
|
|
|
qTox is libre software: you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
qTox is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with qTox. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
|
|
#ifndef GUI_H
|
|
#define GUI_H
|
|
|
|
#include <QObject>
|
|
|
|
class QWidget;
|
|
|
|
/// Abstracts the GUI from the target backend (AndroidGUI, DesktopGUI, ...)
|
|
/// All the functions exposed here are thread-safe
|
|
/// Prefer calling this class to calling a GUI backend directly
|
|
class GUI : public QObject
|
|
{
|
|
Q_OBJECT
|
|
public:
|
|
static GUI& getInstance();
|
|
/// Returns the main QWidget* of the application
|
|
static QWidget* getMainWidget();
|
|
/// Clear the GUI's contact list
|
|
static void clearContacts();
|
|
/// Will enable or disable the GUI.
|
|
/// A disabled GUI can't be interacted with by the user
|
|
static void setEnabled(bool state);
|
|
/// Change the title of the main window
|
|
/// This is usually always visible to the user
|
|
static void setWindowTitle(const QString& title);
|
|
/// Reloads the application theme and redraw the window
|
|
static void reloadTheme();
|
|
/// Show some text to the user, for example in a message box
|
|
static void showInfo(const QString& title, const QString& msg);
|
|
/// Show a warning to the user, for example in a message box
|
|
static void showWarning(const QString& title, const QString& msg);
|
|
/// Show an error to the user, for example in a message box
|
|
static void showError(const QString& title, const QString& msg);
|
|
/// Asks the user a question, for example in a message box.
|
|
/// If warning is true, we will use a special warning style.
|
|
/// Returns the answer.
|
|
static bool askQuestion(const QString& title, const QString& msg,
|
|
bool defaultAns = false, bool warning = true,
|
|
bool yesno = true);
|
|
/// Asks the user a question, for example in a message box.
|
|
/// The text for the displayed buttons can be specified.
|
|
/// If warning is true, we will use a special warning style.
|
|
/// Returns the answer.
|
|
static bool askQuestion(const QString& title, const QString& msg,
|
|
const QString& button1, const QString& button2,
|
|
bool defaultAns = false, bool warning = true);
|
|
/// Asks the user to input text and returns the answer.
|
|
/// The interface is equivalent to QInputDialog::getItem()
|
|
static QString itemInputDialog(QWidget * parent, const QString & title,
|
|
const QString & label, const QStringList & items,
|
|
int current = 0, bool editable = true, bool * ok = 0,
|
|
Qt::WindowFlags flags = 0,
|
|
Qt::InputMethodHints hints = Qt::ImhNone);
|
|
/// Asks the user to answer a password
|
|
/// cancel is the text on the cancel button and body
|
|
/// is descriptive text that will be shown to the user
|
|
static QString passwordDialog(const QString& cancel, const QString& body);
|
|
|
|
signals:
|
|
/// Emitted when the GUI is resized on supported platforms
|
|
/// Guaranteed to work on desktop platforms
|
|
void resized();
|
|
|
|
private:
|
|
explicit GUI(QObject *parent = 0);
|
|
|
|
// Private implementation, those must be called from the GUI thread
|
|
private slots:
|
|
void _clearContacts();
|
|
void _setEnabled(bool state);
|
|
void _setWindowTitle(const QString& title);
|
|
void _reloadTheme();
|
|
void _showInfo(const QString& title, const QString& msg);
|
|
void _showWarning(const QString& title, const QString& msg);
|
|
void _showError(const QString& title, const QString& msg);
|
|
bool _askQuestion(const QString& title, const QString& msg,
|
|
bool defaultAns = false, bool warning = true,
|
|
bool yesno = true);
|
|
bool _askQuestion(const QString& title, const QString& msg,
|
|
const QString& button1, const QString& button2,
|
|
bool defaultAns = false, bool warning = true);
|
|
QString _itemInputDialog(QWidget * parent, const QString & title,
|
|
const QString & label, const QStringList & items,
|
|
int current = 0, bool editable = true, bool * ok = 0,
|
|
Qt::WindowFlags flags = 0,
|
|
Qt::InputMethodHints inputMethodHints = Qt::ImhNone);
|
|
QString _passwordDialog(const QString& cancel, const QString& body);
|
|
};
|
|
|
|
#endif // GUI_H
|