widgetutils.h

Go to the documentation of this file.

//  ************************************************************************************************
//
//  qt-mvvm: Model-view-view-model framework for large GUI applications
//
//! @file      mvvm/view/mvvm/widgets/widgetutils.h
//! @brief     Defines class CLASS?
//!
//! @homepage  http://www.bornagainproject.org
//! @license   GNU General Public License v3 or higher (see COPYING)
//! @copyright Forschungszentrum Jülich GmbH 2020
//! @authors   Gennady Pospelov et al, Scientific Computing Group at MLZ (see CITATION, AUTHORS)
//
//  ************************************************************************************************
 
#ifndef BORNAGAIN_MVVM_VIEW_MVVM_WIDGETS_WIDGETUTILS_H
#define BORNAGAIN_MVVM_VIEW_MVVM_WIDGETS_WIDGETUTILS_H
 
#include "mvvm/view_export.h"
#include <QString>
#include <QStringList>
#include <string>
#include <vector>
 
class QColor;
class QSize;
class QMainWindow;
class QLabel;
 
namespace ModelView {
 
//! Collection of various widget-related utils.
 
namespace Utils {
 
//! Returns random color.
MVVM_VIEW_EXPORT QColor RandomColor();
 
//! Returns the name of random color.
MVVM_VIEW_EXPORT std::string RandomNamedColor();
 
//! Returns true if it is Windows.
MVVM_VIEW_EXPORT bool IsWindowsHost();
 
//! Returns true if it is Mac.
MVVM_VIEW_EXPORT bool IsMacHost();
 
//! Returns true if it is Linux.
MVVM_VIEW_EXPORT bool IsLinuxHost();
 
//! Returns a string where Linux path to the file is striped using '~/'.
MVVM_VIEW_EXPORT QString WithTildeHomePath(const QString& path);
 
//! Returns a title composed from last part of project path, and `is_modified` flag.
MVVM_VIEW_EXPORT QString ProjectWindowTitle(const QString& project_dir, bool is_modified);
 
//! Returns width of the letter 'M' deduced from current font metrics.
MVVM_VIEW_EXPORT int WidthOfLetterM();
 
//! Returns height of the letter 'M' deduced from current font metrics.
MVVM_VIEW_EXPORT int HeightOfLetterM();
 
//! Returns size corresponding to actual size of letter `M` basing on current font metrics.
MVVM_VIEW_EXPORT QSize SizeOfLetterM();
 
//! Returns size in points of default system font.
MVVM_VIEW_EXPORT int SystemPointSize();
 
//! Finds main window.
MVVM_VIEW_EXPORT QMainWindow* FindMainWindow();
 
//! Returns text wrapped into 'href' tag to provide clickable links in QLabel.
//! Example: <a href="tag">text</a>, if 'tag' is empty, 'text' will be used instead.
MVVM_VIEW_EXPORT QString ClickableText(const QString& text, const QString& tag = {});
 
//! Set label's font size to system font size scaled by given factor.
MVVM_VIEW_EXPORT void ScaleLabelFont(QLabel* label, double scale);
 
//! Converts vector of strings to QStringList.
MVVM_VIEW_EXPORT QStringList toStringList(const std::vector<std::string>& vec);
 
//! Converts vector of strings to QStringList.
MVVM_VIEW_EXPORT std::vector<std::string> fromStringList(const QStringList& string_list);
 
//! Converts vector of strings to byte array.
MVVM_VIEW_EXPORT QByteArray serialize(const QStringList& data);
 
//! Converts byte array to vector of strings.
MVVM_VIEW_EXPORT QStringList deserialize(const QByteArray& byteArray);
 
} // namespace Utils
 
} // namespace ModelView
 
#endif // BORNAGAIN_MVVM_VIEW_MVVM_WIDGETS_WIDGETUTILS_H