QProxyStyle Class Reference

The QProxyStyle class is a convenience class that simplifies dynamically overriding QStyle elements. More...

#include <qproxystyle.h>

Inheritance diagram for QProxyStyle:

Collaboration diagram for QProxyStyle:

Public Member Functions
	QProxyStyle (QStyle *style=nullptr)
	Constructs a QProxyStyle object for overriding behavior in the specified style, or in the default native \l{QApplication::style()} {style} if style is not specified.
	QProxyStyle (const QString &key)
	Constructs a QProxyStyle object for overriding behavior in the base style specified by style key, or in the current \l{QApplication::style()}{application style} if the specified style key is unrecognized.
	~QProxyStyle ()
	Destroys the QProxyStyle object.
QStyle *	baseStyle () const
	Returns the proxy base style object.
void	setBaseStyle (QStyle *style)
	Sets the base style that should be proxied.
void	drawPrimitive (PrimitiveElement element, const QStyleOption *option, QPainter *painter, const QWidget *widget=nullptr) const override
	\reimp
void	drawControl (ControlElement element, const QStyleOption *option, QPainter *painter, const QWidget *widget=nullptr) const override
	\reimp
void	drawComplexControl (ComplexControl control, const QStyleOptionComplex *option, QPainter *painter, const QWidget *widget=nullptr) const override
	\reimp
void	drawItemText (QPainter *painter, const QRect &rect, int flags, const QPalette &pal, bool enabled, const QString &text, QPalette::ColorRole textRole=QPalette::NoRole) const override
	\reimp
virtual void	drawItemPixmap (QPainter *painter, const QRect &rect, int alignment, const QPixmap &pixmap) const override
	\reimp
QSize	sizeFromContents (ContentsType type, const QStyleOption *option, const QSize &size, const QWidget *widget) const override
	\reimp
QRect	subElementRect (SubElement element, const QStyleOption *option, const QWidget *widget) const override
	\reimp
QRect	subControlRect (ComplexControl cc, const QStyleOptionComplex *opt, SubControl sc, const QWidget *widget) const override
	\reimp
QRect	itemTextRect (const QFontMetrics &fm, const QRect &r, int flags, bool enabled, const QString &text) const override
	\reimp
QRect	itemPixmapRect (const QRect &r, int flags, const QPixmap &pixmap) const override
	\reimp
SubControl	hitTestComplexControl (ComplexControl control, const QStyleOptionComplex *option, const QPoint &pos, const QWidget *widget=nullptr) const override
	\reimp
int	styleHint (StyleHint hint, const QStyleOption *option=nullptr, const QWidget *widget=nullptr, QStyleHintReturn *returnData=nullptr) const override
	\reimp
int	pixelMetric (PixelMetric metric, const QStyleOption *option=nullptr, const QWidget *widget=nullptr) const override
	\reimp
int	layoutSpacing (QSizePolicy::ControlType control1, QSizePolicy::ControlType control2, Qt::Orientation orientation, const QStyleOption *option=nullptr, const QWidget *widget=nullptr) const override
	This slot is called by layoutSpacing() to determine the spacing that should be used between control1 and control2 in a layout.
QIcon	standardIcon (StandardPixmap standardIcon, const QStyleOption *option=nullptr, const QWidget *widget=nullptr) const override
	Returns an icon for the given standardIcon.
QPixmap	standardPixmap (StandardPixmap standardPixmap, const QStyleOption *opt, const QWidget *widget=nullptr) const override
	\reimp
QPixmap	generatedIconPixmap (QIcon::Mode iconMode, const QPixmap &pixmap, const QStyleOption *opt) const override
	\reimp
QPalette	standardPalette () const override
	\reimp
void	polish (QWidget *widget) override
	\reimp
void	polish (QPalette &pal) override
	\reimp
void	polish (QApplication *app) override
	\reimp
void	unpolish (QWidget *widget) override
	\reimp
void	unpolish (QApplication *app) override
	\reimp
Public Member Functions inherited from QCommonStyle
	QCommonStyle ()
	Constructs a QCommonStyle.
	~QCommonStyle ()
	Destroys the style.
Public Member Functions inherited from QStyle
	QStyle ()
	Constructs a style object.
virtual	~QStyle ()
	Destroys the style object.
QString	name () const
	Returns the name of the style.
int	combinedLayoutSpacing (QSizePolicy::ControlTypes controls1, QSizePolicy::ControlTypes controls2, Qt::Orientation orientation, QStyleOption *option=nullptr, QWidget *widget=nullptr) const
const QStyle *	proxy () const
Public Member Functions inherited from QObject
Q_INVOKABLE	QObject (QObject *parent=nullptr)
	Constructs an object with parent object parent.
