/****************************************************************************

**

** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

** All rights reserved.

** Contact: Nokia Corporation (qt-info@nokia.com)

**

** This file is part of the QtGui module of the Qt Toolkit.

**

** $QT_BEGIN_LICENSE:LGPL$

** No Commercial Usage

** This file contains pre-release code and may not be distributed.

** You may use this file in accordance with the terms and conditions

** contained in the Technology Preview License Agreement accompanying

** this package.

**

** GNU Lesser General Public License Usage

** Alternatively, 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 qt-info@nokia.com.

**

**

**

**

**

**

**

**

** $QT_END_LICENSE$

**

****************************************************************************/

#ifndef QSTYLE_H

#define QSTYLE_H

#include <QtCore/qobject.h>

#include <QtCore/qrect.h>

#include <QtCore/qsize.h>

#include <QtGui/qicon.h>

#include <QtGui/qpixmap.h>

#include <QtGui/qpalette.h>

#include <QtGui/qsizepolicy.h>

QT_BEGIN_HEADER

QT_BEGIN_NAMESPACE

QT_MODULE(Gui)

class QAction;

class QDebug;

class QTab;

class QFontMetrics;

class QStyleHintReturn;

class QStyleOption;

class QStyleOptionComplex;

class QStylePrivate;

class Q_GUI_EXPORT QStyle : public QObject

{

    Q_OBJECT

    Q_DECLARE_PRIVATE(QStyle)

protected:

    QStyle(QStylePrivate &dd);

public:

    QStyle();

    virtual ~QStyle();

    virtual void polish(QWidget *);

    virtual void unpolish(QWidget *);

    virtual void polish(QApplication *);

    virtual void unpolish(QApplication *);

    virtual void polish(QPalette &);

    virtual QRect itemTextRect(const QFontMetrics &fm, const QRect &r,

                           int flags, bool enabled,

                           const QString &text) const;

    virtual QRect itemPixmapRect(const QRect &r, int flags, const QPixmap &pixmap) const;

    virtual void drawItemText(QPainter *painter, const QRect &rect,

                              int flags, const QPalette &pal, bool enabled,

                              const QString &text, QPalette::ColorRole textRole = QPalette::NoRole) const;

    virtual void drawItemPixmap(QPainter *painter, const QRect &rect,

                                int alignment, const QPixmap &pixmap) const;

    virtual QPalette standardPalette() const;

    enum StateFlag {

        State_None =                0x00000000,

#ifdef QT3_SUPPORT

        State_Default =             State_None,

#endif

        State_Enabled =             0x00000001,

        State_Raised =              0x00000002,

        State_Sunken =              0x00000004,

        State_Off =                 0x00000008,

        State_NoChange =            0x00000010,

        State_On =                  0x00000020,

        State_DownArrow =           0x00000040,

        State_Horizontal =          0x00000080,

        State_HasFocus =            0x00000100,

        State_Top =                 0x00000200,

        State_Bottom =              0x00000400,

        State_FocusAtBorder =       0x00000800,

        State_AutoRaise =           0x00001000,

        State_MouseOver =           0x00002000,

        State_UpArrow =             0x00004000,

        State_Selected =            0x00008000,

        State_Active =              0x00010000,

        State_Window =              0x00020000,

        State_Open =                0x00040000,

        State_Children =            0x00080000,

        State_Item =                0x00100000,

        State_Sibling =             0x00200000,

        State_Editing =             0x00400000,

        State_KeyboardFocusChange = 0x00800000,

#ifdef QT_KEYPAD_NAVIGATION

        State_HasEditFocus =        0x01000000,

#endif

        State_ReadOnly =            0x02000000,

        State_Small =               0x04000000,

        State_Mini =                0x08000000

    };

    Q_DECLARE_FLAGS(State, StateFlag)

#ifdef QT3_SUPPORT

    typedef State SFlags;

#endif

    enum PrimitiveElement {

        PE_Q3CheckListController,

        PE_Q3CheckListExclusiveIndicator,

        PE_Q3CheckListIndicator,

        PE_Q3DockWindowSeparator,

        PE_Q3Separator,

        PE_Frame,

        PE_FrameDefaultButton,

        PE_FrameDockWidget,

