Contents

• Public Functions
• Reimplemented Public Functions
• Reimplemented Protected Functions
• Protected Slots
• Detailed Description

Detailed Description

TheQProxyStyle class is a convenience class that simplifies dynamically overridingQStyle elements.

AQProxyStyle wraps aQStyle (usually the default system style) for the purpose of dynamically overriding painting or other specific style behavior.

The following example shows how to override the shortcut underline behavior on any platform:

#include "textedit.h"#include <QApplication>#include <QProxyStyle>class MyProxyStyle :publicQProxyStyle{public:int styleHint(StyleHint hint,constQStyleOption*option=0,constQWidget*widget=0,QStyleHintReturn*returnData=0)const    {if (hint==QStyle::SH_UnderlineShortcut)return0;returnQProxyStyle::styleHint(hint, option, widget, returnData);    }};int main(int argc,char**argv){    Q_INIT_RESOURCE(textedit);QApplication a(argc, argv);    a.setStyle(new MyProxyStyle);    TextEdit mw;    mw.resize(700,800);    mw.show();//...}

Warning: Thecommon styles provided by Qt will respect this hint, because they callQStyle::proxy(), but there is no guarantee thatQStyle::proxy() will be called for user defined or system controlled styles. It would not work on a Mac, for example, where menus are handled by the operating system.

Member Function Documentation

QProxyStyle::QProxyStyle(QStyle * style = 0)

Constructs aQProxyStyle object for overriding behavior instyle or in the current applicationstyle ifstyle is 0 (default). Normallystyle is 0, because you want to override behavior in the system style.

Ownership ofstyle is transferred toQProxyStyle.

QProxyStyle::~QProxyStyle()

Destroys theQProxyStyle object.

QStyle * QProxyStyle::baseStyle() const

Returns the proxy base style object. If no base style is set on the proxy style,QProxyStyle will create an instance of the application style instead.

See alsosetBaseStyle() andQStyle.

[virtual]void QProxyStyle::drawComplexControl(ComplexControl control, constQStyleOptionComplex * option,QPainter * painter, constQWidget * widget = 0) const

Reimplemented fromQStyle::drawComplexControl().

[virtual]void QProxyStyle::drawControl(ControlElement element, constQStyleOption * option,QPainter * painter, constQWidget * widget = 0) const

Reimplemented fromQStyle::drawControl().

[virtual]void QProxyStyle::drawItemPixmap(QPainter * painter, constQRect & rect,int alignment, constQPixmap & pixmap) const

Reimplemented fromQStyle::drawItemPixmap().

[virtual]void QProxyStyle::drawItemText(QPainter * painter, constQRect & rect,int flags, constQPalette & pal,bool enabled, constQString & text,QPalette::ColorRole textRole = QPalette::NoRole) const

Reimplemented fromQStyle::drawItemText().

[virtual]void QProxyStyle::drawPrimitive(PrimitiveElement element, constQStyleOption * option,QPainter * painter, constQWidget * widget = 0) const

Reimplemented fromQStyle::drawPrimitive().

[virtual protected]bool QProxyStyle::event(QEvent * e)

Reimplemented fromQObject::event().

[virtual]QPixmap QProxyStyle::generatedIconPixmap(QIcon::Mode iconMode, constQPixmap & pixmap, constQStyleOption * opt) const

Reimplemented fromQStyle::generatedIconPixmap().

[virtual]SubControl QProxyStyle::hitTestComplexControl(ComplexControl control, constQStyleOptionComplex * option, constQPoint & pos, constQWidget * widget = 0) const

Reimplemented fromQStyle::hitTestComplexControl().

[virtual]QRect QProxyStyle::itemPixmapRect(constQRect & r,int flags, constQPixmap & pixmap) const

Reimplemented fromQStyle::itemPixmapRect().

[virtual]QRect QProxyStyle::itemTextRect(constQFontMetrics & fm, constQRect & r,int flags,bool enabled, constQString & text) const

Reimplemented fromQStyle::itemTextRect().

[protected slot]int QProxyStyle::layoutSpacingImplementation(QSizePolicy::ControlType control1,QSizePolicy::ControlType control2,Qt::Orientation orientation, constQStyleOption * option = 0, constQWidget * widget = 0) const

This slot is called bylayoutSpacing() to determine the spacing that should be used betweencontrol1 andcontrol2 in a layout.orientation specifies whether the controls are laid out side by side or stacked vertically. Theoption parameter can be used to pass extra information about the parent widget. Thewidget parameter is optional and can also be used ifoption is 0.

The default implementation returns -1.

See alsolayoutSpacing() andcombinedLayoutSpacing().

[virtual]int QProxyStyle::pixelMetric(PixelMetric metric, constQStyleOption * option = 0, constQWidget * widget = 0) const

Reimplemented fromQStyle::pixelMetric().

[virtual]void QProxyStyle::polish(QWidget * widget)

Reimplemented fromQStyle::polish().

[virtual]void QProxyStyle::polish(QPalette & pal)

Reimplemented fromQStyle::polish().

[virtual]void QProxyStyle::polish(QApplication * app)

Reimplemented fromQStyle::polish().

void QProxyStyle::setBaseStyle(QStyle * style)

Sets the base style that should be proxied.

Ownership ofstyle is transferred toQProxyStyle.

If style is zero, a desktop-dependant style will be assigned automatically.

See alsobaseStyle().

[virtual]QSize QProxyStyle::sizeFromContents(ContentsType type, constQStyleOption * option, constQSize & size, constQWidget * widget) const

Reimplemented fromQStyle::sizeFromContents().

[protected slot]QIcon QProxyStyle::standardIconImplementation(StandardPixmap standardIcon, constQStyleOption * option, constQWidget * widget) const

Returns an icon for the givenstandardIcon.

Reimplement this slot to provide your own icons in aQStyle subclass. Theoption argument can be used to pass extra information required to find the appropriate icon. Thewidget argument is optional and can also be used to help find the icon.

Note:Because of binary compatibility constraints,standardIcon() introduced in Qt 4.1 is not virtual. Therefore it must dynamically detect and callthis slot. This default implementation simply callsstandardIcon() with the given parameters.

See alsostandardIcon().

[virtual]QPalette QProxyStyle::standardPalette() const

Reimplemented fromQStyle::standardPalette().

[virtual]QPixmap QProxyStyle::standardPixmap(StandardPixmap standardPixmap, constQStyleOption * opt, constQWidget * widget = 0) const

Reimplemented fromQStyle::standardPixmap().

[virtual]int QProxyStyle::styleHint(StyleHint hint, constQStyleOption * option = 0, constQWidget * widget = 0,QStyleHintReturn * returnData = 0) const

Reimplemented fromQStyle::styleHint().

[virtual]QRect QProxyStyle::subControlRect(ComplexControl cc, constQStyleOptionComplex * option,SubControl sc, constQWidget * widget) const

Reimplemented fromQStyle::subControlRect().

[virtual]QRect QProxyStyle::subElementRect(SubElement element, constQStyleOption * option, constQWidget * widget) const

Reimplemented fromQStyle::subElementRect().

[virtual]void QProxyStyle::unpolish(QWidget * widget)

Reimplemented fromQStyle::unpolish().

[virtual]void QProxyStyle::unpolish(QApplication * app)

Reimplemented fromQStyle::unpolish().