virtual	~QObject ()
	Destroys the object, deleting all its child objects.
virtual bool	eventFilter (QObject *watched, QEvent *event)
	Filters events if this object has been installed as an event filter for the watched object.
QString	objectName () const
Q_WEAK_OVERLOAD void	setObjectName (const QString &name)
	Sets the object's name to name.
void	setObjectName (QAnyStringView name)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
QBindable< QString >	bindableObjectName ()
bool	isWidgetType () const
	Returns true if the object is a widget; otherwise returns false.
bool	isWindowType () const
	Returns true if the object is a window; otherwise returns false.
bool	isQuickItemType () const
	Returns true if the object is a QQuickItem; otherwise returns false.
bool	signalsBlocked () const noexcept
	Returns true if signals are blocked; otherwise returns false.
bool	blockSignals (bool b) noexcept
	If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it).
QThread *	thread () const
	Returns the thread in which the object lives.
bool	moveToThread (QThread *thread QT6_DECL_NEW_OVERLOAD_TAIL)
	Changes the thread affinity for this object and its children and returns true on success.
int	startTimer (int interval, Qt::TimerType timerType=Qt::CoarseTimer)
	This is an overloaded function that will start a timer of type timerType and a timeout of interval milliseconds.
int	startTimer (std::chrono::nanoseconds time, Qt::TimerType timerType=Qt::CoarseTimer)
void	killTimer (int id)
	Kills the timer with timer identifier, id.
