diff --git a/src/libtomahawk/utils/stylehelper.h b/src/libtomahawk/utils/stylehelper.h index 2fa371725..9f69fe6f6 100644 --- a/src/libtomahawk/utils/stylehelper.h +++ b/src/libtomahawk/utils/stylehelper.h @@ -27,20 +27,42 @@ class QPalette; class QPainter; +/** + * \class StyleHelper + * \brief A static class that contains Tomahawk's styling details (colors, etc). + */ class StyleHelper { public: + /** + * Our header BG is a two color gradient. This is the upper color. + */ static QColor headerUpperColor(); + /** + * Our header BG is a two color gradient. This is the lower color. + */ static QColor headerLowerColor(); + /** + * The color of text on a Header. + */ static QColor headerTextColor(); + /** + * The widget highlight color for headers + */ static QColor headerHighlightColor(); + /** + * Draws a header background on a painter with the specified rectangle + */ static void horizontalHeader(QPainter *painter, const QRect &rect); + /** + * Draws a styled arrow that looks good on a Header (from qwindowstyle.cpp) + * \copyright { Licensed under the GPL v3+ + * Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies). + * Contact: Nokia Corporation (qt-info@nokia.com) } + */ static void drawArrow(QStyle::PrimitiveElement, QPainter *painter, const QStyleOption *opt); -private: - static QColor m_baseColor; - static QColor m_requestedBaseColor; }; #endif // STYLEHELPER_H diff --git a/src/libtomahawk/widgets/HeaderLabel.h b/src/libtomahawk/widgets/HeaderLabel.h index 3333dabf6..8a53c2f78 100644 --- a/src/libtomahawk/widgets/HeaderLabel.h +++ b/src/libtomahawk/widgets/HeaderLabel.h @@ -23,6 +23,10 @@ #include "dllmacro.h" +/** + * \class HeaderLabel + * \brief A styled label for use in headers. + */ class DLLEXPORT HeaderLabel : public QLabel { Q_OBJECT diff --git a/src/libtomahawk/widgets/HeaderWidget.h b/src/libtomahawk/widgets/HeaderWidget.h index bdaef5060..be13a276c 100644 --- a/src/libtomahawk/widgets/HeaderWidget.h +++ b/src/libtomahawk/widgets/HeaderWidget.h @@ -25,6 +25,11 @@ #include "dllmacro.h" + +/** + * \class HeaderWidget + * \brief A QWidget subclass with a background for use in headers. + */ class DLLEXPORT HeaderWidget : public QWidget { Q_OBJECT diff --git a/src/libtomahawk/widgets/combobox.h b/src/libtomahawk/widgets/combobox.h index df701ab95..2cf672a6d 100644 --- a/src/libtomahawk/widgets/combobox.h +++ b/src/libtomahawk/widgets/combobox.h @@ -24,6 +24,10 @@ #include "dllmacro.h" +/** + * \class ComboBox + * \brief A styled combo box that has a header background. + */ class DLLEXPORT ComboBox : public QComboBox { Q_OBJECT diff --git a/src/libtomahawk/widgets/whatshotwidget.h b/src/libtomahawk/widgets/whatshotwidget.h index 2cfb79312..b27198b12 100644 --- a/src/libtomahawk/widgets/whatshotwidget.h +++ b/src/libtomahawk/widgets/whatshotwidget.h @@ -43,6 +43,10 @@ namespace Ui class WhatsHotWidget; } +/** + * \class + * \brief The tomahawk page that shows music charts. + */ class DLLEXPORT WhatsHotWidget : public QWidget, public Tomahawk::ViewPage { Q_OBJECT