        PE_FrameFocusRect,

        PE_FrameGroupBox,

        PE_FrameLineEdit,

        PE_FrameMenu,

        PE_FrameStatusBar, // obsolete

        PE_FrameStatusBarItem = PE_FrameStatusBar,

        PE_FrameTabWidget,

        PE_FrameWindow,

        PE_FrameButtonBevel,

        PE_FrameButtonTool,

        PE_FrameTabBarBase,

        PE_PanelButtonCommand,

        PE_PanelButtonBevel,

        PE_PanelButtonTool,

        PE_PanelMenuBar,

        PE_PanelToolBar,

        PE_PanelLineEdit,

        PE_IndicatorArrowDown,

        PE_IndicatorArrowLeft,

        PE_IndicatorArrowRight,

        PE_IndicatorArrowUp,

        PE_IndicatorBranch,

        PE_IndicatorButtonDropDown,

        PE_IndicatorViewItemCheck,

        PE_IndicatorItemViewItemCheck = PE_IndicatorViewItemCheck,

        PE_IndicatorCheckBox,

        PE_IndicatorDockWidgetResizeHandle,

        PE_IndicatorHeaderArrow,

        PE_IndicatorMenuCheckMark,

        PE_IndicatorProgressChunk,

        PE_IndicatorRadioButton,

        PE_IndicatorSpinDown,

        PE_IndicatorSpinMinus,

        PE_IndicatorSpinPlus,

        PE_IndicatorSpinUp,

        PE_IndicatorToolBarHandle,

        PE_IndicatorToolBarSeparator,

        PE_PanelTipLabel,

        PE_IndicatorTabTear,

        PE_PanelScrollAreaCorner,

        PE_Widget,

        PE_IndicatorColumnViewArrow,

        PE_IndicatorItemViewItemDrop,

        PE_PanelItemViewItem,

        PE_PanelItemViewRow, // ### Qt 5: remove

        PE_PanelStatusBar,

        PE_IndicatorTabClose,

        PE_PanelMenu,

        // do not add any values below/greater this

        PE_CustomBase = 0xf000000

    };

    virtual void drawPrimitive(PrimitiveElement pe, const QStyleOption *opt, QPainter *p,

                               const QWidget *w = 0) const = 0;

    enum ControlElement {

        CE_PushButton,

        CE_PushButtonBevel,

        CE_PushButtonLabel,

        CE_CheckBox,

        CE_CheckBoxLabel,

        CE_RadioButton,

        CE_RadioButtonLabel,

        CE_TabBarTab,

        CE_TabBarTabShape,

        CE_TabBarTabLabel,

        CE_ProgressBar,

        CE_ProgressBarGroove,

        CE_ProgressBarContents,

        CE_ProgressBarLabel,

        CE_MenuItem,

        CE_MenuScroller,

        CE_MenuVMargin,

        CE_MenuHMargin,

        CE_MenuTearoff,

        CE_MenuEmptyArea,

        CE_MenuBarItem,

        CE_MenuBarEmptyArea,

        CE_ToolButtonLabel,

        CE_Header,

        CE_HeaderSection,

        CE_HeaderLabel,

        CE_Q3DockWindowEmptyArea,

        CE_ToolBoxTab,

        CE_SizeGrip,

        CE_Splitter,

        CE_RubberBand,

        CE_DockWidgetTitle,

        CE_ScrollBarAddLine,

        CE_ScrollBarSubLine,

        CE_ScrollBarAddPage,

        CE_ScrollBarSubPage,

        CE_ScrollBarSlider,

        CE_ScrollBarFirst,

        CE_ScrollBarLast,

        CE_FocusFrame,

        CE_ComboBoxLabel,

        CE_ToolBar,

        CE_ToolBoxTabShape,

        CE_ToolBoxTabLabel,

        CE_HeaderEmptyArea,

        CE_ColumnViewGrip,

        CE_ItemViewItem,

        CE_ShapedFrame,

        // do not add any values below/greater than this

        CE_CustomBase = 0xf0000000

    };

    virtual void drawControl(ControlElement element, const QStyleOption *opt, QPainter *p,

                             const QWidget *w = 0) const = 0;

    enum SubElement {