void	killTimer (Qt::TimerId id)
template<typename T >
T	findChild (QAnyStringView aName, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
	Returns the child of this object that can be cast into type T and that is called name, or \nullptr if there is no such object.
template<typename T >
QList< T >	findChildren (QAnyStringView aName, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
	Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects.
template<typename T >
T	findChild (Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
template<typename T >
QList< T >	findChildren (Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
const QObjectList &	children () const
	Returns a list of child objects.
void	setParent (QObject *parent)
	Makes the object a child of parent.
void	installEventFilter (QObject *filterObj)
	Installs an event filter filterObj on this object.
void	removeEventFilter (QObject *obj)
	Removes an event filter object obj from this object.
QMetaObject::Connection	connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const
bool	disconnect (const char *signal=nullptr, const QObject *receiver=nullptr, const char *member=nullptr) const
bool	disconnect (const QObject *receiver, const char *member=nullptr) const
void	dumpObjectTree () const
	Dumps a tree of children to the debug output.
void	dumpObjectInfo () const
	Dumps information about signal connections, etc.
bool	setProperty (const char *name, const QVariant &value)
	Sets the value of the object's name property to value.
bool	setProperty (const char *name, QVariant &&value)
QVariant	property (const char *name) const
	Returns the value of the object's name property.
QList< QByteArray >	dynamicPropertyNames () const
QBindingStorage *	bindingStorage ()
const QBindingStorage *	bindingStorage () const
QObject *	parent () const
	Returns a pointer to the parent object.
bool	inherits (const char *classname) const
	Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false.

Protected Member Functions
bool	event (QEvent *e) override
	\reimp
Protected Member Functions inherited from QCommonStyle
	QCommonStyle (QCommonStylePrivate &dd)
Protected Member Functions inherited from QStyle
	QStyle (QStylePrivate &dd)
Protected Member Functions inherited from QObject
QObject *	sender () const
	Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns \nullptr.
int	senderSignalIndex () const
int	receivers (const char *signal) const
	Returns the number of receivers connected to the signal.
bool	isSignalConnected (const QMetaMethod &signal) const
virtual void	timerEvent (QTimerEvent *event)
	This event handler can be reimplemented in a subclass to receive timer events for the object.
virtual void	childEvent (QChildEvent *event)
	This event handler can be reimplemented in a subclass to receive child events.
virtual void	customEvent (QEvent *event)
	This event handler can be reimplemented in a subclass to receive custom events.
virtual void	connectNotify (const QMetaMethod &signal)
virtual void	disconnectNotify (const QMetaMethod &signal)
	QObject (QObjectPrivate &dd, QObject *parent=nullptr)

Additional Inherited Members
Public Types inherited from QStyle
enum	StateFlag {   State_None = 0x00000000 , 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 , State_ReadOnly = 0x02000000 , State_Small = 0x04000000 , State_Mini = 0x08000000 }
	This enum describes flags that are used when drawing primitive elements. More...
enum	PrimitiveElement {   PE_Frame , PE_FrameDefaultButton , PE_FrameDockWidget , PE_FrameFocusRect ,   PE_FrameGroupBox , PE_FrameLineEdit , PE_FrameMenu , PE_FrameStatusBarItem ,   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_IndicatorItemViewItemCheck , 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_IndicatorTabTearLeft = PE_IndicatorTabTear , PE_PanelScrollAreaCorner , PE_Widget , PE_IndicatorColumnViewArrow ,   PE_IndicatorItemViewItemDrop , PE_PanelItemViewItem , PE_PanelItemViewRow , PE_PanelStatusBar ,   PE_IndicatorTabClose , PE_PanelMenu , PE_IndicatorTabTearRight , PE_CustomBase = 0xf000000 }
	This enum describes the various primitive elements. More...
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_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 , CE_CustomBase = 0xf0000000 }
	This enum represents a control element. More...
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_ProgressBarGroove , SE_ProgressBarContents , SE_ProgressBarLabel , SE_ToolBoxTabContents ,   SE_HeaderLabel , SE_HeaderArrow , SE_TabWidgetTabBar , SE_TabWidgetTabPane ,   SE_TabWidgetTabContents , SE_TabWidgetLeftCorner , SE_TabWidgetRightCorner , SE_ItemViewItemCheckIndicator ,   SE_TabBarTearIndicator , SE_TabBarTearIndicatorLeft = SE_TabBarTearIndicator , SE_TreeViewDisclosureItem , SE_LineEditContents ,   SE_FrameContents , SE_DockWidgetCloseButton , SE_DockWidgetFloatButton , SE_DockWidgetTitleBarText ,   SE_DockWidgetIcon , SE_CheckBoxLayoutItem , SE_ComboBoxLayoutItem , SE_DateTimeEditLayoutItem ,   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 , SE_TabBarScrollLeftButton , SE_TabBarScrollRightButton ,   SE_TabBarTearIndicatorRight , SE_PushButtonBevel , SE_CustomBase = 0xf0000000 }
	This enum represents a sub-area of a widget. More...
enum	ComplexControl {   CC_SpinBox , CC_ComboBox , CC_ScrollBar , CC_Slider ,   CC_ToolButton , CC_TitleBar , CC_Dial , CC_GroupBox ,   CC_MdiControls , CC_CustomBase = 0xf0000000 }
	This enum describes the available complex controls. More...
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_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 }
	This enum describes the available sub controls. More...
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 ,   PM_SliderControlThickness , PM_SliderLength , PM_SliderTickmarkOffset , PM_SliderSpaceAvailable ,   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_MdiSubWindowFrameWidth = 44 , PM_MdiSubWindowMinimizedWidth , PM_HeaderMargin ,   PM_HeaderMarkSize , PM_HeaderGripMargin , PM_TabBarTabShiftHorizontal , PM_TabBarTabShiftVertical ,   PM_TabBarScrollButtonWidth , PM_ToolBarFrameWidth , PM_ToolBarHandleExtent , PM_ToolBarItemSpacing ,   PM_ToolBarItemMargin , PM_ToolBarSeparatorExtent , PM_ToolBarExtensionExtent , PM_SpinBoxSliderHeight ,   PM_ToolBarIconSize , PM_ListViewIconSize , PM_IconViewIconSize , PM_SmallIconSize ,   PM_LargeIconSize , PM_FocusFrameVMargin , PM_FocusFrameHMargin , PM_ToolTipLabelFrameWidth ,   PM_CheckBoxLabelSpacing , PM_TabBarIconSize , PM_SizeGripSize , PM_DockWidgetTitleMargin ,   PM_MessageBoxIconSize , PM_ButtonIconSize , PM_DockWidgetTitleBarButtonMargin , PM_RadioButtonLabelSpacing ,   PM_LayoutLeftMargin , PM_LayoutTopMargin , PM_LayoutRightMargin , PM_LayoutBottomMargin ,   PM_LayoutHorizontalSpacing , PM_LayoutVerticalSpacing , PM_TabBar_ScrollButtonOverlap , PM_TextCursorWidth ,   PM_TabCloseIndicatorWidth , PM_TabCloseIndicatorHeight , PM_ScrollView_ScrollBarSpacing , PM_ScrollView_ScrollBarOverlap ,   PM_SubMenuOverlap , PM_TreeViewIndentation , PM_HeaderDefaultSectionSizeHorizontal , PM_HeaderDefaultSectionSizeVertical ,   PM_TitleBarButtonIconSize , PM_TitleBarButtonSize , PM_LineEditIconSize , PM_LineEditIconMargin ,   PM_CustomBase = 0xf0000000 }
	This enum describes the various available pixel metrics. More...
