/****************************************************************************
**
** Copyright (C) 2008-2010 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (developer.feedback@nokia.com)
**
** This file is part of the HbCore module of the UI Extensions for Mobile.
**
** GNU Lesser General Public License Usage
** This file may be used under the terms of the GNU Lesser General Public
** License version 2.1 as published by the Free Software Foundation and
** appearing in the file LICENSE.LGPL included in the packaging of this file.
** Please review the following information to ensure the GNU Lesser General
** Public License version 2.1 requirements will be met:
** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Nokia gives you certain additional
** rights. These rights are described in the Nokia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** If you have questions regarding the use of this file, please contact
** Nokia at developer.feedback@nokia.com.
**
****************************************************************************/
/*!
@stable
@hbcore
\class HbColorScheme
\brief HbColorScheme class is used to query colors from theme.
HbColorScheme class has a single static functions to query colors from current theme. If
color is not found from current theme then it is queried from base theme.
\sa QColor HbColorScheme::color(const QString &colorRole)
This method is appropriate for custom widgets which want to be consistent with standard
look and feel and be themable. For example, a custom widget may want to have background color
same as that of HbDialog. In such scenario the widget can query standard "popupbackground" color
from theme.
Following code queries color of HbTextEdit's normal text color and applies it to a text item.
\code
QColor col = HbColorScheme::color("qtc_textedit_normal");
if (col.isValid()) {
mytextitem->setTextColor(col);
}
\endcode
Note:
- Theming framework schedules redraw for all graphics items when theme changes, so widgets
need not to do it again by themselves. It is sufficient that widgets make sure that colors being
used to paint the graphics item has been updated in the handler of HbEvent::ThemeChanged.
- The color-role may contain information about the state also, e.g. "qtc_button_pressed".
*/
/*!
* \fn QColor HbColorScheme::color(const QString &colorRole))
* This function returns value of \a colorRole.
*
* See class level document for detailed example
*.
*/
#include <hbcolorscheme.h>
#include <hbtheme.h>
QColor HbColorScheme::color( const QString &colorRole )
{
return HbTheme::instance()->color(colorRole);
}