Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
qstyle.h
Go to the documentation of this file.
1// Copyright (C) 2016 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
3// Qt-Security score:significant reason:default
4
5#ifndef QSTYLE_H
6#define QSTYLE_H
7
8#include <QtWidgets/qtwidgetsglobal.h>
9#include <QtCore/qobject.h>
10#include <QtCore/qrect.h>
11#include <QtCore/qsize.h>
12#include <QtGui/qicon.h>
13#include <QtGui/qpixmap.h>
14#include <QtGui/qpalette.h>
15#include <QtWidgets/qsizepolicy.h>
16
17QT_BEGIN_NAMESPACE
18
19
20class QAction;
21class QDebug;
22class QTab;
23class QFontMetrics;
24class QStyleHintReturn;
25class QStyleOption;
26class QStyleOptionComplex;
27class QStylePrivate;
28
29class Q_WIDGETS_EXPORT QStyle : public QObject
30{
31 Q_OBJECT
32 Q_DECLARE_PRIVATE(QStyle)
33
34protected:
35 QStyle(QStylePrivate &dd);
36
37public:
38 QStyle();
39 virtual ~QStyle();
40
41 QString name() const;
42
43 virtual void polish(QWidget *widget);
44 virtual void unpolish(QWidget *widget);
45
46 virtual void polish(QApplication *application);
47 virtual void unpolish(QApplication *application);
48
49 virtual void polish(QPalette &palette);
50
51 virtual QRect itemTextRect(const QFontMetrics &fm, const QRect &r,
52 int flags, bool enabled,
53 const QString &text) const;
54
55 virtual QRect itemPixmapRect(const QRect &r, int flags, const QPixmap &pixmap) const;
56
57 virtual void drawItemText(QPainter *painter, const QRect &rect,
58 int flags, const QPalette &pal, bool enabled,
59 const QString &text, QPalette::ColorRole textRole = QPalette::NoRole) const;
60
61 virtual void drawItemPixmap(QPainter *painter, const QRect &rect,
62 int alignment, const QPixmap &pixmap) const;
63
64 virtual QPalette standardPalette() const;
65
66 enum StateFlag {
67 State_None = 0x00000000,
68 State_Enabled = 0x00000001,
69 State_Raised = 0x00000002,
70 State_Sunken = 0x00000004,
71 State_Off = 0x00000008,
72 State_NoChange = 0x00000010,
73 State_On = 0x00000020,
74 State_DownArrow = 0x00000040,
75 State_Horizontal = 0x00000080,
76 State_HasFocus = 0x00000100,
77 State_Top = 0x00000200,
78 State_Bottom = 0x00000400,
79 State_FocusAtBorder = 0x00000800,
80 State_AutoRaise = 0x00001000,
81 State_MouseOver = 0x00002000,
82 State_UpArrow = 0x00004000,
83 State_Selected = 0x00008000,
84 State_Active = 0x00010000,
85 State_Window = 0x00020000,
86 State_Open = 0x00040000,
87 State_Children = 0x00080000,
88 State_Item = 0x00100000,
89 State_Sibling = 0x00200000,
90#if QT_DEPRECATED_SINCE(6, 11)
91 State_Editing Q_DECL_ENUMERATOR_DEPRECATED_X("Not used and no effect since Qt 5") = 0x00400000,
92#endif
93 State_KeyboardFocusChange = 0x00800000,
94 State_ReadOnly = 0x02000000,
95 State_Small = 0x04000000,
96 State_Mini = 0x08000000
97 };
98 Q_ENUM(StateFlag)
99 Q_DECLARE_FLAGS(State, StateFlag)
100
101
102 enum PrimitiveElement {
103 PE_Frame,
104 PE_FrameDefaultButton,
105 PE_FrameDockWidget,
106 PE_FrameFocusRect,
107 PE_FrameGroupBox,
108 PE_FrameLineEdit,
109 PE_FrameMenu,
110 PE_FrameStatusBarItem,
111 PE_FrameTabWidget,
112 PE_FrameWindow,
113 PE_FrameButtonBevel,
114 PE_FrameButtonTool,
115 PE_FrameTabBarBase,
116
117 PE_PanelButtonCommand,
118 PE_PanelButtonBevel,
119 PE_PanelButtonTool,
120 PE_PanelMenuBar,
121 PE_PanelToolBar,
122 PE_PanelLineEdit,
123
124 PE_IndicatorArrowDown,
125 PE_IndicatorArrowLeft,
126 PE_IndicatorArrowRight,
127 PE_IndicatorArrowUp,
128 PE_IndicatorBranch,
129 PE_IndicatorButtonDropDown,
130 PE_IndicatorItemViewItemCheck,
131 PE_IndicatorCheckBox,
132 PE_IndicatorDockWidgetResizeHandle,
133 PE_IndicatorHeaderArrow,
134 PE_IndicatorMenuCheckMark,
135 PE_IndicatorProgressChunk,
136 PE_IndicatorRadioButton,
137 PE_IndicatorSpinDown,
138 PE_IndicatorSpinMinus,
139 PE_IndicatorSpinPlus,
140 PE_IndicatorSpinUp,
141 PE_IndicatorToolBarHandle,
142 PE_IndicatorToolBarSeparator,
143 PE_PanelTipLabel,
144 PE_IndicatorTabTear,
145 PE_IndicatorTabTearLeft = PE_IndicatorTabTear,
146 PE_PanelScrollAreaCorner,
147
148 PE_Widget,
149
150 PE_IndicatorColumnViewArrow,
151 PE_IndicatorItemViewItemDrop,
152
153 PE_PanelItemViewItem,
154 PE_PanelItemViewRow,
155
156 PE_PanelStatusBar,
157
158 PE_IndicatorTabClose,
159 PE_PanelMenu,
160
161 PE_IndicatorTabTearRight,
162
163 // do not add any values below/greater this
164 PE_CustomBase = 0xf000000
165 };
166 Q_ENUM(PrimitiveElement)
167
168 virtual void drawPrimitive(PrimitiveElement pe, const QStyleOption *opt, QPainter *p,
169 const QWidget *w = nullptr) const = 0;
170 enum ControlElement {
171 CE_PushButton,
172 CE_PushButtonBevel,
173 CE_PushButtonLabel,
174
175 CE_CheckBox,
176 CE_CheckBoxLabel,
177
178 CE_RadioButton,
179 CE_RadioButtonLabel,
180
181 CE_TabBarTab,
182 CE_TabBarTabShape,
183 CE_TabBarTabLabel,
184
185 CE_ProgressBar,
186 CE_ProgressBarGroove,
187 CE_ProgressBarContents,
188 CE_ProgressBarLabel,
189
190 CE_MenuItem,
191 CE_MenuScroller,
192 CE_MenuVMargin,
193 CE_MenuHMargin,
194 CE_MenuTearoff,
195 CE_MenuEmptyArea,
196
197 CE_MenuBarItem,
198 CE_MenuBarEmptyArea,
199
200 CE_ToolButtonLabel,
201
202 CE_Header,
203 CE_HeaderSection,
204 CE_HeaderLabel,
205
206 CE_ToolBoxTab,
207 CE_SizeGrip,
208 CE_Splitter,
209 CE_RubberBand,
210 CE_DockWidgetTitle,
211
212 CE_ScrollBarAddLine,
213 CE_ScrollBarSubLine,
214 CE_ScrollBarAddPage,
215 CE_ScrollBarSubPage,
216 CE_ScrollBarSlider,
217 CE_ScrollBarFirst,
218 CE_ScrollBarLast,
219
220 CE_FocusFrame,
221 CE_ComboBoxLabel,
222
223 CE_ToolBar,
224 CE_ToolBoxTabShape,
225 CE_ToolBoxTabLabel,
226 CE_HeaderEmptyArea,
227
228 CE_ColumnViewGrip,
229
230 CE_ItemViewItem,
231
232 CE_ShapedFrame,
233
234 // do not add any values below/greater than this
235 CE_CustomBase = 0xf0000000
236 };
237 Q_ENUM(ControlElement)
238
239 virtual void drawControl(ControlElement element, const QStyleOption *opt, QPainter *p,
240 const QWidget *w = nullptr) const = 0;
241
242 enum SubElement {
243 SE_PushButtonContents,
244 SE_PushButtonFocusRect,
245
246 SE_CheckBoxIndicator,
247 SE_CheckBoxContents,
248 SE_CheckBoxFocusRect,
249 SE_CheckBoxClickRect,
250
251 SE_RadioButtonIndicator,
252 SE_RadioButtonContents,
253 SE_RadioButtonFocusRect,
254 SE_RadioButtonClickRect,
255
256 SE_ComboBoxFocusRect,
257
258 SE_SliderFocusRect,
259
260 SE_ProgressBarGroove,
261 SE_ProgressBarContents,
262 SE_ProgressBarLabel,
263
264 SE_ToolBoxTabContents,
265
266 SE_HeaderLabel,
267 SE_HeaderArrow,
268
269 SE_TabWidgetTabBar,
270 SE_TabWidgetTabPane,
271 SE_TabWidgetTabContents,
272 SE_TabWidgetLeftCorner,
273 SE_TabWidgetRightCorner,
274
275 SE_ItemViewItemCheckIndicator,
276 SE_TabBarTearIndicator,
277 SE_TabBarTearIndicatorLeft = SE_TabBarTearIndicator,
278
279 SE_TreeViewDisclosureItem,
280
281 SE_LineEditContents,
282 SE_FrameContents,
283
284 SE_DockWidgetCloseButton,
285 SE_DockWidgetFloatButton,
286 SE_DockWidgetTitleBarText,
287 SE_DockWidgetIcon,
288
289 SE_CheckBoxLayoutItem,
290 SE_ComboBoxLayoutItem,
291 SE_DateTimeEditLayoutItem,
292 SE_LabelLayoutItem,
293 SE_ProgressBarLayoutItem,
294 SE_PushButtonLayoutItem,
295 SE_RadioButtonLayoutItem,
296 SE_SliderLayoutItem,
297 SE_SpinBoxLayoutItem,
298 SE_ToolButtonLayoutItem,
299
300 SE_FrameLayoutItem,
301 SE_GroupBoxLayoutItem,
302 SE_TabWidgetLayoutItem,
303
304 SE_ItemViewItemDecoration,
305 SE_ItemViewItemText,
306 SE_ItemViewItemFocusRect,
307
308 SE_TabBarTabLeftButton,
309 SE_TabBarTabRightButton,
310 SE_TabBarTabText,
311
312 SE_ShapedFrameContents,
313
314 SE_ToolBarHandle,
315
316 SE_TabBarScrollLeftButton,
317 SE_TabBarScrollRightButton,
318 SE_TabBarTearIndicatorRight,
319
320 SE_PushButtonBevel,
321
322 // do not add any values below/greater than this
323 SE_CustomBase = 0xf0000000
324 };
325 Q_ENUM(SubElement)
326
327 virtual QRect subElementRect(SubElement subElement, const QStyleOption *option,
328 const QWidget *widget = nullptr) const = 0;
329
330
331 enum ComplexControl {
332 CC_SpinBox,
333 CC_ComboBox,
334 CC_ScrollBar,
335 CC_Slider,
336 CC_ToolButton,
337 CC_TitleBar,
338 CC_Dial,
339 CC_GroupBox,
340 CC_MdiControls,
341
342 // do not add any values below/greater than this
343 CC_CustomBase = 0xf0000000
344 };
345 Q_ENUM(ComplexControl)
346
347 enum SubControl {
348 SC_None = 0x00000000,
349
350 SC_ScrollBarAddLine = 0x00000001,
351 SC_ScrollBarSubLine = 0x00000002,
352 SC_ScrollBarAddPage = 0x00000004,
353 SC_ScrollBarSubPage = 0x00000008,
354 SC_ScrollBarFirst = 0x00000010,
355 SC_ScrollBarLast = 0x00000020,
356 SC_ScrollBarSlider = 0x00000040,
357 SC_ScrollBarGroove = 0x00000080,
358
359 SC_SpinBoxUp = 0x00000001,
360 SC_SpinBoxDown = 0x00000002,
361 SC_SpinBoxFrame = 0x00000004,
362 SC_SpinBoxEditField = 0x00000008,
363
364 SC_ComboBoxFrame = 0x00000001,
365 SC_ComboBoxEditField = 0x00000002,
366 SC_ComboBoxArrow = 0x00000004,
367 SC_ComboBoxListBoxPopup = 0x00000008,
368
369 SC_SliderGroove = 0x00000001,
370 SC_SliderHandle = 0x00000002,
371 SC_SliderTickmarks = 0x00000004,
372
373 SC_ToolButton = 0x00000001,
374 SC_ToolButtonMenu = 0x00000002,
375
376 SC_TitleBarSysMenu = 0x00000001,
377 SC_TitleBarMinButton = 0x00000002,
378 SC_TitleBarMaxButton = 0x00000004,
379 SC_TitleBarCloseButton = 0x00000008,
380 SC_TitleBarNormalButton = 0x00000010,
381 SC_TitleBarShadeButton = 0x00000020,
382 SC_TitleBarUnshadeButton = 0x00000040,
383 SC_TitleBarContextHelpButton = 0x00000080,
384 SC_TitleBarLabel = 0x00000100,
385
386 SC_DialGroove = 0x00000001,
387 SC_DialHandle = 0x00000002,
388 SC_DialTickmarks = 0x00000004,
389
390 SC_GroupBoxCheckBox = 0x00000001,
391 SC_GroupBoxLabel = 0x00000002,
392 SC_GroupBoxContents = 0x00000004,
393 SC_GroupBoxFrame = 0x00000008,
394
395 SC_MdiMinButton = 0x00000001,
396 SC_MdiNormalButton = 0x00000002,
397 SC_MdiCloseButton = 0x00000004,
398
399 SC_CustomBase = 0xf0000000,
400 SC_All = 0xffffffff
401 };
402 Q_ENUM(SubControl)
403 Q_DECLARE_FLAGS(SubControls, SubControl)
404
405
406 virtual void drawComplexControl(ComplexControl cc, const QStyleOptionComplex *opt, QPainter *p,
407 const QWidget *widget = nullptr) const = 0;
408 virtual SubControl hitTestComplexControl(ComplexControl cc, const QStyleOptionComplex *opt,
409 const QPoint &pt, const QWidget *widget = nullptr) const = 0;
410 virtual QRect subControlRect(ComplexControl cc, const QStyleOptionComplex *opt,
411 SubControl sc, const QWidget *widget = nullptr) const = 0;
412
413 enum PixelMetric {
414 PM_ButtonMargin,
415 PM_ButtonDefaultIndicator,
416 PM_MenuButtonIndicator,
417 PM_ButtonShiftHorizontal,
418 PM_ButtonShiftVertical,
419
420 PM_DefaultFrameWidth,
421 PM_SpinBoxFrameWidth,
422 PM_ComboBoxFrameWidth,
423
424 PM_MaximumDragDistance,
425
426 PM_ScrollBarExtent,
427 PM_ScrollBarSliderMin,
428
429 PM_SliderThickness, // total slider thickness
430 PM_SliderControlThickness, // thickness of the business part
431 PM_SliderLength, // total length of slider
432 PM_SliderTickmarkOffset, //
433 PM_SliderSpaceAvailable, // available space for slider to move
434
435 PM_DockWidgetSeparatorExtent,
436 PM_DockWidgetHandleExtent,
437 PM_DockWidgetFrameWidth,
438
439 PM_TabBarTabOverlap,
440 PM_TabBarTabHSpace,
441 PM_TabBarTabVSpace,
442 PM_TabBarBaseHeight,
443 PM_TabBarBaseOverlap,
444
445 PM_ProgressBarChunkWidth,
446
447 PM_SplitterWidth,
448 PM_TitleBarHeight,
449
450 PM_MenuScrollerHeight,
451 PM_MenuHMargin,
452 PM_MenuVMargin,
453 PM_MenuPanelWidth,
454 PM_MenuTearoffHeight,
455 PM_MenuDesktopFrameWidth,
456
457 PM_MenuBarPanelWidth,
458 PM_MenuBarItemSpacing,
459 PM_MenuBarVMargin,
460 PM_MenuBarHMargin,
461
462 PM_IndicatorWidth,
463 PM_IndicatorHeight,
464 PM_ExclusiveIndicatorWidth,
465 PM_ExclusiveIndicatorHeight,
466
467#if QT_DEPRECATED_SINCE(6, 8)
468 PM_DialogButtonsSeparator Q_DECL_ENUMERATOR_DEPRECATED_X("Not used and no effect since Qt 4"),
469 PM_DialogButtonsButtonWidth Q_DECL_ENUMERATOR_DEPRECATED_X("Not used and no effect since Qt 4"),
470 PM_DialogButtonsButtonHeight Q_DECL_ENUMERATOR_DEPRECATED_X("Not used and no effect since Qt 4"),
471#endif
472
473 PM_MdiSubWindowFrameWidth = 44,
474 PM_MdiSubWindowMinimizedWidth,
475
476 PM_HeaderMargin,
477 PM_HeaderMarkSize,
478 PM_HeaderGripMargin,
479 PM_TabBarTabShiftHorizontal,
480 PM_TabBarTabShiftVertical,
481 PM_TabBarScrollButtonWidth,
482
483 PM_ToolBarFrameWidth,
484 PM_ToolBarHandleExtent,
485 PM_ToolBarItemSpacing,
486 PM_ToolBarItemMargin,
487 PM_ToolBarSeparatorExtent,
488 PM_ToolBarExtensionExtent,
489
490 PM_SpinBoxSliderHeight,
491
492 PM_ToolBarIconSize,
493 PM_ListViewIconSize,
494 PM_IconViewIconSize,
495 PM_SmallIconSize,
496 PM_LargeIconSize,
497
498 PM_FocusFrameVMargin,
499 PM_FocusFrameHMargin,
500
501 PM_ToolTipLabelFrameWidth,
502 PM_CheckBoxLabelSpacing,
503 PM_TabBarIconSize,
504 PM_SizeGripSize,
505 PM_DockWidgetTitleMargin,
506 PM_MessageBoxIconSize,
507 PM_ButtonIconSize,
508
509 PM_DockWidgetTitleBarButtonMargin,
510
511 PM_RadioButtonLabelSpacing,
512 PM_LayoutLeftMargin,
513 PM_LayoutTopMargin,
514 PM_LayoutRightMargin,
515 PM_LayoutBottomMargin,
516 PM_LayoutHorizontalSpacing,
517 PM_LayoutVerticalSpacing,
518 PM_TabBar_ScrollButtonOverlap,
519
520 PM_TextCursorWidth,
521
522 PM_TabCloseIndicatorWidth,
523 PM_TabCloseIndicatorHeight,
524
525 PM_ScrollView_ScrollBarSpacing,
526 PM_ScrollView_ScrollBarOverlap,
527 PM_SubMenuOverlap,
528 PM_TreeViewIndentation,
529
530 PM_HeaderDefaultSectionSizeHorizontal,
531 PM_HeaderDefaultSectionSizeVertical,
532
533 PM_TitleBarButtonIconSize,
534 PM_TitleBarButtonSize,
535
536 PM_LineEditIconSize,
537 PM_LineEditIconMargin,
538 // do not add any values below/greater than this
539 PM_CustomBase = 0xf0000000
540 };
541 Q_ENUM(PixelMetric)
542
543 virtual int pixelMetric(PixelMetric metric, const QStyleOption *option = nullptr,
544 const QWidget *widget = nullptr) const = 0;
545
546 enum ContentsType {
547 CT_PushButton,
548 CT_CheckBox,
549 CT_RadioButton,
550 CT_ToolButton,
551 CT_ComboBox,
552 CT_Splitter,
553 CT_ProgressBar,
554 CT_MenuItem,
555 CT_MenuBarItem,
556 CT_MenuBar,
557 CT_Menu,
558 CT_TabBarTab,
559 CT_Slider,
560 CT_ScrollBar,
561 CT_LineEdit,
562 CT_SpinBox,
563 CT_SizeGrip,
564 CT_TabWidget,
565 CT_DialogButtons,
566 CT_HeaderSection,
567 CT_GroupBox,
568 CT_MdiControls,
569 CT_ItemViewItem,
570 // do not add any values below/greater than this
571 CT_CustomBase = 0xf0000000
572 };
573 Q_ENUM(ContentsType)
574
575 virtual QSize sizeFromContents(ContentsType ct, const QStyleOption *opt,
576 const QSize &contentsSize, const QWidget *w = nullptr) const = 0;
577
578 enum RequestSoftwareInputPanel {
579 RSIP_OnMouseClickAndAlreadyFocused,
580 RSIP_OnMouseClick
581 };
582 Q_ENUM(RequestSoftwareInputPanel)
583
584 enum StyleHint {
585 SH_EtchDisabledText,
586 SH_DitherDisabledText,
587 SH_ScrollBar_MiddleClickAbsolutePosition,
588 SH_ScrollBar_ScrollWhenPointerLeavesControl,
589 SH_TabBar_SelectMouseType,
590 SH_TabBar_Alignment,
591 SH_Header_ArrowAlignment,
592 SH_Slider_SnapToValue,
593 SH_Slider_SloppyKeyEvents,
594 SH_ProgressDialog_CenterCancelButton,
595 SH_ProgressDialog_TextLabelAlignment,
596 SH_PrintDialog_RightAlignButtons,
597 SH_MainWindow_SpaceBelowMenuBar,
598 SH_FontDialog_SelectAssociatedText,
599 SH_Menu_AllowActiveAndDisabled,
600 SH_Menu_SpaceActivatesItem,
601 SH_Menu_SubMenuPopupDelay,
602 SH_ScrollView_FrameOnlyAroundContents,
603 SH_MenuBar_AltKeyNavigation,
604 SH_ComboBox_ListMouseTracking,
605 SH_ComboBox_ListMouseTracking_Current = SH_ComboBox_ListMouseTracking,
606 SH_Menu_MouseTracking,
607 SH_MenuBar_MouseTracking,
608 SH_ItemView_ChangeHighlightOnFocus,
609 SH_Widget_ShareActivation,
610 SH_Workspace_FillSpaceOnMaximize,
611 SH_ComboBox_Popup,
612 SH_TitleBar_NoBorder,
613 SH_Slider_StopMouseOverSlider,
614 SH_BlinkCursorWhenTextSelected,
615 SH_RichText_FullWidthSelection,
616 SH_Menu_Scrollable,
617 SH_GroupBox_TextLabelVerticalAlignment,
618 SH_GroupBox_TextLabelColor,
619 SH_Menu_SloppySubMenus,
620 SH_Table_GridLineColor,
621 SH_LineEdit_PasswordCharacter,
622 SH_DialogButtons_DefaultButton,
623 SH_ToolBox_SelectedPageTitleBold,
624 SH_TabBar_PreferNoArrows,
625 SH_ScrollBar_LeftClickAbsolutePosition,
626 SH_ListViewExpand_SelectMouseType,
627 SH_UnderlineShortcut,
628 SH_SpinBox_AnimateButton,
629 SH_SpinBox_KeyPressAutoRepeatRate,
630 SH_SpinBox_ClickAutoRepeatRate,
631 SH_Menu_FillScreenWithScroll,
632 SH_ToolTipLabel_Opacity,
633 SH_DrawMenuBarSeparator,
634 SH_TitleBar_ModifyNotification,
635 SH_Button_FocusPolicy,
636 SH_MessageBox_UseBorderForButtonSpacing,
637 SH_TitleBar_AutoRaise,
638 SH_ToolButton_PopupDelay,
639 SH_FocusFrame_Mask,
640 SH_RubberBand_Mask,
641 SH_WindowFrame_Mask,
642 SH_SpinControls_DisableOnBounds,
643 SH_Dial_BackgroundRole,
644 SH_ComboBox_LayoutDirection,
645 SH_ItemView_EllipsisLocation,
646 SH_ItemView_ShowDecorationSelected,
647 SH_ItemView_ActivateItemOnSingleClick,
648 SH_ScrollBar_ContextMenu,
649 SH_ScrollBar_RollBetweenButtons,
650 SH_Slider_AbsoluteSetButtons,
651 SH_Slider_PageSetButtons,
652 SH_Menu_KeyboardSearch,
653 SH_TabBar_ElideMode,
654 SH_DialogButtonLayout,
655 SH_ComboBox_PopupFrameStyle,
656 SH_MessageBox_TextInteractionFlags,
657 SH_DialogButtonBox_ButtonsHaveIcons,
658 SH_MessageBox_CenterButtons,
659 SH_Menu_SelectionWrap,
660 SH_ItemView_MovementWithoutUpdatingSelection,
661 SH_ToolTip_Mask,
662 SH_FocusFrame_AboveWidget,
663 SH_TextControl_FocusIndicatorTextCharFormat,
664 SH_WizardStyle,
665 SH_ItemView_ArrowKeysNavigateIntoChildren,
666 SH_Menu_Mask,
667 SH_Menu_FlashTriggeredItem,
668 SH_Menu_FadeOutOnHide,
669 SH_SpinBox_ClickAutoRepeatThreshold,
670 SH_ItemView_PaintAlternatingRowColorsForEmptyArea,
671 SH_FormLayoutWrapPolicy,
672 SH_TabWidget_DefaultTabPosition,
673 SH_ToolBar_Movable,
674 SH_FormLayoutFieldGrowthPolicy,
675 SH_FormLayoutFormAlignment,
676 SH_FormLayoutLabelAlignment,
677 SH_ItemView_DrawDelegateFrame,
678 SH_TabBar_CloseButtonPosition,
679 SH_DockWidget_ButtonsHaveFrame,
680 SH_ToolButtonStyle,
681 SH_RequestSoftwareInputPanel,
682 SH_ScrollBar_Transient,
683 SH_Menu_SupportsSections,
684 SH_ToolTip_WakeUpDelay,
685 SH_ToolTip_FallAsleepDelay,
686 SH_Widget_Animate,
687 SH_Splitter_OpaqueResize,
688 // Whether we should use a native popup.
689 // Only supported for non-editable combo boxes on Mac OS X so far.
690 SH_ComboBox_UseNativePopup,
691 SH_LineEdit_PasswordMaskDelay,
692 SH_TabBar_ChangeCurrentDelay,
693 SH_Menu_SubMenuUniDirection,
694 SH_Menu_SubMenuUniDirectionFailCount,
695 SH_Menu_SubMenuSloppySelectOtherActions,
696 SH_Menu_SubMenuSloppyCloseTimeout,
697 SH_Menu_SubMenuResetWhenReenteringParent,
698 SH_Menu_SubMenuDontStartSloppyOnLeave,
699 SH_ItemView_ScrollMode,
700 SH_TitleBar_ShowToolTipsOnButtons,
701 SH_Widget_Animation_Duration,
702 SH_ComboBox_AllowWheelScrolling,
703 SH_SpinBox_ButtonsInsideFrame,
704 SH_SpinBox_StepModifier,
705 SH_TabBar_AllowWheelScrolling,
706 SH_Table_AlwaysDrawLeftTopGridLines,
707 SH_SpinBox_SelectOnStep,
708 SH_ComboBox_ListMouseTracking_Active,
709 // Add new style hint values here
710
711 SH_CustomBase = 0xf0000000
712 };
713 Q_ENUM(StyleHint)
714
715 virtual int styleHint(StyleHint stylehint, const QStyleOption *opt = nullptr,
716 const QWidget *widget = nullptr, QStyleHintReturn* returnData = nullptr) const = 0;
717
718 enum StandardPixmap {
719 SP_TitleBarMenuButton,
720 SP_TitleBarMinButton,
721 SP_TitleBarMaxButton,
722 SP_TitleBarCloseButton,
723 SP_TitleBarNormalButton,
724 SP_TitleBarShadeButton,
725 SP_TitleBarUnshadeButton,
726 SP_TitleBarContextHelpButton,
727 SP_DockWidgetCloseButton,
728 SP_MessageBoxInformation,
729 SP_MessageBoxWarning,
730 SP_MessageBoxCritical,
731 SP_MessageBoxQuestion,
732 SP_DesktopIcon,
733 SP_TrashIcon,
734 SP_ComputerIcon,
735 SP_DriveFDIcon,
736 SP_DriveHDIcon,
737 SP_DriveCDIcon,
738 SP_DriveDVDIcon,
739 SP_DriveNetIcon,
740 SP_DirOpenIcon,
741 SP_DirClosedIcon,
742 SP_DirLinkIcon,
743 SP_DirLinkOpenIcon,
744 SP_FileIcon,
745 SP_FileLinkIcon,
746 SP_ToolBarHorizontalExtensionButton,
747 SP_ToolBarVerticalExtensionButton,
748 SP_FileDialogStart,
749 SP_FileDialogEnd,
750 SP_FileDialogToParent,
751 SP_FileDialogNewFolder,
752 SP_FileDialogDetailedView,
753 SP_FileDialogInfoView,
754 SP_FileDialogContentsView,
755 SP_FileDialogListView,
756 SP_FileDialogBack,
757 SP_DirIcon,
758 SP_DialogOkButton,
759 SP_DialogCancelButton,
760 SP_DialogHelpButton,
761 SP_DialogOpenButton,
762 SP_DialogSaveButton,
763 SP_DialogCloseButton,
764 SP_DialogApplyButton,
765 SP_DialogResetButton,
766 SP_DialogDiscardButton,
767 SP_DialogYesButton,
768 SP_DialogNoButton,
769 SP_ArrowUp,
770 SP_ArrowDown,
771 SP_ArrowLeft,
772 SP_ArrowRight,
773 SP_ArrowBack,
774 SP_ArrowForward,
775 SP_DirHomeIcon,
776 SP_CommandLink,
777 SP_VistaShield,
778 SP_BrowserReload,
779 SP_BrowserStop,
780 SP_MediaPlay,
781 SP_MediaStop,
782 SP_MediaPause,
783 SP_MediaSkipForward,
784 SP_MediaSkipBackward,
785 SP_MediaSeekForward,
786 SP_MediaSeekBackward,
787 SP_MediaVolume,
788 SP_MediaVolumeMuted,
789 SP_LineEditClearButton,
790 SP_DialogYesToAllButton,
791 SP_DialogNoToAllButton,
792 SP_DialogSaveAllButton,
793 SP_DialogAbortButton,
794 SP_DialogRetryButton,
795 SP_DialogIgnoreButton,
796 SP_RestoreDefaultsButton,
797 SP_TabCloseButton,
798 SP_TabScrollLeftButton,
799 SP_TabScrollRightButton,
800 SP_TabScrollUpButton,
801 SP_TabScrollDownButton,
802 NStandardPixmap, // assertion value for sync with QPlatformTheme::StandardPixmap
803 // do not add any values below/greater than this
804 SP_CustomBase = 0xf0000000
805 };
806 Q_ENUM(StandardPixmap)
807
808 virtual QPixmap standardPixmap(StandardPixmap standardPixmap, const QStyleOption *opt = nullptr,
809 const QWidget *widget = nullptr) const = 0;
810
811 virtual QIcon standardIcon(StandardPixmap standardIcon, const QStyleOption *option = nullptr,
812 const QWidget *widget = nullptr) const = 0;
813
814 virtual QPixmap generatedIconPixmap(QIcon::Mode iconMode, const QPixmap &pixmap,
815 const QStyleOption *opt) const = 0;
816
817 static QRect visualRect(Qt::LayoutDirection direction, const QRect &boundingRect,
818 const QRect &logicalRect);
819 static QPoint visualPos(Qt::LayoutDirection direction, const QRect &boundingRect,
820 const QPoint &logicalPos);
821 static int sliderPositionFromValue(int min, int max, int val, int space,
822 bool upsideDown = false);
823 static int sliderValueFromPosition(int min, int max, int pos, int space,
824 bool upsideDown = false);
825 static Qt::Alignment visualAlignment(Qt::LayoutDirection direction, Qt::Alignment alignment);
826 static QRect alignedRect(Qt::LayoutDirection direction, Qt::Alignment alignment,
827 const QSize &size, const QRect &rectangle);
828
829 virtual int layoutSpacing(QSizePolicy::ControlType control1,
830 QSizePolicy::ControlType control2, Qt::Orientation orientation,
831 const QStyleOption *option = nullptr, const QWidget *widget = nullptr) const = 0;
832 int combinedLayoutSpacing(QSizePolicy::ControlTypes controls1,
833 QSizePolicy::ControlTypes controls2, Qt::Orientation orientation,
834 QStyleOption *option = nullptr, QWidget *widget = nullptr) const;
835
836 const QStyle * proxy() const;
837
838private:
839 void setName(const QString &name);
840
841private:
842 Q_DISABLE_COPY(QStyle)
843 friend class QWidget;
844 friend class QWidgetPrivate;
845 friend class QApplication;
846 friend class QProxyStyle;
847 friend class QProxyStylePrivate;
848 friend class QStyleFactory;
849 friend class QStyleSheetProxySaver;
850 void setProxy(QStyle *style);
851};
852
853Q_DECLARE_OPERATORS_FOR_FLAGS(QStyle::State)
854Q_DECLARE_OPERATORS_FOR_FLAGS(QStyle::SubControls)
855
856QT_END_NAMESPACE
857
858#endif // QSTYLE_H
QSqlRelationalDelegate
\inmodule QtSql
QStyle
The QStyle class is an abstract base class that encapsulates the look and feel of a GUI.
Definition qstyle.h:30
QT_BEGIN_NAMESPACE
Combined button and popup list for selecting options.
Definition qsequentialanimationgroup.cpp:47