enum	ContentsType {   CT_PushButton , CT_CheckBox , CT_RadioButton , CT_ToolButton ,   CT_ComboBox , CT_Splitter , CT_ProgressBar , CT_MenuItem ,   CT_MenuBarItem , CT_MenuBar , CT_Menu , CT_TabBarTab ,   CT_Slider , CT_ScrollBar , CT_LineEdit , CT_SpinBox ,   CT_SizeGrip , CT_TabWidget , CT_DialogButtons , CT_HeaderSection ,   CT_GroupBox , CT_MdiControls , CT_ItemViewItem , CT_CustomBase = 0xf0000000 }
	This enum describes the available contents types. More...
enum	RequestSoftwareInputPanel { RSIP_OnMouseClickAndAlreadyFocused , RSIP_OnMouseClick }
	This enum describes under what circumstances a software input panel will be requested by input capable widgets. More...
enum	StyleHint {   SH_EtchDisabledText , SH_DitherDisabledText , SH_ScrollBar_MiddleClickAbsolutePosition , SH_ScrollBar_ScrollWhenPointerLeavesControl ,   SH_TabBar_SelectMouseType , SH_TabBar_Alignment , SH_Header_ArrowAlignment , SH_Slider_SnapToValue ,   SH_Slider_SloppyKeyEvents , SH_ProgressDialog_CenterCancelButton , SH_ProgressDialog_TextLabelAlignment , SH_PrintDialog_RightAlignButtons ,   SH_MainWindow_SpaceBelowMenuBar , SH_FontDialog_SelectAssociatedText , SH_Menu_AllowActiveAndDisabled , SH_Menu_SpaceActivatesItem ,   SH_Menu_SubMenuPopupDelay , SH_ScrollView_FrameOnlyAroundContents , SH_MenuBar_AltKeyNavigation , SH_ComboBox_ListMouseTracking ,   SH_Menu_MouseTracking , SH_MenuBar_MouseTracking , SH_ItemView_ChangeHighlightOnFocus , SH_Widget_ShareActivation ,   SH_Workspace_FillSpaceOnMaximize , SH_ComboBox_Popup , SH_TitleBar_NoBorder , SH_Slider_StopMouseOverSlider ,   SH_BlinkCursorWhenTextSelected , SH_RichText_FullWidthSelection , SH_Menu_Scrollable , SH_GroupBox_TextLabelVerticalAlignment ,   SH_GroupBox_TextLabelColor , SH_Menu_SloppySubMenus , SH_Table_GridLineColor , SH_LineEdit_PasswordCharacter ,   SH_DialogButtons_DefaultButton , SH_ToolBox_SelectedPageTitleBold , SH_TabBar_PreferNoArrows , SH_ScrollBar_LeftClickAbsolutePosition ,   SH_ListViewExpand_SelectMouseType , SH_UnderlineShortcut , SH_SpinBox_AnimateButton , SH_SpinBox_KeyPressAutoRepeatRate ,   SH_SpinBox_ClickAutoRepeatRate , SH_Menu_FillScreenWithScroll , SH_ToolTipLabel_Opacity , SH_DrawMenuBarSeparator ,   SH_TitleBar_ModifyNotification , SH_Button_FocusPolicy , SH_MessageBox_UseBorderForButtonSpacing , SH_TitleBar_AutoRaise ,   SH_ToolButton_PopupDelay , SH_FocusFrame_Mask , SH_RubberBand_Mask , SH_WindowFrame_Mask ,   SH_SpinControls_DisableOnBounds , SH_Dial_BackgroundRole , SH_ComboBox_LayoutDirection , SH_ItemView_EllipsisLocation ,   SH_ItemView_ShowDecorationSelected , SH_ItemView_ActivateItemOnSingleClick , SH_ScrollBar_ContextMenu , SH_ScrollBar_RollBetweenButtons ,   SH_Slider_AbsoluteSetButtons , SH_Slider_PageSetButtons , SH_Menu_KeyboardSearch , SH_TabBar_ElideMode ,   SH_DialogButtonLayout , SH_ComboBox_PopupFrameStyle , SH_MessageBox_TextInteractionFlags , SH_DialogButtonBox_ButtonsHaveIcons ,   SH_MessageBox_CenterButtons , SH_Menu_SelectionWrap , SH_ItemView_MovementWithoutUpdatingSelection , SH_ToolTip_Mask ,   SH_FocusFrame_AboveWidget , SH_TextControl_FocusIndicatorTextCharFormat , SH_WizardStyle , SH_ItemView_ArrowKeysNavigateIntoChildren ,   SH_Menu_Mask , SH_Menu_FlashTriggeredItem , SH_Menu_FadeOutOnHide , SH_SpinBox_ClickAutoRepeatThreshold ,   SH_ItemView_PaintAlternatingRowColorsForEmptyArea , SH_FormLayoutWrapPolicy , SH_TabWidget_DefaultTabPosition , SH_ToolBar_Movable ,   SH_FormLayoutFieldGrowthPolicy , SH_FormLayoutFormAlignment , SH_FormLayoutLabelAlignment , SH_ItemView_DrawDelegateFrame ,   SH_TabBar_CloseButtonPosition , SH_DockWidget_ButtonsHaveFrame , SH_ToolButtonStyle , SH_RequestSoftwareInputPanel ,   SH_ScrollBar_Transient , SH_Menu_SupportsSections , SH_ToolTip_WakeUpDelay , SH_ToolTip_FallAsleepDelay ,   SH_Widget_Animate , SH_Splitter_OpaqueResize , SH_ComboBox_UseNativePopup , SH_LineEdit_PasswordMaskDelay ,   SH_TabBar_ChangeCurrentDelay , SH_Menu_SubMenuUniDirection , SH_Menu_SubMenuUniDirectionFailCount , SH_Menu_SubMenuSloppySelectOtherActions ,   SH_Menu_SubMenuSloppyCloseTimeout , SH_Menu_SubMenuResetWhenReenteringParent , SH_Menu_SubMenuDontStartSloppyOnLeave , SH_ItemView_ScrollMode ,   SH_TitleBar_ShowToolTipsOnButtons , SH_Widget_Animation_Duration , SH_ComboBox_AllowWheelScrolling , SH_SpinBox_ButtonsInsideFrame ,   SH_SpinBox_StepModifier , SH_TabBar_AllowWheelScrolling , SH_Table_AlwaysDrawLeftTopGridLines , SH_SpinBox_SelectOnStep ,   SH_CustomBase = 0xf0000000 }
	This enum describes the available style hints. More...