        SE_PushButtonContents,

        SE_PushButtonFocusRect,

        SE_CheckBoxIndicator,

        SE_CheckBoxContents,

        SE_CheckBoxFocusRect,

        SE_CheckBoxClickRect,

        SE_RadioButtonIndicator,

        SE_RadioButtonContents,

        SE_RadioButtonFocusRect,

        SE_RadioButtonClickRect,

        SE_ComboBoxFocusRect,

        SE_SliderFocusRect,

        SE_Q3DockWindowHandleRect,

        SE_ProgressBarGroove,

        SE_ProgressBarContents,

        SE_ProgressBarLabel,

        // ### Qt 5: These values are unused; eliminate them

        SE_DialogButtonAccept,

        SE_DialogButtonReject,

        SE_DialogButtonApply,

        SE_DialogButtonHelp,

        SE_DialogButtonAll,

        SE_DialogButtonAbort,

        SE_DialogButtonIgnore,

        SE_DialogButtonRetry,

        SE_DialogButtonCustom,

        SE_ToolBoxTabContents,

        SE_HeaderLabel,

        SE_HeaderArrow,

        SE_TabWidgetTabBar,

        SE_TabWidgetTabPane,

        SE_TabWidgetTabContents,

        SE_TabWidgetLeftCorner,

        SE_TabWidgetRightCorner,

        SE_ViewItemCheckIndicator,

        SE_ItemViewItemCheckIndicator = SE_ViewItemCheckIndicator,

        SE_TabBarTearIndicator,

        SE_TreeViewDisclosureItem,

        SE_LineEditContents,

        SE_FrameContents,

        SE_DockWidgetCloseButton,

        SE_DockWidgetFloatButton,

        SE_DockWidgetTitleBarText,

        SE_DockWidgetIcon,

        SE_CheckBoxLayoutItem,

        SE_ComboBoxLayoutItem,

        SE_DateTimeEditLayoutItem,

        SE_DialogButtonBoxLayoutItem, // ### remove

        SE_LabelLayoutItem,

        SE_ProgressBarLayoutItem,

        SE_PushButtonLayoutItem,

        SE_RadioButtonLayoutItem,

        SE_SliderLayoutItem,

        SE_SpinBoxLayoutItem,

        SE_ToolButtonLayoutItem,

        SE_FrameLayoutItem,

        SE_GroupBoxLayoutItem,

        SE_TabWidgetLayoutItem,

        SE_ItemViewItemDecoration,

        SE_ItemViewItemText,

        SE_ItemViewItemFocusRect,

        SE_TabBarTabLeftButton,

        SE_TabBarTabRightButton,

        SE_TabBarTabText,

        SE_ShapedFrameContents,

        SE_ToolBarHandle,

        // do not add any values below/greater than this

        SE_CustomBase = 0xf0000000

    };

    virtual QRect subElementRect(SubElement subElement, const QStyleOption *option,

                                 const QWidget *widget = 0) const = 0;

    enum ComplexControl {

        CC_SpinBox,

        CC_ComboBox,

        CC_ScrollBar,

        CC_Slider,

        CC_ToolButton,

        CC_TitleBar,

        CC_Q3ListView,

        CC_Dial,

        CC_GroupBox,

        CC_MdiControls,

        // do not add any values below/greater than this

        CC_CustomBase = 0xf0000000

    };

    enum SubControl {

        SC_None =                  0x00000000,

        SC_ScrollBarAddLine =      0x00000001,

        SC_ScrollBarSubLine =      0x00000002,

        SC_ScrollBarAddPage =      0x00000004,

        SC_ScrollBarSubPage =      0x00000008,

        SC_ScrollBarFirst =        0x00000010,

        SC_ScrollBarLast =         0x00000020,

        SC_ScrollBarSlider =       0x00000040,

        SC_ScrollBarGroove =       0x00000080,

        SC_SpinBoxUp =             0x00000001,

        SC_SpinBoxDown =           0x00000002,

        SC_SpinBoxFrame =          0x00000004,

        SC_SpinBoxEditField =      0x00000008,

        SC_ComboBoxFrame =         0x00000001,

        SC_ComboBoxEditField =     0x00000002,

