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
4#ifndef QWIDGET_H
5#define QWIDGET_H
6
7#include <QtWidgets/qtwidgetsglobal.h>
8#include <QtGui/qwindowdefs.h>
9#include <QtCore/qobject.h>
10#include <QtCore/qmargins.h>
11#if QT_CONFIG(action)
12#include <QtGui/qaction.h>
13#endif
14#include <QtGui/qpaintdevice.h>
15#include <QtGui/qpalette.h>
16#include <QtGui/qfont.h>
17#include <QtGui/qfontmetrics.h>
18#include <QtGui/qfontinfo.h>
19#include <QtWidgets/qsizepolicy.h>
20#include <QtGui/qregion.h>
21#include <QtGui/qbrush.h>
22#include <QtGui/qcursor.h>
23#if QT_CONFIG(shortcut)
24# include <QtGui/qkeysequence.h>
25#endif
26
27#ifdef QT_INCLUDE_COMPAT
28#include <QtGui/qevent.h>
29#endif
30
31QT_BEGIN_NAMESPACE
32
33
34class QLayout;
35class QStyle;
36class QAction;
37class QVariant;
38class QWindow;
39class QActionEvent;
40class QMouseEvent;
41class QWheelEvent;
42class QHoverEvent;
43class QKeyEvent;
44class QEnterEvent;
45class QFocusEvent;
46class QPaintEvent;
47class QMoveEvent;
48class QResizeEvent;
49class QCloseEvent;
50class QContextMenuEvent;
51class QInputMethodEvent;
52class QTabletEvent;
53class QDragEnterEvent;
54class QDragMoveEvent;
55class QDragLeaveEvent;
56class QDropEvent;
57class QScreen;
58class QShowEvent;
59class QHideEvent;
60class QIcon;
61class QBackingStore;
62class QPlatformWindow;
63class QLocale;
64class QGraphicsProxyWidget;
65class QGraphicsEffect;
66class QRasterWindowSurface;
67class QPixmap;
68#ifndef QT_NO_DEBUG_STREAM
69class QDebug;
70#endif
71
72class QWidgetData
73{
74public:
75 WId winid;
76 uint widget_attributes;
77 Qt::WindowFlags window_flags;
78 uint window_state : 4;
79 uint focus_policy : 4;
80 uint sizehint_forced :1;
81 uint is_closing :1;
82 uint in_show : 1;
83 uint in_set_window_state : 1;
84 mutable uint fstrut_dirty : 1;
85 uint context_menu_policy : 3;
86 uint window_modality : 2;
87 uint in_destructor : 1;
88 uint unused : 13;
89 QRect crect;
90 mutable QPalette pal;
91 QFont fnt;
92 QRect wrect;
93};
94
95class QWidgetPrivate;
96
97class Q_WIDGETS_EXPORT QWidget : public QObject, public QPaintDevice
98{
99 Q_OBJECT
100 Q_DECLARE_PRIVATE(QWidget)
101
102 Q_PROPERTY(bool modal READ isModal)
103 Q_PROPERTY(Qt::WindowModality windowModality READ windowModality WRITE setWindowModality)
104 Q_PROPERTY(bool enabled READ isEnabled WRITE setEnabled)
105 Q_PROPERTY(QRect geometry READ geometry WRITE setGeometry)
106 Q_PROPERTY(QRect frameGeometry READ frameGeometry)
107 Q_PROPERTY(QRect normalGeometry READ normalGeometry)
108 Q_PROPERTY(int x READ x)
109 Q_PROPERTY(int y READ y)
110 Q_PROPERTY(QPoint pos READ pos WRITE move DESIGNABLE false STORED false)
111 Q_PROPERTY(QSize frameSize READ frameSize)
112 Q_PROPERTY(QSize size READ size WRITE resize DESIGNABLE false STORED false)
113 Q_PROPERTY(int width READ width)
114 Q_PROPERTY(int height READ height)
115 Q_PROPERTY(QRect rect READ rect)
116 Q_PROPERTY(QRect childrenRect READ childrenRect)
117 Q_PROPERTY(QRegion childrenRegion READ childrenRegion)
118 Q_PROPERTY(QSizePolicy sizePolicy READ sizePolicy WRITE setSizePolicy)
119 Q_PROPERTY(QSize minimumSize READ minimumSize WRITE setMinimumSize)
120 Q_PROPERTY(QSize maximumSize READ maximumSize WRITE setMaximumSize)
121 Q_PROPERTY(int minimumWidth READ minimumWidth WRITE setMinimumWidth STORED false
122 DESIGNABLE false)
123 Q_PROPERTY(int minimumHeight READ minimumHeight WRITE setMinimumHeight STORED false
124 DESIGNABLE false)
125 Q_PROPERTY(int maximumWidth READ maximumWidth WRITE setMaximumWidth STORED false
126 DESIGNABLE false)
127 Q_PROPERTY(int maximumHeight READ maximumHeight WRITE setMaximumHeight STORED false
128 DESIGNABLE false)
129 Q_PROPERTY(QSize sizeIncrement READ sizeIncrement WRITE setSizeIncrement)
130 Q_PROPERTY(QSize baseSize READ baseSize WRITE setBaseSize)
131 Q_PROPERTY(QPalette palette READ palette WRITE setPalette)
132 Q_PROPERTY(QFont font READ font WRITE setFont)
133#ifndef QT_NO_CURSOR
134 Q_PROPERTY(QCursor cursor READ cursor WRITE setCursor RESET unsetCursor)
135#endif
136 Q_PROPERTY(bool mouseTracking READ hasMouseTracking WRITE setMouseTracking)
137 Q_PROPERTY(bool tabletTracking READ hasTabletTracking WRITE setTabletTracking)
138 Q_PROPERTY(bool isActiveWindow READ isActiveWindow)
139 Q_PROPERTY(Qt::FocusPolicy focusPolicy READ focusPolicy WRITE setFocusPolicy)
140 Q_PROPERTY(bool focus READ hasFocus)
141 Q_PROPERTY(Qt::ContextMenuPolicy contextMenuPolicy READ contextMenuPolicy WRITE setContextMenuPolicy)
142 Q_PROPERTY(bool updatesEnabled READ updatesEnabled WRITE setUpdatesEnabled DESIGNABLE false)
143 Q_PROPERTY(bool visible READ isVisible WRITE setVisible DESIGNABLE false)
144 Q_PROPERTY(bool minimized READ isMinimized)
145 Q_PROPERTY(bool maximized READ isMaximized)
146 Q_PROPERTY(bool fullScreen READ isFullScreen)
147 Q_PROPERTY(QSize sizeHint READ sizeHint)
148 Q_PROPERTY(QSize minimumSizeHint READ minimumSizeHint)
149 Q_PROPERTY(bool acceptDrops READ acceptDrops WRITE setAcceptDrops)
150 Q_PROPERTY(QString windowTitle READ windowTitle WRITE setWindowTitle NOTIFY windowTitleChanged)
151 Q_PROPERTY(QIcon windowIcon READ windowIcon WRITE setWindowIcon NOTIFY windowIconChanged)
152 Q_PROPERTY(QString windowIconText READ windowIconText WRITE setWindowIconText NOTIFY windowIconTextChanged) // deprecated
153 Q_PROPERTY(double windowOpacity READ windowOpacity WRITE setWindowOpacity)
154 Q_PROPERTY(bool windowModified READ isWindowModified WRITE setWindowModified)
155#if QT_CONFIG(tooltip)
156 Q_PROPERTY(QString toolTip READ toolTip WRITE setToolTip)
157 Q_PROPERTY(int toolTipDuration READ toolTipDuration WRITE setToolTipDuration)
158#endif
159#if QT_CONFIG(statustip)
160 Q_PROPERTY(QString statusTip READ statusTip WRITE setStatusTip)
161#endif
162#if QT_CONFIG(whatsthis)
163 Q_PROPERTY(QString whatsThis READ whatsThis WRITE setWhatsThis)
164#endif
165#if QT_CONFIG(accessibility)
166 Q_PROPERTY(QString accessibleName READ accessibleName WRITE setAccessibleName)
167 Q_PROPERTY(QString accessibleDescription READ accessibleDescription WRITE setAccessibleDescription)
168 Q_PROPERTY(QString accessibleIdentifier READ accessibleIdentifier WRITE setAccessibleIdentifier)
169#endif
170 Q_PROPERTY(Qt::LayoutDirection layoutDirection READ layoutDirection WRITE setLayoutDirection RESET unsetLayoutDirection)
171 QDOC_PROPERTY(Qt::WindowFlags windowFlags READ windowFlags WRITE setWindowFlags)
172 Q_PROPERTY(bool autoFillBackground READ autoFillBackground WRITE setAutoFillBackground)
173#ifndef QT_NO_STYLE_STYLESHEET
174 Q_PROPERTY(QString styleSheet READ styleSheet WRITE setStyleSheet)
175#endif
176 Q_PROPERTY(QLocale locale READ locale WRITE setLocale RESET unsetLocale)
177 Q_PROPERTY(QString windowFilePath READ windowFilePath WRITE setWindowFilePath)
178 Q_PROPERTY(Qt::InputMethodHints inputMethodHints READ inputMethodHints WRITE setInputMethodHints)
179
180#if QT_CONFIG(action)
181#if 0
182 // ### TODO: make this work (requires SFINAE-friendly connect())
183 template <typename...Args>
184 using compatible_action_slot_args = std::void_t<
185 decltype(QObject::connect(std::declval<QAction*>(), &QAction::triggered,
186 std::declval<Args>()...))
187 >;
188#else
189 // good-enough compromise for now
190 template <typename...Args>
191 using compatible_action_slot_args = std::enable_if_t<std::conjunction_v<
192#if QT_CONFIG(shortcut)
193 std::disjunction<
194 std::is_same<Args, Qt::ConnectionType>,
195 std::negation<std::is_convertible<Args, QKeySequence>>
196 >...,
197#endif
198 std::negation<std::is_convertible<Args, QIcon>>...,
199 std::negation<std::is_convertible<Args, const char*>>...,
200 std::negation<std::is_convertible<Args, QString>>...
201 >>;
202#endif
203#endif // QT_CONFIG(action)
204
205public:
206 enum RenderFlag {
207 DrawWindowBackground = 0x1,
208 DrawChildren = 0x2,
209 IgnoreMask = 0x4
210 };
211 Q_DECLARE_FLAGS(RenderFlags, RenderFlag)
212
213 explicit QWidget(QWidget* parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags());
214 ~QWidget();
215
216 int devType() const override;
217
218 WId winId() const;
219 void createWinId(); // internal, going away
220 inline WId internalWinId() const { return data->winid; }
221 WId effectiveWinId() const;
222
223 // GUI style setting
224 QStyle *style() const;
225 void setStyle(QStyle *);
226 // Widget types and states
227
228#if QT_DEPRECATED_SINCE(6, 1)
229 QT_DEPRECATED_VERSION_X_6_1("Use isWindow()")
230 bool isTopLevel() const;
231#endif
232 bool isWindow() const;
233
234 bool isModal() const;
235 Qt::WindowModality windowModality() const;
236 void setWindowModality(Qt::WindowModality windowModality);
237
238 bool isEnabled() const;
239 bool isEnabledTo(const QWidget *) const;
240
241public Q_SLOTS:
242 void setEnabled(bool);
243 void setDisabled(bool);
244 void setWindowModified(bool);
245
246 // Widget coordinates
247
248public:
249 QRect frameGeometry() const;
250 const QRect &geometry() const;
251 QRect normalGeometry() const;
252
253 int x() const;
254 int y() const;
255 QPoint pos() const;
256 QSize frameSize() const;
257 QSize size() const;
258 inline int width() const;
259 inline int height() const;
260 inline QRect rect() const;
261 QRect childrenRect() const;
262 QRegion childrenRegion() const;
263
264 QSize minimumSize() const;
265 QSize maximumSize() const;
266 int minimumWidth() const;
267 int minimumHeight() const;
268 int maximumWidth() const;
269 int maximumHeight() const;
270 void setMinimumSize(const QSize &);
271 void setMinimumSize(int minw, int minh);
272 void setMaximumSize(const QSize &);
273 void setMaximumSize(int maxw, int maxh);
274 void setMinimumWidth(int minw);
275 void setMinimumHeight(int minh);
276 void setMaximumWidth(int maxw);
277 void setMaximumHeight(int maxh);
278
279#ifdef Q_QDOC
280 void setupUi(QWidget *widget);
281#endif
282
283 QSize sizeIncrement() const;
284 void setSizeIncrement(const QSize &);
285 void setSizeIncrement(int w, int h);
286 QSize baseSize() const;
287 void setBaseSize(const QSize &);
288 void setBaseSize(int basew, int baseh);
289
290 void setFixedSize(const QSize &);
291 void setFixedSize(int w, int h);
292 void setFixedWidth(int w);
293 void setFixedHeight(int h);
294
295 // Widget coordinate mapping
296
297 QPointF mapToGlobal(const QPointF &) const;
298 QPoint mapToGlobal(const QPoint &) const;
299 QPointF mapFromGlobal(const QPointF &) const;
300 QPoint mapFromGlobal(const QPoint &) const;
301 QPointF mapToParent(const QPointF &) const;
302 QPoint mapToParent(const QPoint &) const;
303 QPointF mapFromParent(const QPointF &) const;
304 QPoint mapFromParent(const QPoint &) const;
305 QPointF mapTo(const QWidget *, const QPointF &) const;
306 QPoint mapTo(const QWidget *, const QPoint &) const;
307 QPointF mapFrom(const QWidget *, const QPointF &) const;
308 QPoint mapFrom(const QWidget *, const QPoint &) const;
309
310 QWidget *window() const;
311 QWidget *nativeParentWidget() const;
312 inline QWidget *topLevelWidget() const { return window(); }
313
314 // Widget appearance functions
315 const QPalette &palette() const;
316 void setPalette(const QPalette &);
317
318 void setBackgroundRole(QPalette::ColorRole);
319 QPalette::ColorRole backgroundRole() const;
320
321 void setForegroundRole(QPalette::ColorRole);
322 QPalette::ColorRole foregroundRole() const;
323
324 const QFont &font() const;
325 void setFont(const QFont &);
326 QFontMetrics fontMetrics() const;
327 QFontInfo fontInfo() const;
328
329#ifndef QT_NO_CURSOR
330 QCursor cursor() const;
331 void setCursor(const QCursor &);
332 void unsetCursor();
333#endif
334
335 void setMouseTracking(bool enable);
336 bool hasMouseTracking() const;
337 bool underMouse() const;
338
339 void setTabletTracking(bool enable);
340 bool hasTabletTracking() const;
341
342 void setMask(const QBitmap &);
343 void setMask(const QRegion &);
344 QRegion mask() const;
345 void clearMask();
346
347 void render(QPaintDevice *target, const QPoint &targetOffset = QPoint(),
348 const QRegion &sourceRegion = QRegion(),
349 RenderFlags renderFlags = RenderFlags(DrawWindowBackground | DrawChildren));
350
351 void render(QPainter *painter, const QPoint &targetOffset = QPoint(),
352 const QRegion &sourceRegion = QRegion(),
353 RenderFlags renderFlags = RenderFlags(DrawWindowBackground | DrawChildren));
354
355 Q_INVOKABLE QPixmap grab(const QRect &rectangle = QRect(QPoint(0, 0), QSize(-1, -1)));
356
357#if QT_CONFIG(graphicseffect)
358 QGraphicsEffect *graphicsEffect() const;
359 void setGraphicsEffect(QGraphicsEffect *effect);
360#endif // QT_CONFIG(graphicseffect)
361
362#ifndef QT_NO_GESTURES
363 void grabGesture(Qt::GestureType type, Qt::GestureFlags flags = Qt::GestureFlags());
364 void ungrabGesture(Qt::GestureType type);
365#endif
366
367public Q_SLOTS:
368 void setWindowTitle(const QString &);
369#ifndef QT_NO_STYLE_STYLESHEET
370 void setStyleSheet(const QString& styleSheet);
371#endif
372public:
373#ifndef QT_NO_STYLE_STYLESHEET
374 QString styleSheet() const;
375#endif
376 QString windowTitle() const;
377 void setWindowIcon(const QIcon &icon);
378 QIcon windowIcon() const;
379 void setWindowIconText(const QString &);
380 QString windowIconText() const;
381 void setWindowRole(const QString &);
382 QString windowRole() const;
383 void setWindowFilePath(const QString &filePath);
384 QString windowFilePath() const;
385
386 void setWindowOpacity(qreal level);
387 qreal windowOpacity() const;
388
389 bool isWindowModified() const;
390#if QT_CONFIG(tooltip)
391 void setToolTip(const QString &);
392 QString toolTip() const;
393 void setToolTipDuration(int msec);
394 int toolTipDuration() const;
395#endif
396#if QT_CONFIG(statustip)
397 void setStatusTip(const QString &);
398 QString statusTip() const;
399#endif
400#if QT_CONFIG(whatsthis)
401 void setWhatsThis(const QString &);
402 QString whatsThis() const;
403#endif
404#if QT_CONFIG(accessibility)
405 QString accessibleName() const;
406 void setAccessibleName(const QString &name);
407 QString accessibleDescription() const;
408 void setAccessibleDescription(const QString &description);
409 QString accessibleIdentifier() const;
410 void setAccessibleIdentifier(const QString &identifier);
411#endif
412
413 void setLayoutDirection(Qt::LayoutDirection direction);
414 Qt::LayoutDirection layoutDirection() const;
415 void unsetLayoutDirection();
416
417 void setLocale(const QLocale &locale);
418 QLocale locale() const;
419 void unsetLocale();
420
421 inline bool isRightToLeft() const { return layoutDirection() == Qt::RightToLeft; }
422 inline bool isLeftToRight() const { return layoutDirection() == Qt::LeftToRight; }
423
424public Q_SLOTS:
425 inline void setFocus() { setFocus(Qt::OtherFocusReason); }
426
427public:
428 bool isActiveWindow() const;
429 void activateWindow();
430 void clearFocus();
431
432 void setFocus(Qt::FocusReason reason);
433 Qt::FocusPolicy focusPolicy() const;
434 void setFocusPolicy(Qt::FocusPolicy policy);
435 bool hasFocus() const;
436 static void setTabOrder(QWidget *, QWidget *);
437 static void setTabOrder(std::initializer_list<QWidget *> widgets);
438 void setFocusProxy(QWidget *);
439 QWidget *focusProxy() const;
440 Qt::ContextMenuPolicy contextMenuPolicy() const;
441 void setContextMenuPolicy(Qt::ContextMenuPolicy policy);
442
443 // Grab functions
444 void grabMouse();
445#ifndef QT_NO_CURSOR
446 void grabMouse(const QCursor &);
447#endif
448 void releaseMouse();
449 void grabKeyboard();
450 void releaseKeyboard();
451#ifndef QT_NO_SHORTCUT
452 int grabShortcut(const QKeySequence &key, Qt::ShortcutContext context = Qt::WindowShortcut);
453 void releaseShortcut(int id);
454 void setShortcutEnabled(int id, bool enable = true);
455 void setShortcutAutoRepeat(int id, bool enable = true);
456#endif
457 static QWidget *mouseGrabber();
458 static QWidget *keyboardGrabber();
459
460 // Update/refresh functions
461 inline bool updatesEnabled() const;
462 void setUpdatesEnabled(bool enable);
463
464#if QT_CONFIG(graphicsview)
465 QGraphicsProxyWidget *graphicsProxyWidget() const;
466#endif
467
468public Q_SLOTS:
469 void update();
470 void repaint();
471
472public:
473 inline void update(int x, int y, int w, int h);
474 void update(const QRect&);
475 void update(const QRegion&);
476
477 void repaint(int x, int y, int w, int h);
478 void repaint(const QRect &);
479 void repaint(const QRegion &);
480
481public Q_SLOTS:
482 // Widget management functions
483
484 virtual void setVisible(bool visible);
485 void setHidden(bool hidden);
486 void show();
487 void hide();
488
489 void showMinimized();
490 void showMaximized();
491 void showFullScreen();
492 void showNormal();
493
494 bool close();
495 void raise();
496 void lower();
497
498public:
499 void stackUnder(QWidget*);
500 void move(int x, int y);
501 void move(const QPoint &);
502 void resize(int w, int h);
503 void resize(const QSize &);
504 inline void setGeometry(int x, int y, int w, int h);
505 void setGeometry(const QRect &);
506 QByteArray saveGeometry() const;
507 bool restoreGeometry(const QByteArray &geometry);
508 void adjustSize();
509 bool isVisible() const;
510 bool isVisibleTo(const QWidget *) const;
511 inline bool isHidden() const;
512
513 bool isMinimized() const;
514 bool isMaximized() const;
515 bool isFullScreen() const;
516
517 Qt::WindowStates windowState() const;
518 void setWindowState(Qt::WindowStates state);
519 void overrideWindowState(Qt::WindowStates state);
520
521 virtual QSize sizeHint() const;
522 virtual QSize minimumSizeHint() const;
523
524 QSizePolicy sizePolicy() const;
525 void setSizePolicy(QSizePolicy);
526 inline void setSizePolicy(QSizePolicy::Policy horizontal, QSizePolicy::Policy vertical);
527 virtual int heightForWidth(int) const;
528 virtual bool hasHeightForWidth() const;
529
530 QRegion visibleRegion() const;
531
532 void setContentsMargins(int left, int top, int right, int bottom);
533 void setContentsMargins(const QMargins &margins);
534 QMargins contentsMargins() const;
535
536 QRect contentsRect() const;
537
538public:
539 QLayout *layout() const;
540 void setLayout(QLayout *);
541 void updateGeometry();
542
543 void setParent(QWidget *parent);
544 void setParent(QWidget *parent, Qt::WindowFlags f);
545
546 void scroll(int dx, int dy);
547 void scroll(int dx, int dy, const QRect&);
548
549 // Misc. functions
550
551 QWidget *focusWidget() const;
552 QWidget *nextInFocusChain() const;
553 QWidget *previousInFocusChain() const;
554
555 // drag and drop
556 bool acceptDrops() const;
557 void setAcceptDrops(bool on);
558
559#ifndef QT_NO_ACTION
560 //actions
561 void addAction(QAction *action);
562 void addActions(const QList<QAction*> &actions);
563 void insertActions(QAction *before, const QList<QAction*> &actions);
564 void insertAction(QAction *before, QAction *action);
565 void removeAction(QAction *action);
566 QList<QAction*> actions() const;
567
568 // convenience action factories
569 QAction *addAction(const QString &text);
570 QAction *addAction(const QIcon &icon, const QString &text);
571 QAction *addAction(const QString &text, const QObject *receiver,
572 const char *member, Qt::ConnectionType type = Qt::AutoConnection);
573 QAction *addAction(const QIcon &icon, const QString &text, const QObject *receiver,
574 const char *member, Qt::ConnectionType type = Qt::AutoConnection);
575 template <typename...Args, typename = compatible_action_slot_args<Args...>>
576 QAction *addAction(const QString &text, Args&&...args)
577 {
578 QAction *result = addAction(text);
579 connect(result, &QAction::triggered, std::forward<Args>(args)...);
580 return result;
581 }
582 template <typename...Args, typename = compatible_action_slot_args<Args...>>
583 QAction *addAction(const QIcon &icon, const QString &text, Args&&...args)
584 {
585 QAction *result = addAction(icon, text);
586 connect(result, &QAction::triggered, std::forward<Args>(args)...);
587 return result;
588 }
589
590#if QT_CONFIG(shortcut)
591 QAction *addAction(const QString &text, const QKeySequence &shortcut);
592 QAction *addAction(const QIcon &icon, const QString &text, const QKeySequence &shortcut);
593 QAction *addAction(const QString &text, const QKeySequence &shortcut,
594 const QObject *receiver, const char *member,
595 Qt::ConnectionType type = Qt::AutoConnection);
596 QAction *addAction(const QIcon &icon, const QString &text, const QKeySequence &shortcut,
597 const QObject *receiver, const char *member,
598 Qt::ConnectionType type = Qt::AutoConnection);
599
600 template <typename...Args, typename = compatible_action_slot_args<Args...>>
601 QAction *addAction(const QString &text, const QKeySequence &shortcut, Args&&...args)
602 {
603 QAction *result = addAction(text, shortcut);
604 connect(result, &QAction::triggered, std::forward<Args>(args)...);
605 return result;
606 }
607 template <typename...Args, typename = compatible_action_slot_args<Args...>>
608 QAction *addAction(const QIcon &icon, const QString &text, const QKeySequence &shortcut, Args&&...args)
609 {
610 QAction *result = addAction(icon, text, shortcut);
611 connect(result, &QAction::triggered, std::forward<Args>(args)...);
612 return result;
613 }
614#endif // QT_CONFIG(shortcut)
615#endif // QT_NO_ACTION
616
617 QWidget *parentWidget() const;
618
619 void setWindowFlags(Qt::WindowFlags type);
620 inline Qt::WindowFlags windowFlags() const;
621 void setWindowFlag(Qt::WindowType, bool on = true);
622 void overrideWindowFlags(Qt::WindowFlags type);
623
624 inline Qt::WindowType windowType() const;
625
626 static QWidget *find(WId);
627 inline QWidget *childAt(int x, int y) const;
628 QWidget *childAt(const QPoint &p) const;
629 QWidget *childAt(const QPointF &p) const;
630
631 void setAttribute(Qt::WidgetAttribute, bool on = true);
632 inline bool testAttribute(Qt::WidgetAttribute) const;
633
634 QPaintEngine *paintEngine() const override;
635
636 void ensurePolished() const;
637
638 bool isAncestorOf(const QWidget *child) const;
639
640#ifdef QT_KEYPAD_NAVIGATION
641 bool hasEditFocus() const;
642 void setEditFocus(bool on);
643#endif
644
645 bool autoFillBackground() const;
646 void setAutoFillBackground(bool enabled);
647
648 QBackingStore *backingStore() const;
649
650 QWindow *windowHandle() const;
651 QScreen *screen() const;
652 void setScreen(QScreen *);
653
654 static QWidget *createWindowContainer(QWindow *window, QWidget *parent=nullptr, Qt::WindowFlags flags=Qt::WindowFlags());
655
656Q_SIGNALS:
657 void windowTitleChanged(const QString &title);
658 void windowIconChanged(const QIcon &icon);
659 void windowIconTextChanged(const QString &iconText);
660 void customContextMenuRequested(const QPoint &pos);
661
662protected:
663 // Event handlers
664 bool event(QEvent *event) override;
665 virtual void mousePressEvent(QMouseEvent *event);
666 virtual void mouseReleaseEvent(QMouseEvent *event);
667 virtual void mouseDoubleClickEvent(QMouseEvent *event);
668 virtual void mouseMoveEvent(QMouseEvent *event);
669#if QT_CONFIG(wheelevent)
670 virtual void wheelEvent(QWheelEvent *event);
671#endif
672 virtual void keyPressEvent(QKeyEvent *event);
673 virtual void keyReleaseEvent(QKeyEvent *event);
674 virtual void focusInEvent(QFocusEvent *event);
675 virtual void focusOutEvent(QFocusEvent *event);
676 virtual void enterEvent(QEnterEvent *event);
677 virtual void leaveEvent(QEvent *event);
678 virtual void paintEvent(QPaintEvent *event);
679 virtual void moveEvent(QMoveEvent *event);
680 virtual void resizeEvent(QResizeEvent *event);
681 virtual void closeEvent(QCloseEvent *event);
682#ifndef QT_NO_CONTEXTMENU
683 virtual void contextMenuEvent(QContextMenuEvent *event);
684#endif
685#if QT_CONFIG(tabletevent)
686 virtual void tabletEvent(QTabletEvent *event);
687#endif
688#ifndef QT_NO_ACTION
689 virtual void actionEvent(QActionEvent *event);
690#endif
691
692#if QT_CONFIG(draganddrop)
693 virtual void dragEnterEvent(QDragEnterEvent *event);
694 virtual void dragMoveEvent(QDragMoveEvent *event);
695 virtual void dragLeaveEvent(QDragLeaveEvent *event);
696 virtual void dropEvent(QDropEvent *event);
697#endif
698
699 virtual void showEvent(QShowEvent *event);
700 virtual void hideEvent(QHideEvent *event);
701
702 virtual bool nativeEvent(const QByteArray &eventType, void *message, qintptr *result);
703
704 // Misc. protected functions
705 virtual void changeEvent(QEvent *);
706
707 int metric(PaintDeviceMetric) const override;
708 void initPainter(QPainter *painter) const override;
709 QPaintDevice *redirected(QPoint *offset) const override;
710 QPainter *sharedPainter() const override;
711
712 virtual void inputMethodEvent(QInputMethodEvent *);
713public:
714 virtual QVariant inputMethodQuery(Qt::InputMethodQuery) const;
715
716 Qt::InputMethodHints inputMethodHints() const;
717 void setInputMethodHints(Qt::InputMethodHints hints);
718
719protected Q_SLOTS:
720 void updateMicroFocus(Qt::InputMethodQuery query = Qt::ImQueryAll);
721protected:
722
723 void create(WId = 0, bool initializeWindow = true,
724 bool destroyOldWindow = true);
725 void destroy(bool destroyWindow = true,
726 bool destroySubWindows = true);
727
728 friend class QDataWidgetMapperPrivate; // for access to focusNextPrevChild
729 virtual bool focusNextPrevChild(bool next);
730 inline bool focusNextChild() { return focusNextPrevChild(next: true); }
731 inline bool focusPreviousChild() { return focusNextPrevChild(next: false); }
732
733protected:
734 QWidget(QWidgetPrivate &d, QWidget* parent, Qt::WindowFlags f);
735private:
736 void setBackingStore(QBackingStore *store);
737
738 bool testAttribute_helper(Qt::WidgetAttribute) const;
739
740 QLayout *takeLayout();
741
742 friend class QBackingStoreDevice;
743 friend class QWidgetRepaintManager;
744 friend class QApplication;
745 friend class QApplicationPrivate;
746 friend class QGuiApplication;
747 friend class QGuiApplicationPrivate;
748 friend class QBaseApplication;
749 friend class QPainter;
750 friend class QPainterPrivate;
751 friend class QPixmap; // for QPixmap::fill()
752 friend class QFontMetrics;
753 friend class QFontInfo;
754 friend class QLayout;
755 friend class QWidgetItem;
756 friend class QWidgetItemV2;
757 friend class QX11PaintEngine;
758 friend class QWin32PaintEngine;
759 friend class QShortcutPrivate;
760 friend class QWindowSurface;
761 friend class QGraphicsProxyWidget;
762 friend class QGraphicsProxyWidgetPrivate;
763 friend class QStyleSheetStyle;
764 friend struct QWidgetExceptionCleaner;
765 friend class QWidgetWindow;
766 friend class QAccessibleWidget;
767 friend class QAccessibleTable;
768 friend class QAccessibleTabButton;
769#ifndef QT_NO_GESTURES
770 friend class QGestureManager;
771 friend class QWinNativePanGestureRecognizer;
772#endif // QT_NO_GESTURES
773 friend class QWidgetEffectSourcePrivate;
774
775 friend Q_WIDGETS_EXPORT QWidgetData *qt_qwidget_data(QWidget *widget);
776 friend Q_WIDGETS_EXPORT QWidgetPrivate *qt_widget_private(QWidget *widget);
777
778private:
779 Q_DISABLE_COPY(QWidget)
780 Q_PRIVATE_SLOT(d_func(), void _q_showIfNotHidden())
781 Q_PRIVATE_SLOT(d_func(), QWindow *_q_closestWindowHandle())
782
783 QWidgetData *data;
784};
785
786Q_DECLARE_OPERATORS_FOR_FLAGS(QWidget::RenderFlags)
787
788#ifndef Q_QDOC
789template <> inline QWidget *qobject_cast<QWidget*>(QObject *o)
790{
791 if (!o || !o->isWidgetType()) return nullptr;
792 return static_cast<QWidget*>(o);
793}
794template <> inline const QWidget *qobject_cast<const QWidget*>(const QObject *o)
795{
796 if (!o || !o->isWidgetType()) return nullptr;
797 return static_cast<const QWidget*>(o);
798}
799#endif // !Q_QDOC
800
801inline QWidget *QWidget::childAt(int ax, int ay) const
802{ return childAt(p: QPointF(ax, ay)); }
803
804inline Qt::WindowType QWidget::windowType() const
805{ return static_cast<Qt::WindowType>((data->window_flags & Qt::WindowType_Mask).toInt()); }
806inline Qt::WindowFlags QWidget::windowFlags() const
807{ return data->window_flags; }
808
809#if QT_DEPRECATED_SINCE(6, 1)
810inline bool QWidget::isTopLevel() const
811{ return bool(windowType() & Qt::Window); }
812#endif
813
814inline bool QWidget::isWindow() const
815{ return bool(windowType() & Qt::Window); }
816
817inline bool QWidget::isEnabled() const
818{ return !testAttribute(Qt::WA_Disabled); }
819
820inline bool QWidget::isModal() const
821{ return data->window_modality != Qt::NonModal; }
822
823inline int QWidget::minimumWidth() const
824{ return minimumSize().width(); }
825
826inline int QWidget::minimumHeight() const
827{ return minimumSize().height(); }
828
829inline int QWidget::maximumWidth() const
830{ return maximumSize().width(); }
831
832inline int QWidget::maximumHeight() const
833{ return maximumSize().height(); }
834
835inline void QWidget::setMinimumSize(const QSize &s)
836{ setMinimumSize(minw: s.width(),minh: s.height()); }
837
838inline void QWidget::setMaximumSize(const QSize &s)
839{ setMaximumSize(maxw: s.width(),maxh: s.height()); }
840
841inline void QWidget::setSizeIncrement(const QSize &s)
842{ setSizeIncrement(w: s.width(),h: s.height()); }
843
844inline void QWidget::setBaseSize(const QSize &s)
845{ setBaseSize(basew: s.width(),baseh: s.height()); }
846
847inline const QFont &QWidget::font() const
848{ return data->fnt; }
849
850inline QFontMetrics QWidget::fontMetrics() const
851{ return QFontMetrics(data->fnt); }
852
853inline QFontInfo QWidget::fontInfo() const
854{ return QFontInfo(data->fnt); }
855
856inline void QWidget::setMouseTracking(bool enable)
857{ setAttribute(Qt::WA_MouseTracking, on: enable); }
858
859inline bool QWidget::hasMouseTracking() const
860{ return testAttribute(Qt::WA_MouseTracking); }
861
862inline bool QWidget::underMouse() const
863{ return testAttribute(Qt::WA_UnderMouse); }
864
865inline void QWidget::setTabletTracking(bool enable)
866{ setAttribute(Qt::WA_TabletTracking, on: enable); }
867
868inline bool QWidget::hasTabletTracking() const
869{ return testAttribute(Qt::WA_TabletTracking); }
870
871inline bool QWidget::updatesEnabled() const
872{ return !testAttribute(Qt::WA_UpdatesDisabled); }
873
874inline void QWidget::update(int ax, int ay, int aw, int ah)
875{ update(QRect(ax, ay, aw, ah)); }
876
877inline bool QWidget::isVisible() const
878{ return testAttribute(Qt::WA_WState_Visible); }
879
880inline bool QWidget::isHidden() const
881{ return testAttribute(Qt::WA_WState_Hidden); }
882
883inline void QWidget::move(int ax, int ay)
884{ move(QPoint(ax, ay)); }
885
886inline void QWidget::resize(int w, int h)
887{ resize(QSize(w, h)); }
888
889inline void QWidget::setGeometry(int ax, int ay, int aw, int ah)
890{ setGeometry(QRect(ax, ay, aw, ah)); }
891
892inline QRect QWidget::rect() const
893{ return QRect(0,0,data->crect.width(),data->crect.height()); }
894
895inline const QRect &QWidget::geometry() const
896{ return data->crect; }
897
898inline QSize QWidget::size() const
899{ return data->crect.size(); }
900
901inline int QWidget::width() const
902{ return data->crect.width(); }
903
904inline int QWidget::height() const
905{ return data->crect.height(); }
906
907inline QWidget *QWidget::parentWidget() const
908{ return static_cast<QWidget *>(QObject::parent()); }
909
910inline void QWidget::setSizePolicy(QSizePolicy::Policy hor, QSizePolicy::Policy ver)
911{ setSizePolicy(QSizePolicy(hor, ver)); }
912
913inline bool QWidget::testAttribute(Qt::WidgetAttribute attribute) const
914{
915 if (attribute < int(8*sizeof(uint)))
916 return data->widget_attributes & (1<<attribute);
917 return testAttribute_helper(attribute);
918}
919
920#define QWIDGETSIZE_MAX ((1<<24)-1)
921
922#ifndef QT_NO_DEBUG_STREAM
923Q_WIDGETS_EXPORT QDebug operator<<(QDebug, const QWidget *);
924#endif
925
926QT_END_NAMESPACE
927
928#endif // QWIDGET_H
929

source code of qtbase/src/widgets/kernel/qwidget.h