enum	StandardPixmap {   SP_TitleBarMenuButton , SP_TitleBarMinButton , SP_TitleBarMaxButton , SP_TitleBarCloseButton ,   SP_TitleBarNormalButton , SP_TitleBarShadeButton , SP_TitleBarUnshadeButton , SP_TitleBarContextHelpButton ,   SP_DockWidgetCloseButton , SP_MessageBoxInformation , SP_MessageBoxWarning , SP_MessageBoxCritical ,   SP_MessageBoxQuestion , SP_DesktopIcon , SP_TrashIcon , SP_ComputerIcon ,   SP_DriveFDIcon , SP_DriveHDIcon , SP_DriveCDIcon , SP_DriveDVDIcon ,   SP_DriveNetIcon , SP_DirOpenIcon , SP_DirClosedIcon , SP_DirLinkIcon ,   SP_DirLinkOpenIcon , SP_FileIcon , SP_FileLinkIcon , SP_ToolBarHorizontalExtensionButton ,   SP_ToolBarVerticalExtensionButton , SP_FileDialogStart , SP_FileDialogEnd , SP_FileDialogToParent ,   SP_FileDialogNewFolder , SP_FileDialogDetailedView , SP_FileDialogInfoView , SP_FileDialogContentsView ,   SP_FileDialogListView , SP_FileDialogBack , SP_DirIcon , SP_DialogOkButton ,   SP_DialogCancelButton , SP_DialogHelpButton , SP_DialogOpenButton , SP_DialogSaveButton ,   SP_DialogCloseButton , SP_DialogApplyButton , SP_DialogResetButton , SP_DialogDiscardButton ,   SP_DialogYesButton , SP_DialogNoButton , SP_ArrowUp , SP_ArrowDown ,   SP_ArrowLeft , SP_ArrowRight , SP_ArrowBack , SP_ArrowForward ,   SP_DirHomeIcon , SP_CommandLink , SP_VistaShield , SP_BrowserReload ,   SP_BrowserStop , SP_MediaPlay , SP_MediaStop , SP_MediaPause ,   SP_MediaSkipForward , SP_MediaSkipBackward , SP_MediaSeekForward , SP_MediaSeekBackward ,   SP_MediaVolume , SP_MediaVolumeMuted , SP_LineEditClearButton , SP_DialogYesToAllButton ,   SP_DialogNoToAllButton , SP_DialogSaveAllButton , SP_DialogAbortButton , SP_DialogRetryButton ,   SP_DialogIgnoreButton , SP_RestoreDefaultsButton , SP_TabCloseButton , NStandardPixmap ,   SP_CustomBase = 0xf0000000 }
	This enum describes the available standard pixmaps. More...
Public Slots inherited from QObject
void	deleteLater ()
	\threadsafe
Signals inherited from QObject
void	destroyed (QObject *=nullptr)
	This signal is emitted immediately before the object obj is destroyed, after any instances of QPointer have been notified, and cannot be blocked.