        SC_ComboBoxArrow =         0x00000004,

        SC_ComboBoxListBoxPopup =  0x00000008,

        SC_SliderGroove =          0x00000001,

        SC_SliderHandle =          0x00000002,

        SC_SliderTickmarks =       0x00000004,

        SC_ToolButton =            0x00000001,

        SC_ToolButtonMenu =        0x00000002,

        SC_TitleBarSysMenu =       0x00000001,

        SC_TitleBarMinButton =     0x00000002,

        SC_TitleBarMaxButton =     0x00000004,

        SC_TitleBarCloseButton =   0x00000008,

        SC_TitleBarNormalButton =  0x00000010,

        SC_TitleBarShadeButton =   0x00000020,

        SC_TitleBarUnshadeButton = 0x00000040,

        SC_TitleBarContextHelpButton = 0x00000080,

        SC_TitleBarLabel =         0x00000100,

        SC_Q3ListView =            0x00000001,

        SC_Q3ListViewBranch =      0x00000002,

        SC_Q3ListViewExpand =      0x00000004,

        SC_DialGroove =            0x00000001,

        SC_DialHandle =            0x00000002,

        SC_DialTickmarks =         0x00000004,

        SC_GroupBoxCheckBox =      0x00000001,

        SC_GroupBoxLabel =         0x00000002,

        SC_GroupBoxContents =      0x00000004,

        SC_GroupBoxFrame =         0x00000008,

        SC_MdiMinButton     =      0x00000001,

        SC_MdiNormalButton  =      0x00000002,

        SC_MdiCloseButton   =      0x00000004,

        SC_CustomBase =            0xf0000000,

        SC_All =                   0xffffffff

    };

    Q_DECLARE_FLAGS(SubControls, SubControl)

#ifdef QT3_SUPPORT

    typedef SubControls SCFlags;

#endif

    virtual void drawComplexControl(ComplexControl cc, const QStyleOptionComplex *opt, QPainter *p,

                                    const QWidget *widget = 0) const = 0;

    virtual SubControl hitTestComplexControl(ComplexControl cc, const QStyleOptionComplex *opt,

                                             const QPoint &pt, const QWidget *widget = 0) const = 0;

    virtual QRect subControlRect(ComplexControl cc, const QStyleOptionComplex *opt,

                                 SubControl sc, const QWidget *widget = 0) const = 0;

    enum PixelMetric {

        PM_ButtonMargin,

        PM_ButtonDefaultIndicator,

        PM_MenuButtonIndicator,

        PM_ButtonShiftHorizontal,

        PM_ButtonShiftVertical,

        PM_DefaultFrameWidth,

        PM_SpinBoxFrameWidth,

        PM_ComboBoxFrameWidth,

        PM_MaximumDragDistance,

        PM_ScrollBarExtent,

        PM_ScrollBarSliderMin,

        PM_SliderThickness,             // total slider thickness

        PM_SliderControlThickness,      // thickness of the business part

        PM_SliderLength,                // total length of slider

        PM_SliderTickmarkOffset,        //

        PM_SliderSpaceAvailable,        // available space for slider to move

        PM_DockWidgetSeparatorExtent,

        PM_DockWidgetHandleExtent,

        PM_DockWidgetFrameWidth,

        PM_TabBarTabOverlap,

        PM_TabBarTabHSpace,

        PM_TabBarTabVSpace,

        PM_TabBarBaseHeight,

        PM_TabBarBaseOverlap,

        PM_ProgressBarChunkWidth,

        PM_SplitterWidth,

        PM_TitleBarHeight,

        PM_MenuScrollerHeight,

        PM_MenuHMargin,

        PM_MenuVMargin,

        PM_MenuPanelWidth,

        PM_MenuTearoffHeight,

        PM_MenuDesktopFrameWidth,

        PM_MenuBarPanelWidth,

        PM_MenuBarItemSpacing,

        PM_MenuBarVMargin,

        PM_MenuBarHMargin,

        PM_IndicatorWidth,

        PM_IndicatorHeight,

        PM_ExclusiveIndicatorWidth,

        PM_ExclusiveIndicatorHeight,

        PM_CheckListButtonSize,

        PM_CheckListControllerSize,