void	objectNameChanged (const QString &objectName, QPrivateSignal)
	This signal is emitted after the object's name has been changed.
Static Public Member Functions inherited from QStyle
static QRect	visualRect (Qt::LayoutDirection direction, const QRect &boundingRect, const QRect &logicalRect)
	Returns the given logicalRectangle converted to screen coordinates based on the specified direction.
static QPoint	visualPos (Qt::LayoutDirection direction, const QRect &boundingRect, const QPoint &logicalPos)
	Returns the given logicalPosition converted to screen coordinates based on the specified direction.
static int	sliderPositionFromValue (int min, int max, int val, int space, bool upsideDown=false)
	Converts the given logicalValue to a pixel position.
static int	sliderValueFromPosition (int min, int max, int pos, int space, bool upsideDown=false)
	Converts the given pixel position to a logical value.
static Qt::Alignment	visualAlignment (Qt::LayoutDirection direction, Qt::Alignment alignment)
	Transforms an alignment of Qt::AlignLeft or Qt::AlignRight without Qt::AlignAbsolute into Qt::AlignLeft or Qt::AlignRight with Qt::AlignAbsolute according to the layout direction.
static QRect	alignedRect (Qt::LayoutDirection direction, Qt::Alignment alignment, const QSize &size, const QRect &rectangle)
	Returns a new rectangle of the specified size that is aligned to the given rectangle according to the specified alignment and direction.
Static Public Member Functions inherited from QObject
static QMetaObject::Connection	connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection)
	\threadsafe
static QMetaObject::Connection	connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection)
template<typename Func1 , typename Func2 >
static QMetaObject::Connection	connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const typename QtPrivate::ContextTypeForFunctor< Func2 >::ContextType *context, Func2 &&slot, Qt::ConnectionType type=Qt::AutoConnection)
template<typename Func1 , typename Func2 >
static QMetaObject::Connection	connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, Func2 &&slot)
static bool	disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member)
	\threadsafe
static bool	disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member)
static bool	disconnect (const QMetaObject::Connection &)
	Disconnect a connection.
template<typename Func1 , typename Func2 >
static bool	disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const typename QtPrivate::FunctionPointer< Func2 >::Object *receiver, Func2 slot)
template<typename Func1 >
static bool	disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const QObject *receiver, void **zero)
Protected Attributes inherited from QObject
QScopedPointer< QObjectData >	d_ptr
Properties inherited from QObject
QString	objectName
	the name of this object
Related Symbols inherited from QObject
template< class T > T	qobject_cast (const QObject *object)
	Returns the given object cast to type T if the object is of type T (or of a subclass); otherwise returns \nullptr.
template< typename T > T	qFindChildqFindChildren (const QObject *obj, const QString &name)()
template< typename T > QList< T >	qFindChildrenqFindChildren (const QObject *obj, const QString &name)()
	QObjectList
	\macro Q_CLASSINFO(Name, Value)

Detailed Description

The QProxyStyle class is a convenience class that simplifies dynamically overriding QStyle elements.

Since

4.6

\inmodule QtWidgets

A QProxyStyle wraps a QStyle (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 : public QProxyStyle
{
  public:
    int styleHint(StyleHint hint, const QStyleOption *option = nullptr,
                  const QWidget *widget = nullptr, QStyleHintReturn *returnData = nullptr) const override
    {
        if (hint == QStyle::SH_UnderlineShortcut)
            return 0;
        return QProxyStyle::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: The \l {QCommonStyle} {common styles} provided by Qt will respect this hint, because they call QStyle::proxy(), but there is no guarantee that QStyle::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.

When a proxy style should be set on a specific widget only, you have to make sure to not set the proxy on the global application style which is returned by QWidget::style(). You have to create a separate custom style for the widget similar to:

...
auto proxy = new MyProxyStyle(QApplication::style()->name());
proxy->setParent(widget);   // take ownership to avoid memleak
widget->setStyle(proxy);
...

See also

QStyle

Definition at line 16 of file qproxystyle.h.

Constructor & Destructor Documentation

QProxyStyle() [1/2]

QProxyStyle::QProxyStyle

(

QStyle *

style = nullptr

)

Constructs a QProxyStyle object for overriding behavior in the specified style, or in the default native \l{QApplication::style()} {style} if style is not specified.

Ownership of style is transferred to QProxyStyle.

Definition at line 88 of file qproxystyle.cpp.

References d, and QObject::setParent().

Here is the call graph for this function:

QProxyStyle() [2/2]

QProxyStyle::QProxyStyle

(

const QString &

key

)

Constructs a QProxyStyle object for overriding behavior in the base style specified by style key, or in the current \l{QApplication::style()}{application style} if the specified style key is unrecognized.

See also

QStyleFactory::create()

Definition at line 107 of file qproxystyle.cpp.

~QProxyStyle()

QProxyStyle::~QProxyStyle

(

)

Destroys the QProxyStyle object.

Definition at line 115 of file qproxystyle.cpp.

Member Function Documentation

baseStyle()

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 also

setBaseStyle(), QStyle

Definition at line 126 of file qproxystyle.cpp.

References d.

drawComplexControl()

void QProxyStyle::drawComplexControl ( ComplexControl control, const QStyleOptionComplex * option, QPainter * painter, const QWidget * widget = nullptr ) const

overridevirtual

\reimp

Reimplemented from QCommonStyle.

Definition at line 177 of file qproxystyle.cpp.

References d, painter, and widget.

drawControl()

void QProxyStyle::drawControl ( ControlElement element, const QStyleOption * option, QPainter * painter, const QWidget * widget = nullptr ) const

overridevirtual

\reimp

Reimplemented from QCommonStyle.

Definition at line 168 of file qproxystyle.cpp.

References d, painter, and widget.

drawItemPixmap()

void QProxyStyle::drawItemPixmap ( QPainter * painter, const QRect & rect, int alignment, const QPixmap & pixmap ) const

overridevirtual

\reimp

Reimplemented from QStyle.

Definition at line 196 of file qproxystyle.cpp.

References alignment, d, painter, pixmap, and rect.

drawItemText()

void QProxyStyle::drawItemText ( QPainter * painter, const QRect & rect, int flags, const QPalette & pal, bool enabled, const QString & text, QPalette::ColorRole textRole = QPalette::NoRole ) const

overridevirtual

\reimp

Reimplemented from QStyle.

Definition at line 186 of file qproxystyle.cpp.

References d, painter, rect, and text.

drawPrimitive()

void QProxyStyle::drawPrimitive ( PrimitiveElement element, const QStyleOption * option, QPainter * painter, const QWidget * widget = nullptr ) const

overridevirtual

\reimp

Reimplemented from QCommonStyle.

Definition at line 158 of file qproxystyle.cpp.

References d, painter, and widget.

Referenced by CustomStyle::drawPrimitive().

Here is the caller graph for this function:

event()

bool QProxyStyle::event ( QEvent * e )

overrideprotectedvirtual

\reimp

Reimplemented from QObject.

Definition at line 349 of file qproxystyle.cpp.

References d, QObject::event(), QEvent::FocusIn, QEvent::FocusOut, QCoreApplication::sendEvent(), and QEvent::type().

Here is the call graph for this function:

generatedIconPixmap()

QPixmap QProxyStyle::generatedIconPixmap ( QIcon::Mode iconMode, const QPixmap & pixmap, const QStyleOption * opt ) const

overridevirtual

\reimp

Reimplemented from QCommonStyle.

Definition at line 286 of file qproxystyle.cpp.

References d, opt, and pixmap.

hitTestComplexControl()

QStyle::SubControl QProxyStyle::hitTestComplexControl ( ComplexControl control, const QStyleOptionComplex * option, const QPoint & pos, const QWidget * widget = nullptr ) const

overridevirtual

\reimp

Reimplemented from QCommonStyle.

Definition at line 250 of file qproxystyle.cpp.

References d, pos, and widget.

itemPixmapRect()

QRect QProxyStyle::itemPixmapRect ( const QRect & r, int flags, const QPixmap & pixmap ) const

overridevirtual

\reimp

Reimplemented from QStyle.

Definition at line 241 of file qproxystyle.cpp.

References d, and pixmap.

itemTextRect()

QRect QProxyStyle::itemTextRect ( const QFontMetrics & fm, const QRect & r, int flags, bool enabled, const QString & text ) const

overridevirtual

\reimp

Reimplemented from QStyle.

Definition at line 232 of file qproxystyle.cpp.

References d, and text.

layoutSpacing()

int QProxyStyle::layoutSpacing ( QSizePolicy::ControlType control1, QSizePolicy::ControlType control2, Qt::Orientation orientation, const QStyleOption * option = nullptr, const QWidget * widget = nullptr ) const

overridevirtual

This slot is called by layoutSpacing() to determine the spacing that should be used between control1 and control2 in a layout.

orientation specifies whether the controls are laid out side by side or stacked vertically. The option parameter can be used to pass extra information about the parent widget. The widget parameter is optional and can also be used if option is \nullptr.

The default implementation returns -1.

See also

combinedLayoutSpacing()

Reimplemented from QCommonStyle.

Definition at line 395 of file qproxystyle.cpp.

References d, and widget.

pixelMetric()

int QProxyStyle::pixelMetric ( PixelMetric metric, const QStyleOption * option = nullptr, const QWidget * widget = nullptr ) const

overridevirtual

\reimp

Reimplemented from QCommonStyle.

Definition at line 268 of file qproxystyle.cpp.

References d, and widget.

polish() [1/3]

void QProxyStyle::polish ( QApplication * app )

overridevirtual

\reimp

Reimplemented from QCommonStyle.

Definition at line 322 of file qproxystyle.cpp.

References app, and d.

polish() [2/3]

void QProxyStyle::polish ( QPalette & pal )

overridevirtual

\reimp

Reimplemented from QCommonStyle.

Definition at line 313 of file qproxystyle.cpp.

References d.

polish() [3/3]

void QProxyStyle::polish ( QWidget * widget )

overridevirtual

\reimp

Reimplemented from QCommonStyle.

Definition at line 304 of file qproxystyle.cpp.

References d, and widget.

setBaseStyle()

void QProxyStyle::setBaseStyle

(

QStyle *

style

)

Sets the base style that should be proxied.

Ownership of style is transferred to QProxyStyle.

If style is \nullptr, a desktop-dependent style will be assigned automatically.

Definition at line 141 of file qproxystyle.cpp.

References d.

sizeFromContents()

QSize QProxyStyle::sizeFromContents ( ContentsType type, const QStyleOption * option, const QSize & size, const QWidget * widget ) const

overridevirtual

\reimp

Reimplemented from QCommonStyle.

Definition at line 205 of file qproxystyle.cpp.

References d, and widget.

standardIcon()

QIcon QProxyStyle::standardIcon ( StandardPixmap standardIcon, const QStyleOption * option = nullptr, const QWidget * widget = nullptr ) const

overridevirtual

Returns an icon for the given standardIcon.

Reimplement this slot to provide your own icons in a QStyle subclass. The option argument can be used to pass extra information required to find the appropriate icon. The widget argument is optional and can also be used to help find the icon.

Reimplemented from QCommonStyle.

Definition at line 374 of file qproxystyle.cpp.

References d, standardIcon(), and widget.

Referenced by standardIcon().

Here is the call graph for this function:

Here is the caller graph for this function:

standardPalette()

QPalette QProxyStyle::standardPalette ( ) const

overridevirtual

\reimp

Reimplemented from QStyle.

Definition at line 295 of file qproxystyle.cpp.

References d.

standardPixmap()

QPixmap QProxyStyle::standardPixmap ( StandardPixmap standardPixmap, const QStyleOption * opt, const QWidget * widget = nullptr ) const

overridevirtual

\reimp

Reimplemented from QCommonStyle.

Definition at line 277 of file qproxystyle.cpp.

References d, opt, standardPixmap(), and widget.

Referenced by standardPixmap().

Here is the call graph for this function:

Here is the caller graph for this function:

styleHint()

int QProxyStyle::styleHint ( StyleHint hint, const QStyleOption * option = nullptr, const QWidget * widget = nullptr, QStyleHintReturn * returnData = nullptr ) const

overridevirtual

\reimp

Reimplemented from QCommonStyle.

Definition at line 259 of file qproxystyle.cpp.

References d, hint(), and widget.

Referenced by MyProxyStyle::styleHint().

Here is the call graph for this function:

Here is the caller graph for this function:

subControlRect()

QRect QProxyStyle::subControlRect ( ComplexControl cc, const QStyleOptionComplex * opt, SubControl sc, const QWidget * widget ) const

overridevirtual

\reimp

Reimplemented from QCommonStyle.

Definition at line 223 of file qproxystyle.cpp.

References d, and widget.

subElementRect()

QRect QProxyStyle::subElementRect ( SubElement element, const QStyleOption * option, const QWidget * widget ) const

overridevirtual

\reimp

Reimplemented from QCommonStyle.

Definition at line 214 of file qproxystyle.cpp.

References d, and widget.

unpolish() [1/2]

void QProxyStyle::unpolish ( QApplication * app )

overridevirtual

\reimp

Reimplemented from QCommonStyle.

Definition at line 340 of file qproxystyle.cpp.

References app, and d.

unpolish() [2/2]

void QProxyStyle::unpolish ( QWidget * widget )

overridevirtual

\reimp

Reimplemented from QCommonStyle.

Definition at line 331 of file qproxystyle.cpp.

References d, and widget.

---

The documentation for this class was generated from the following files:

• qtbase/src/widgets/styles/qproxystyle.h (05fc3aef53348fb58be6308076e000825b704e58)
• qtbase/src/widgets/styles/qproxystyle.cpp (3bb055d8ab045def265bb9b3eb4e7dff1874a093)