source: trunk/src/gui/kernel/qwidget.h@ 705

Last change on this file since 705 was 705, checked in by Dmitry A. Kuminov, 15 years ago

gui: Added QWidget::addPmEventFilter()/removPmEventFilter() (OS/2 specific).
File size: 37.8 KB
Line 
1/****************************************************************************
2**
3** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
4** All rights reserved.
5** Contact: Nokia Corporation (qt-info@nokia.com)
6**
7** This file is part of the QtGui module of the Qt Toolkit.
8**
9** $QT_BEGIN_LICENSE:LGPL$
10** Commercial Usage
11** Licensees holding valid Qt Commercial licenses may use this file in
12** accordance with the Qt Commercial License Agreement provided with the
13** Software or, alternatively, in accordance with the terms contained in
14** a written agreement between you and Nokia.
15**
16** GNU Lesser General Public License Usage
17** Alternatively, this file may be used under the terms of the GNU Lesser
18** General Public License version 2.1 as published by the Free Software
19** Foundation and appearing in the file LICENSE.LGPL included in the
20** packaging of this file. Please review the following information to
21** ensure the GNU Lesser General Public License version 2.1 requirements
22** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
23**
24** In addition, as a special exception, Nokia gives you certain additional
25** rights. These rights are described in the Nokia Qt LGPL Exception
26** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
27**
28** GNU General Public License Usage
29** Alternatively, this file may be used under the terms of the GNU
30** General Public License version 3.0 as published by the Free Software
31** Foundation and appearing in the file LICENSE.GPL included in the
32** packaging of this file. Please review the following information to
33** ensure the GNU General Public License version 3.0 requirements will be
34** met: http://www.gnu.org/copyleft/gpl.html.
35**
36** If you have questions regarding the use of this file, please contact
37** Nokia at qt-info@nokia.com.
38** $QT_END_LICENSE$
39**
40****************************************************************************/
41
42#ifndef QWIDGET_H
43#define QWIDGET_H
44
45#include <QtGui/qwindowdefs.h>
46#include <QtCore/qobject.h>
47#include <QtCore/qmargins.h>
48#include <QtGui/qpaintdevice.h>
49#include <QtGui/qpalette.h>
50#include <QtGui/qfont.h>
51#include <QtGui/qfontmetrics.h>
52#include <QtGui/qfontinfo.h>
53#include <QtGui/qsizepolicy.h>
54#include <QtGui/qregion.h>
55#include <QtGui/qbrush.h>
56#include <QtGui/qcursor.h>
57#include <QtGui/qkeysequence.h>
58
59#ifdef QT_INCLUDE_COMPAT
60#include <QtGui/qevent.h>
61#endif
62
63QT_BEGIN_HEADER
64
65QT_BEGIN_NAMESPACE
66
67QT_MODULE(Gui)
68
69class QLayout;
70class QWSRegionManager;
71class QStyle;
72class QAction;
73class QVariant;
74
75class QActionEvent;
76class QMouseEvent;
77class QWheelEvent;
78class QHoverEvent;
79class QKeyEvent;
80class QFocusEvent;
81class QPaintEvent;
82class QMoveEvent;
83class QResizeEvent;
84class QCloseEvent;
85class QContextMenuEvent;
86class QInputMethodEvent;
87class QTabletEvent;
88class QDragEnterEvent;
89class QDragMoveEvent;
90class QDragLeaveEvent;
91class QDropEvent;
92class QShowEvent;
93class QHideEvent;
94class QInputContext;
95class QIcon;
96class QWindowSurface;
97class QLocale;
98class QGraphicsProxyWidget;
99class QGraphicsEffect;
100#if defined(Q_WS_X11)
101class QX11Info;
102#endif
103
104class QWidgetData
105{
106public:
107 WId winid;
108 uint widget_attributes;
109 Qt::WindowFlags window_flags;
110 uint window_state : 4;
111 uint focus_policy : 4;
112 uint sizehint_forced :1;
113 uint is_closing :1;
114 uint in_show : 1;
115 uint in_set_window_state : 1;
116 mutable uint fstrut_dirty : 1;
117 uint context_menu_policy : 3;
118 uint window_modality : 2;
119 uint in_destructor : 1;
120 uint unused : 13;
121 QRect crect;
122 mutable QPalette pal;
123 QFont fnt;
124#if defined(Q_WS_QWS)
125// QRegion req_region; // Requested region
126// mutable QRegion paintable_region; // Paintable region
127// mutable bool paintable_region_dirty;// needs to be recalculated
128// mutable QRegion alloc_region; // Allocated region
129// mutable bool alloc_region_dirty; // needs to be recalculated
130// mutable int overlapping_children; // Handle overlapping children
131
132 int alloc_region_index;
133// int alloc_region_revision;
134#endif
135 QRect wrect;
136};
137
138class QWidgetPrivate;
139
140class Q_GUI_EXPORT QWidget : public QObject, public QPaintDevice
141{
142 Q_OBJECT
143 Q_DECLARE_PRIVATE(QWidget)
144
145 Q_PROPERTY(bool modal READ isModal)
146 Q_PROPERTY(Qt::WindowModality windowModality READ windowModality WRITE setWindowModality)
147 Q_PROPERTY(bool enabled READ isEnabled WRITE setEnabled)
148 Q_PROPERTY(QRect geometry READ geometry WRITE setGeometry)
149 Q_PROPERTY(QRect frameGeometry READ frameGeometry)
150 Q_PROPERTY(QRect normalGeometry READ normalGeometry)
151 Q_PROPERTY(int x READ x)
152 Q_PROPERTY(int y READ y)
153 Q_PROPERTY(QPoint pos READ pos WRITE move DESIGNABLE false STORED false)
154 Q_PROPERTY(QSize frameSize READ frameSize)
155 Q_PROPERTY(QSize size READ size WRITE resize DESIGNABLE false STORED false)
156 Q_PROPERTY(int width READ width)
157 Q_PROPERTY(int height READ height)
158 Q_PROPERTY(QRect rect READ rect)
159 Q_PROPERTY(QRect childrenRect READ childrenRect)
160 Q_PROPERTY(QRegion childrenRegion READ childrenRegion)
161 Q_PROPERTY(QSizePolicy sizePolicy READ sizePolicy WRITE setSizePolicy)
162 Q_PROPERTY(QSize minimumSize READ minimumSize WRITE setMinimumSize)
163 Q_PROPERTY(QSize maximumSize READ maximumSize WRITE setMaximumSize)
164 Q_PROPERTY(int minimumWidth READ minimumWidth WRITE setMinimumWidth STORED false DESIGNABLE false)
165 Q_PROPERTY(int minimumHeight READ minimumHeight WRITE setMinimumHeight STORED false DESIGNABLE false)
166 Q_PROPERTY(int maximumWidth READ maximumWidth WRITE setMaximumWidth STORED false DESIGNABLE false)
167 Q_PROPERTY(int maximumHeight READ maximumHeight WRITE setMaximumHeight STORED false DESIGNABLE false)
168 Q_PROPERTY(QSize sizeIncrement READ sizeIncrement WRITE setSizeIncrement)
169 Q_PROPERTY(QSize baseSize READ baseSize WRITE setBaseSize)
170 Q_PROPERTY(QPalette palette READ palette WRITE setPalette)
171 Q_PROPERTY(QFont font READ font WRITE setFont)
172#ifndef QT_NO_CURSOR
173 Q_PROPERTY(QCursor cursor READ cursor WRITE setCursor RESET unsetCursor)
174#endif
175 Q_PROPERTY(bool mouseTracking READ hasMouseTracking WRITE setMouseTracking)
176 Q_PROPERTY(bool isActiveWindow READ isActiveWindow)
177 Q_PROPERTY(Qt::FocusPolicy focusPolicy READ focusPolicy WRITE setFocusPolicy)
178 Q_PROPERTY(bool focus READ hasFocus)
179 Q_PROPERTY(Qt::ContextMenuPolicy contextMenuPolicy READ contextMenuPolicy WRITE setContextMenuPolicy)
180 Q_PROPERTY(bool updatesEnabled READ updatesEnabled WRITE setUpdatesEnabled DESIGNABLE false)
181 Q_PROPERTY(bool visible READ isVisible WRITE setVisible DESIGNABLE false)
182 Q_PROPERTY(bool minimized READ isMinimized)
183 Q_PROPERTY(bool maximized READ isMaximized)
184 Q_PROPERTY(bool fullScreen READ isFullScreen)
185 Q_PROPERTY(QSize sizeHint READ sizeHint)
186 Q_PROPERTY(QSize minimumSizeHint READ minimumSizeHint)
187 Q_PROPERTY(bool acceptDrops READ acceptDrops WRITE setAcceptDrops)
188 Q_PROPERTY(QString windowTitle READ windowTitle WRITE setWindowTitle DESIGNABLE isWindow)
189 Q_PROPERTY(QIcon windowIcon READ windowIcon WRITE setWindowIcon DESIGNABLE isWindow)
190 Q_PROPERTY(QString windowIconText READ windowIconText WRITE setWindowIconText DESIGNABLE isWindow)
191 Q_PROPERTY(double windowOpacity READ windowOpacity WRITE setWindowOpacity DESIGNABLE isWindow)
192 Q_PROPERTY(bool windowModified READ isWindowModified WRITE setWindowModified DESIGNABLE isWindow)
193#ifndef QT_NO_TOOLTIP
194 Q_PROPERTY(QString toolTip READ toolTip WRITE setToolTip)
195#endif
196#ifndef QT_NO_STATUSTIP
197 Q_PROPERTY(QString statusTip READ statusTip WRITE setStatusTip)
198#endif
199#ifndef QT_NO_WHATSTHIS
200 Q_PROPERTY(QString whatsThis READ whatsThis WRITE setWhatsThis)
201#endif
202#ifndef QT_NO_ACCESSIBILITY
203 Q_PROPERTY(QString accessibleName READ accessibleName WRITE setAccessibleName)
204 Q_PROPERTY(QString accessibleDescription READ accessibleDescription WRITE setAccessibleDescription)
205#endif
206 Q_PROPERTY(Qt::LayoutDirection layoutDirection READ layoutDirection WRITE setLayoutDirection RESET unsetLayoutDirection)
207 QDOC_PROPERTY(Qt::WindowFlags windowFlags READ windowFlags WRITE setWindowFlags)
208 Q_PROPERTY(bool autoFillBackground READ autoFillBackground WRITE setAutoFillBackground)
209#ifndef QT_NO_STYLE_STYLESHEET
210 Q_PROPERTY(QString styleSheet READ styleSheet WRITE setStyleSheet)
211#endif
212 Q_PROPERTY(QLocale locale READ locale WRITE setLocale RESET unsetLocale)
213 Q_PROPERTY(QString windowFilePath READ windowFilePath WRITE setWindowFilePath DESIGNABLE isWindow)
214 Q_PROPERTY(Qt::InputMethodHints inputMethodHints READ inputMethodHints WRITE setInputMethodHints)
215
216public:
217 enum RenderFlag {
218 DrawWindowBackground = 0x1,
219 DrawChildren = 0x2,
220 IgnoreMask = 0x4
221 };
222 Q_DECLARE_FLAGS(RenderFlags, RenderFlag)
223
224 explicit QWidget(QWidget* parent = 0, Qt::WindowFlags f = 0);
225#ifdef QT3_SUPPORT
226 QT3_SUPPORT_CONSTRUCTOR QWidget(QWidget* parent, const char *name, Qt::WindowFlags f = 0);
227#endif
228 ~QWidget();
229
230 int devType() const;
231
232 WId winId() const;
233 void createWinId(); // internal, going away
234 inline WId internalWinId() const { return data->winid; }
235 WId effectiveWinId() const;
236
237 // GUI style setting
238 QStyle *style() const;
239 void setStyle(QStyle *);
240 // Widget types and states
241
242 bool isTopLevel() const;
243 bool isWindow() const;
244
245 bool isModal() const;
246 Qt::WindowModality windowModality() const;
247 void setWindowModality(Qt::WindowModality windowModality);
248
249 bool isEnabled() const;
250 bool isEnabledTo(QWidget*) const;
251 bool isEnabledToTLW() const;
252
253public Q_SLOTS:
254 void setEnabled(bool);
255 void setDisabled(bool);
256 void setWindowModified(bool);
257
258 // Widget coordinates
259
260public:
261 QRect frameGeometry() const;
262 const QRect &geometry() const;
263 QRect normalGeometry() const;
264
265 int x() const;
266 int y() const;
267 QPoint pos() const;
268 QSize frameSize() const;
269 QSize size() const;
270 inline int width() const;
271 inline int height() const;
272 inline QRect rect() const;
273 QRect childrenRect() const;
274 QRegion childrenRegion() const;
275
276 QSize minimumSize() const;
277 QSize maximumSize() const;
278 int minimumWidth() const;
279 int minimumHeight() const;
280 int maximumWidth() const;
281 int maximumHeight() const;
282 void setMinimumSize(const QSize &);
283 void setMinimumSize(int minw, int minh);
284 void setMaximumSize(const QSize &);
285 void setMaximumSize(int maxw, int maxh);
286 void setMinimumWidth(int minw);
287 void setMinimumHeight(int minh);
288 void setMaximumWidth(int maxw);
289 void setMaximumHeight(int maxh);
290
291#ifdef Q_QDOC
292 void setupUi(QWidget *widget);
293#endif
294
295 QSize sizeIncrement() const;
296 void setSizeIncrement(const QSize &);
297 void setSizeIncrement(int w, int h);
298 QSize baseSize() const;
299 void setBaseSize(const QSize &);
300 void setBaseSize(int basew, int baseh);
301
302 void setFixedSize(const QSize &);
303 void setFixedSize(int w, int h);
304 void setFixedWidth(int w);
305 void setFixedHeight(int h);
306
307 // Widget coordinate mapping
308
309 QPoint mapToGlobal(const QPoint &) const;
310 QPoint mapFromGlobal(const QPoint &) const;
311 QPoint mapToParent(const QPoint &) const;
312 QPoint mapFromParent(const QPoint &) const;
313 QPoint mapTo(QWidget *, const QPoint &) const;
314 QPoint mapFrom(QWidget *, const QPoint &) const;
315
316 QWidget *window() const;
317 QWidget *nativeParentWidget() const;
318 inline QWidget *topLevelWidget() const { return window(); }
319
320 // Widget appearance functions
321 const QPalette &palette() const;
322 void setPalette(const QPalette &);
323
324 void setBackgroundRole(QPalette::ColorRole);
325 QPalette::ColorRole backgroundRole() const;
326
327 void setForegroundRole(QPalette::ColorRole);
328 QPalette::ColorRole foregroundRole() const;
329
330 const QFont &font() const;
331 void setFont(const QFont &);
332 QFontMetrics fontMetrics() const;
333 QFontInfo fontInfo() const;
334
335#ifndef QT_NO_CURSOR
336 QCursor cursor() const;
337 void setCursor(const QCursor &);
338 void unsetCursor();
339#endif
340
341 void setMouseTracking(bool enable);
342 bool hasMouseTracking() const;
343 bool underMouse() const;
344
345 void setMask(const QBitmap &);
346 void setMask(const QRegion &);
347 QRegion mask() const;
348 void clearMask();
349
350 void render(QPaintDevice *target, const QPoint &targetOffset = QPoint(),
351 const QRegion &sourceRegion = QRegion(),
352 RenderFlags renderFlags = RenderFlags(DrawWindowBackground | DrawChildren));
353
354 void render(QPainter *painter, const QPoint &targetOffset = QPoint(),
355 const QRegion &sourceRegion = QRegion(),
356 RenderFlags renderFlags = RenderFlags(DrawWindowBackground | DrawChildren));
357
358#ifndef QT_NO_GRAPHICSEFFECT
359 QGraphicsEffect *graphicsEffect() const;
360 void setGraphicsEffect(QGraphicsEffect *effect);
361#endif //QT_NO_GRAPHICSEFFECT
362
363 void grabGesture(Qt::GestureType type, Qt::GestureFlags flags = Qt::GestureFlags());
364 void ungrabGesture(Qt::GestureType type);
365
366public Q_SLOTS:
367 void setWindowTitle(const QString &);
368#ifndef QT_NO_STYLE_STYLESHEET
369 void setStyleSheet(const QString& styleSheet);
370#endif
371public:
372#ifndef QT_NO_STYLE_STYLESHEET
373 QString styleSheet() const;
374#endif
375 QString windowTitle() const;
376 void setWindowIcon(const QIcon &icon);
377 QIcon windowIcon() const;
378 void setWindowIconText(const QString &);
379 QString windowIconText() const;
380 void setWindowRole(const QString &);
381 QString windowRole() const;
382 void setWindowFilePath(const QString &filePath);
383 QString windowFilePath() const;
384
385 void setWindowOpacity(qreal level);
386 qreal windowOpacity() const;
387
388 bool isWindowModified() const;
389#ifndef QT_NO_TOOLTIP
390 void setToolTip(const QString &);
391 QString toolTip() const;
392#endif
393#ifndef QT_NO_STATUSTIP
394 void setStatusTip(const QString &);
395 QString statusTip() const;
396#endif
397#ifndef QT_NO_WHATSTHIS
398 void setWhatsThis(const QString &);
399 QString whatsThis() const;
400#endif
401#ifndef QT_NO_ACCESSIBILITY
402 QString accessibleName() const;
403 void setAccessibleName(const QString &name);
404 QString accessibleDescription() const;
405 void setAccessibleDescription(const QString &description);
406#endif
407
408 void setLayoutDirection(Qt::LayoutDirection direction);
409 Qt::LayoutDirection layoutDirection() const;
410 void unsetLayoutDirection();
411
412 void setLocale(const QLocale &locale);
413 QLocale locale() const;
414 void unsetLocale();
415
416 inline bool isRightToLeft() const { return layoutDirection() == Qt::RightToLeft; }
417 inline bool isLeftToRight() const { return layoutDirection() == Qt::LeftToRight; }
418
419public Q_SLOTS:
420 inline void setFocus() { setFocus(Qt::OtherFocusReason); }
421
422public:
423 bool isActiveWindow() const;
424 void activateWindow();
425 void clearFocus();
426
427 void setFocus(Qt::FocusReason reason);
428 Qt::FocusPolicy focusPolicy() const;
429 void setFocusPolicy(Qt::FocusPolicy policy);
430 bool hasFocus() const;
431 static void setTabOrder(QWidget *, QWidget *);
432 void setFocusProxy(QWidget *);
433 QWidget *focusProxy() const;
434 Qt::ContextMenuPolicy contextMenuPolicy() const;
435 void setContextMenuPolicy(Qt::ContextMenuPolicy policy);
436
437 // Grab functions
438 void grabMouse();
439#ifndef QT_NO_CURSOR
440 void grabMouse(const QCursor &);
441#endif
442 void releaseMouse();
443 void grabKeyboard();
444 void releaseKeyboard();
445#ifndef QT_NO_SHORTCUT
446 int grabShortcut(const QKeySequence &key, Qt::ShortcutContext context = Qt::WindowShortcut);
447 void releaseShortcut(int id);
448 void setShortcutEnabled(int id, bool enable = true);
449 void setShortcutAutoRepeat(int id, bool enable = true);
450#endif
451 static QWidget *mouseGrabber();
452 static QWidget *keyboardGrabber();
453
454 // Update/refresh functions
455 inline bool updatesEnabled() const;
456 void setUpdatesEnabled(bool enable);
457
458#if 0 //def Q_WS_QWS
459 void repaintUnclipped(const QRegion &, bool erase = true);
460#endif
461
462#ifndef QT_NO_GRAPHICSVIEW
463 QGraphicsProxyWidget *graphicsProxyWidget() const;
464#endif
465
466public Q_SLOTS:
467 void update();
468 void repaint();
469
470public:
471 inline void update(int x, int y, int w, int h);
472 void update(const QRect&);
473 void update(const QRegion&);
474
475 void repaint(int x, int y, int w, int h);
476 void repaint(const QRect &);
477 void repaint(const QRegion &);
478
479public Q_SLOTS:
480 // Widget management functions
481
482 virtual void setVisible(bool visible);
483 inline void setHidden(bool hidden) { setVisible(!hidden); }
484#ifndef Q_WS_WINCE
485 inline void show() { setVisible(true); }
486#else
487 void show();
488#endif
489 inline void hide() { setVisible(false); }
490 inline QT_MOC_COMPAT void setShown(bool shown) { setVisible(shown); }
491
492 void showMinimized();
493 void showMaximized();
494 void showFullScreen();
495 void showNormal();
496
497 bool close();
498 void raise();
499 void lower();
500
501public:
502 void stackUnder(QWidget*);
503 void move(int x, int y);
504 void move(const QPoint &);
505 void resize(int w, int h);
506 void resize(const QSize &);
507 inline void setGeometry(int x, int y, int w, int h);
508 void setGeometry(const QRect &);
509 QByteArray saveGeometry() const;
510 bool restoreGeometry(const QByteArray &geometry);
511 void adjustSize();
512 bool isVisible() const;
513 bool isVisibleTo(QWidget*) const;
514 // ### Qt 5: bool isVisibleTo(_const_ QWidget *) const
515 inline bool isHidden() const;
516
517 bool isMinimized() const;
518 bool isMaximized() const;
519 bool isFullScreen() const;
520
521 Qt::WindowStates windowState() const;
522 void setWindowState(Qt::WindowStates state);
523 void overrideWindowState(Qt::WindowStates state);
524
525 virtual QSize sizeHint() const;
526 virtual QSize minimumSizeHint() const;
527
528 QSizePolicy sizePolicy() const;
529 void setSizePolicy(QSizePolicy);
530 inline void setSizePolicy(QSizePolicy::Policy horizontal, QSizePolicy::Policy vertical);
531 virtual int heightForWidth(int) const;
532
533 QRegion visibleRegion() const;
534
535 void setContentsMargins(int left, int top, int right, int bottom);
536 void setContentsMargins(const QMargins &margins);
537 void getContentsMargins(int *left, int *top, int *right, int *bottom) const;
538 QMargins contentsMargins() const;
539
540 QRect contentsRect() const;
541
542public:
543 QLayout *layout() const;
544 void setLayout(QLayout *);
545 void updateGeometry();
546
547 void setParent(QWidget *parent);
548 void setParent(QWidget *parent, Qt::WindowFlags f);
549
550 void scroll(int dx, int dy);
551 void scroll(int dx, int dy, const QRect&);
552
553 // Misc. functions
554
555 QWidget *focusWidget() const;
556 QWidget *nextInFocusChain() const;
557 QWidget *previousInFocusChain() const;
558
559 // drag and drop
560 bool acceptDrops() const;
561 void setAcceptDrops(bool on);
562
563#ifndef QT_NO_ACTION
564 //actions
565 void addAction(QAction *action);
566 void addActions(QList<QAction*> actions);
567 void insertAction(QAction *before, QAction *action);
568 void insertActions(QAction *before, QList<QAction*> actions);
569 void removeAction(QAction *action);
570 QList<QAction*> actions() const;
571#endif
572
573 QWidget *parentWidget() const;
574
575 void setWindowFlags(Qt::WindowFlags type);
576 inline Qt::WindowFlags windowFlags() const;
577 void overrideWindowFlags(Qt::WindowFlags type);
578
579 inline Qt::WindowType windowType() const;
580
581 static QWidget *find(WId);
582#ifdef QT3_SUPPORT
583 static QT3_SUPPORT QWidgetMapper *wmapper();
584#endif
585 inline QWidget *childAt(int x, int y) const;
586 QWidget *childAt(const QPoint &p) const;
587
588#if defined(Q_WS_X11)
589 const QX11Info &x11Info() const;
590 Qt::HANDLE x11PictureHandle() const;
591#endif
592
593#if defined(Q_WS_MAC)
594 Qt::HANDLE macQDHandle() const;
595 Qt::HANDLE macCGHandle() const;
596#endif
597
598#if defined(Q_WS_WIN)
599 HDC getDC() const;
600 void releaseDC(HDC) const;
601#elif defined(Q_WS_PM)
602 WId internalFrameWinId() const;
603 WId effectiveFrameWinId() const;
604 HPS getPS() const;
605 void releasePS(HPS) const;
606
607 struct PmEventFilter {
608 virtual bool pmEventFilter(QMSG *message, MRESULT *result) = 0;
609 };
610 void addPmEventFilter(PmEventFilter *filter);
611 void removePmEventFilter(PmEventFilter *filter);
612#else
613 Qt::HANDLE handle() const;
614#endif
615
616 void setAttribute(Qt::WidgetAttribute, bool on = true);
617 inline bool testAttribute(Qt::WidgetAttribute) const;
618
619 QPaintEngine *paintEngine() const;
620
621 void ensurePolished() const;
622
623 QInputContext *inputContext();
624 void setInputContext(QInputContext *);
625
626 bool isAncestorOf(const QWidget *child) const;
627
628#ifdef QT_KEYPAD_NAVIGATION
629 bool hasEditFocus() const;
630 void setEditFocus(bool on);
631#endif
632
633 bool autoFillBackground() const;
634 void setAutoFillBackground(bool enabled);
635
636 void setWindowSurface(QWindowSurface *surface);
637 QWindowSurface *windowSurface() const;
638
639Q_SIGNALS:
640 void customContextMenuRequested(const QPoint &pos);
641
642protected:
643 // Event handlers
644 bool event(QEvent *);
645 virtual void mousePressEvent(QMouseEvent *);
646 virtual void mouseReleaseEvent(QMouseEvent *);
647 virtual void mouseDoubleClickEvent(QMouseEvent *);
648 virtual void mouseMoveEvent(QMouseEvent *);
649#ifndef QT_NO_WHEELEVENT
650 virtual void wheelEvent(QWheelEvent *);
651#endif
652 virtual void keyPressEvent(QKeyEvent *);
653 virtual void keyReleaseEvent(QKeyEvent *);
654 virtual void focusInEvent(QFocusEvent *);
655 virtual void focusOutEvent(QFocusEvent *);
656 virtual void enterEvent(QEvent *);
657 virtual void leaveEvent(QEvent *);
658 virtual void paintEvent(QPaintEvent *);
659 virtual void moveEvent(QMoveEvent *);
660 virtual void resizeEvent(QResizeEvent *);
661 virtual void closeEvent(QCloseEvent *);
662#ifndef QT_NO_CONTEXTMENU
663 virtual void contextMenuEvent(QContextMenuEvent *);
664#endif
665#ifndef QT_NO_TABLETEVENT
666 virtual void tabletEvent(QTabletEvent *);
667#endif
668#ifndef QT_NO_ACTION
669 virtual void actionEvent(QActionEvent *);
670#endif
671
672#ifndef QT_NO_DRAGANDDROP
673 virtual void dragEnterEvent(QDragEnterEvent *);
674 virtual void dragMoveEvent(QDragMoveEvent *);
675 virtual void dragLeaveEvent(QDragLeaveEvent *);
676 virtual void dropEvent(QDropEvent *);
677#endif
678
679 virtual void showEvent(QShowEvent *);
680 virtual void hideEvent(QHideEvent *);
681
682#if defined(Q_WS_MAC)
683 virtual bool macEvent(EventHandlerCallRef, EventRef);
684#endif
685#if defined(Q_WS_WIN)
686 virtual bool winEvent(MSG *message, long *result);
687#endif
688#if defined(Q_WS_PM)
689 virtual bool pmEvent(QMSG *message, MRESULT *result);
690#endif
691#if defined(Q_WS_X11)
692 virtual bool x11Event(XEvent *);
693#endif
694#if defined(Q_WS_QWS)
695 virtual bool qwsEvent(QWSEvent *);
696#endif
697
698 // Misc. protected functions
699 virtual void changeEvent(QEvent *);
700
701 int metric(PaintDeviceMetric) const;
702
703 virtual void inputMethodEvent(QInputMethodEvent *);
704public:
705 virtual QVariant inputMethodQuery(Qt::InputMethodQuery) const;
706
707 Qt::InputMethodHints inputMethodHints() const;
708 void setInputMethodHints(Qt::InputMethodHints hints);
709
710protected:
711 void resetInputContext();
712protected Q_SLOTS:
713 void updateMicroFocus();
714protected:
715
716 void create(WId = 0, bool initializeWindow = true,
717 bool destroyOldWindow = true);
718 void destroy(bool destroyWindow = true,
719 bool destroySubWindows = true);
720
721 virtual bool focusNextPrevChild(bool next);
722 inline bool focusNextChild() { return focusNextPrevChild(true); }
723 inline bool focusPreviousChild() { return focusNextPrevChild(false); }
724
725protected:
726 QWidget(QWidgetPrivate &d, QWidget* parent, Qt::WindowFlags f);
727private:
728
729 bool testAttribute_helper(Qt::WidgetAttribute) const;
730
731 QLayout *takeLayout();
732
733 friend class QBackingStoreDevice;
734 friend class QWidgetBackingStore;
735 friend class QApplication;
736 friend class QApplicationPrivate;
737 friend class QBaseApplication;
738 friend class QPainter;
739 friend class QPainterPrivate;
740 friend class QPixmap; // for QPixmap::fill()
741 friend class QFontMetrics;
742 friend class QFontInfo;
743 friend class QETWidget;
744 friend class QLayout;
745 friend class QWidgetItem;
746 friend class QWidgetItemV2;
747 friend class QGLContext;
748 friend class QGLWidget;
749 friend class QGLWindowSurface;
750 friend class QX11PaintEngine;
751 friend class QWin32PaintEngine;
752 friend class QShortcutPrivate;
753 friend class QShortcutMap;
754 friend class QWindowSurface;
755 friend class QGraphicsProxyWidget;
756 friend class QGraphicsProxyWidgetPrivate;
757 friend class QStyleSheetStyle;
758 friend struct QWidgetExceptionCleaner;
759 friend class QGestureManager;
760 friend class QWinNativePanGestureRecognizer;
761 friend class QWidgetEffectSourcePrivate;
762
763#ifdef Q_WS_MAC
764 friend class QCoreGraphicsPaintEnginePrivate;
765 friend QPoint qt_mac_posInWindow(const QWidget *w);
766 friend OSWindowRef qt_mac_window_for(const QWidget *w);
767 friend bool qt_mac_is_metal(const QWidget *w);
768 friend OSViewRef qt_mac_nativeview_for(const QWidget *w);
769 friend void qt_event_request_window_change(QWidget *widget);
770 friend bool qt_mac_sendMacEventToWidget(QWidget *widget, EventRef ref);
771#endif
772#ifdef Q_WS_QWS
773 friend class QWSBackingStore;
774 friend class QWSManager;
775 friend class QWSManagerPrivate;
776 friend class QDecoration;
777 friend class QWSWindowSurface;
778 friend class QScreen;
779 friend class QVNCScreen;
780 friend bool isWidgetOpaque(const QWidget *);
781 friend class QGLWidgetPrivate;
782#endif
783#ifdef Q_OS_SYMBIAN
784 friend class QSymbianControl;
785 friend class QS60WindowSurface;
786#endif
787#ifdef Q_WS_X11
788 friend void qt_net_update_user_time(QWidget *tlw, unsigned long timestamp);
789 friend void qt_net_remove_user_time(QWidget *tlw);
790#endif
791
792 friend Q_GUI_EXPORT QWidgetData *qt_qwidget_data(QWidget *widget);
793 friend Q_GUI_EXPORT QWidgetPrivate *qt_widget_private(QWidget *widget);
794
795private:
796 Q_DISABLE_COPY(QWidget)
797 Q_PRIVATE_SLOT(d_func(), void _q_showIfNotHidden())
798#ifdef Q_OS_SYMBIAN
799 Q_PRIVATE_SLOT(d_func(), void _q_delayedDestroy(WId winId))
800#endif
801
802 QWidgetData *data;
803
804#ifdef QT3_SUPPORT
805public:
806 inline QT3_SUPPORT bool isUpdatesEnabled() const { return updatesEnabled(); }
807 QT3_SUPPORT QStyle *setStyle(const QString&);
808 inline QT3_SUPPORT bool isVisibleToTLW() const;
809 QT3_SUPPORT QRect visibleRect() const;
810 inline QT3_SUPPORT void iconify() { showMinimized(); }
811 inline QT3_SUPPORT void constPolish() const { ensurePolished(); }
812 inline QT3_SUPPORT void polish() { ensurePolished(); }
813 inline QT3_SUPPORT void reparent(QWidget *parent, Qt::WindowFlags f, const QPoint &p, bool showIt=false)
814 { setParent(parent, f); setGeometry(p.x(),p.y(),width(),height()); if (showIt) show(); }
815 inline QT3_SUPPORT void reparent(QWidget *parent, const QPoint &p, bool showIt=false)
816 { setParent(parent, windowFlags() & ~Qt::WindowType_Mask); setGeometry(p.x(),p.y(),width(),height()); if (showIt) show(); }
817 inline QT3_SUPPORT void recreate(QWidget *parent, Qt::WindowFlags f, const QPoint & p, bool showIt=false)
818 { setParent(parent, f); setGeometry(p.x(),p.y(),width(),height()); if (showIt) show(); }
819 inline QT3_SUPPORT void setSizePolicy(QSizePolicy::Policy hor, QSizePolicy::Policy ver, bool hfw)
820 { QSizePolicy sp(hor, ver); sp.setHeightForWidth(hfw); setSizePolicy(sp);}
821 inline QT3_SUPPORT bool hasMouse() const { return testAttribute(Qt::WA_UnderMouse); }
822#ifndef QT_NO_CURSOR
823 inline QT3_SUPPORT bool ownCursor() const { return testAttribute(Qt::WA_SetCursor); }
824#endif
825 inline QT3_SUPPORT bool ownFont() const { return testAttribute(Qt::WA_SetFont); }
826 inline QT3_SUPPORT void unsetFont() { setFont(QFont()); }
827 inline QT3_SUPPORT bool ownPalette() const { return testAttribute(Qt::WA_SetPalette); }
828 inline QT3_SUPPORT void unsetPalette() { setPalette(QPalette()); }
829 Qt::BackgroundMode QT3_SUPPORT backgroundMode() const;
830 void QT3_SUPPORT setBackgroundMode(Qt::BackgroundMode, Qt::BackgroundMode = Qt::PaletteBackground);
831 const QT3_SUPPORT QColor &eraseColor() const;
832 void QT3_SUPPORT setEraseColor(const QColor &);
833 const QT3_SUPPORT QColor &foregroundColor() const;
834 const QT3_SUPPORT QPixmap *erasePixmap() const;
835 void QT3_SUPPORT setErasePixmap(const QPixmap &);
836 const QT3_SUPPORT QColor &paletteForegroundColor() const;
837 void QT3_SUPPORT setPaletteForegroundColor(const QColor &);
838 const QT3_SUPPORT QColor &paletteBackgroundColor() const;
839 void QT3_SUPPORT setPaletteBackgroundColor(const QColor &);
840 const QT3_SUPPORT QPixmap *paletteBackgroundPixmap() const;
841 void QT3_SUPPORT setPaletteBackgroundPixmap(const QPixmap &);
842 const QT3_SUPPORT QBrush& backgroundBrush() const;
843 const QT3_SUPPORT QColor &backgroundColor() const;
844 const QT3_SUPPORT QPixmap *backgroundPixmap() const;
845 void QT3_SUPPORT setBackgroundPixmap(const QPixmap &);
846 QT3_SUPPORT void setBackgroundColor(const QColor &);
847 QT3_SUPPORT QColorGroup colorGroup() const;
848 QT3_SUPPORT QWidget *parentWidget(bool sameWindow) const;
849 inline QT3_SUPPORT void setKeyCompression(bool b) { setAttribute(Qt::WA_KeyCompression, b); }
850 inline QT3_SUPPORT void setFont(const QFont &f, bool) { setFont(f); }
851 inline QT3_SUPPORT void setPalette(const QPalette &p, bool) { setPalette(p); }
852 enum BackgroundOrigin { WidgetOrigin, ParentOrigin, WindowOrigin, AncestorOrigin };
853 inline QT3_SUPPORT void setBackgroundOrigin(BackgroundOrigin) {}
854 inline QT3_SUPPORT BackgroundOrigin backgroundOrigin() const { return WindowOrigin; }
855 inline QT3_SUPPORT QPoint backgroundOffset() const { return QPoint(); }
856 inline QT3_SUPPORT void repaint(bool) { repaint(); }
857 inline QT3_SUPPORT void repaint(int x, int y, int w, int h, bool) { repaint(x,y,w,h); }
858 inline QT3_SUPPORT void repaint(const QRect &r, bool) { repaint(r); }
859 inline QT3_SUPPORT void repaint(const QRegion &rgn, bool) { repaint(rgn); }
860 QT3_SUPPORT void erase();
861 inline QT3_SUPPORT void erase(int x, int y, int w, int h) { erase_helper(x, y, w, h); }
862 QT3_SUPPORT void erase(const QRect &);
863 QT3_SUPPORT void erase(const QRegion &);
864 QT3_SUPPORT void drawText(const QPoint &p, const QString &s)
865 { drawText_helper(p.x(), p.y(), s); }
866 inline QT3_SUPPORT void drawText(int x, int y, const QString &s)
867 { drawText_helper(x, y, s); }
868 QT3_SUPPORT bool close(bool);
869 inline QT3_SUPPORT QWidget *childAt(int x, int y, bool includeThis) const
870 {
871 QWidget *w = childAt(x, y);
872 return w ? w : ((includeThis && rect().contains(x,y))?const_cast<QWidget*>(this):0);
873 }
874 inline QT3_SUPPORT QWidget *childAt(const QPoint &p, bool includeThis) const
875 {
876 QWidget *w = childAt(p);
877 return w ? w : ((includeThis && rect().contains(p))?const_cast<QWidget*>(this):0);
878 }
879 inline QT3_SUPPORT void setCaption(const QString &c) { setWindowTitle(c); }
880 QT3_SUPPORT void setIcon(const QPixmap &i);
881 inline QT3_SUPPORT void setIconText(const QString &it) { setWindowIconText(it); }
882 inline QT3_SUPPORT QString caption() const { return windowTitle(); }
883 QT3_SUPPORT const QPixmap *icon() const;
884 inline QT3_SUPPORT QString iconText() const { return windowIconText(); }
885 inline QT3_SUPPORT void setInputMethodEnabled(bool b) { setAttribute(Qt::WA_InputMethodEnabled, b); }
886 inline QT3_SUPPORT bool isInputMethodEnabled() const { return testAttribute(Qt::WA_InputMethodEnabled); }
887 inline QT3_SUPPORT void setActiveWindow() { activateWindow(); }
888 inline QT3_SUPPORT bool isShown() const { return !isHidden(); }
889 inline QT3_SUPPORT bool isDialog() const { return windowType() == Qt::Dialog; }
890 inline QT3_SUPPORT bool isPopup() const { return windowType() == Qt::Popup; }
891 inline QT3_SUPPORT bool isDesktop() const { return windowType() == Qt::Desktop; }
892
893
894private:
895 void drawText_helper(int x, int y, const QString &);
896 void erase_helper(int x, int y, int w, int h);
897#endif // QT3_SUPPORT
898
899protected:
900 virtual void styleChange(QStyle&); // compat
901 virtual void enabledChange(bool); // compat
902 virtual void paletteChange(const QPalette &); // compat
903 virtual void fontChange(const QFont &); // compat
904 virtual void windowActivationChange(bool); // compat
905 virtual void languageChange(); // compat
906};
907
908Q_DECLARE_OPERATORS_FOR_FLAGS(QWidget::RenderFlags)
909
910#if defined Q_CC_MSVC && _MSC_VER < 1300
911template <> inline QWidget *qobject_cast_helper<QWidget*>(QObject *o, QWidget *)
912{
913 if (!o || !o->isWidgetType()) return 0;
914 return (QWidget*)(o);
915}
916#else
917template <> inline QWidget *qobject_cast<QWidget*>(QObject *o)
918{
919 if (!o || !o->isWidgetType()) return 0;
920 return static_cast<QWidget*>(o);
921}
922template <> inline const QWidget *qobject_cast<const QWidget*>(const QObject *o)
923{
924 if (!o || !o->isWidgetType()) return 0;
925 return static_cast<const QWidget*>(o);
926}
927#endif
928
929inline QWidget *QWidget::childAt(int ax, int ay) const
930{ return childAt(QPoint(ax, ay)); }
931
932inline Qt::WindowType QWidget::windowType() const
933{ return static_cast<Qt::WindowType>(int(data->window_flags & Qt::WindowType_Mask)); }
934inline Qt::WindowFlags QWidget::windowFlags() const
935{ return data->window_flags; }
936
937inline bool QWidget::isTopLevel() const
938{ return (windowType() & Qt::Window); }
939
940inline bool QWidget::isWindow() const
941{ return (windowType() & Qt::Window); }
942
943inline bool QWidget::isEnabled() const
944{ return !testAttribute(Qt::WA_Disabled); }
945
946inline bool QWidget::isModal() const
947{ return data->window_modality != Qt::NonModal; }
948
949inline bool QWidget::isEnabledToTLW() const
950{ return isEnabled(); }
951
952inline int QWidget::minimumWidth() const
953{ return minimumSize().width(); }
954
955inline int QWidget::minimumHeight() const
956{ return minimumSize().height(); }
957
958inline int QWidget::maximumWidth() const
959{ return maximumSize().width(); }
960
961inline int QWidget::maximumHeight() const
962{ return maximumSize().height(); }
963
964inline void QWidget::setMinimumSize(const QSize &s)
965{ setMinimumSize(s.width(),s.height()); }
966
967inline void QWidget::setMaximumSize(const QSize &s)
968{ setMaximumSize(s.width(),s.height()); }
969
970inline void QWidget::setSizeIncrement(const QSize &s)
971{ setSizeIncrement(s.width(),s.height()); }
972
973inline void QWidget::setBaseSize(const QSize &s)
974{ setBaseSize(s.width(),s.height()); }
975
976inline const QFont &QWidget::font() const
977{ return data->fnt; }
978
979inline QFontMetrics QWidget::fontMetrics() const
980{ return QFontMetrics(data->fnt); }
981
982inline QFontInfo QWidget::fontInfo() const
983{ return QFontInfo(data->fnt); }
984
985inline void QWidget::setMouseTracking(bool enable)
986{ setAttribute(Qt::WA_MouseTracking, enable); }
987
988inline bool QWidget::hasMouseTracking() const
989{ return testAttribute(Qt::WA_MouseTracking); }
990
991inline bool QWidget::underMouse() const
992{ return testAttribute(Qt::WA_UnderMouse); }
993
994inline bool QWidget::updatesEnabled() const
995{ return !testAttribute(Qt::WA_UpdatesDisabled); }
996
997inline void QWidget::update(int ax, int ay, int aw, int ah)
998{ update(QRect(ax, ay, aw, ah)); }
999
1000inline bool QWidget::isVisible() const
1001{ return testAttribute(Qt::WA_WState_Visible); }
1002
1003inline bool QWidget::isHidden() const
1004{ return testAttribute(Qt::WA_WState_Hidden); }
1005
1006inline void QWidget::move(int ax, int ay)
1007{ move(QPoint(ax, ay)); }
1008
1009inline void QWidget::resize(int w, int h)
1010{ resize(QSize(w, h)); }
1011
1012inline void QWidget::setGeometry(int ax, int ay, int aw, int ah)
1013{ setGeometry(QRect(ax, ay, aw, ah)); }
1014
1015inline QRect QWidget::rect() const
1016{ return QRect(0,0,data->crect.width(),data->crect.height()); }
1017
1018inline const QRect &QWidget::geometry() const
1019{ return data->crect; }
1020
1021inline QSize QWidget::size() const
1022{ return data->crect.size(); }
1023
1024inline int QWidget::width() const
1025{ return data->crect.width(); }
1026
1027inline int QWidget::height() const
1028{ return data->crect.height(); }
1029
1030inline QWidget *QWidget::parentWidget() const
1031{ return static_cast<QWidget *>(QObject::parent()); }
1032
1033inline void QWidget::setSizePolicy(QSizePolicy::Policy hor, QSizePolicy::Policy ver)
1034{ setSizePolicy(QSizePolicy(hor, ver)); }
1035
1036inline bool QWidget::testAttribute(Qt::WidgetAttribute attribute) const
1037{
1038 if (attribute < int(8*sizeof(uint)))
1039 return data->widget_attributes & (1<<attribute);
1040 return testAttribute_helper(attribute);
1041}
1042
1043#ifdef QT3_SUPPORT
1044inline bool QWidget::isVisibleToTLW() const
1045{ return isVisible(); }
1046inline QWidget *QWidget::parentWidget(bool sameWindow) const
1047{
1048 if (sameWindow && isWindow())
1049 return 0;
1050 return static_cast<QWidget *>(QObject::parent());
1051}
1052inline QColorGroup QWidget::colorGroup() const
1053{ return QColorGroup(palette()); }
1054inline void QWidget::setPaletteForegroundColor(const QColor &c)
1055{ QPalette p = palette(); p.setColor(foregroundRole(), c); setPalette(p); }
1056inline const QBrush& QWidget::backgroundBrush() const { return palette().brush(backgroundRole()); }
1057inline void QWidget::setBackgroundPixmap(const QPixmap &pm)
1058{ QPalette p = palette(); p.setBrush(backgroundRole(), QBrush(pm)); setPalette(p); }
1059inline const QPixmap *QWidget::backgroundPixmap() const { return 0; }
1060inline void QWidget::setBackgroundColor(const QColor &c)
1061{ QPalette p = palette(); p.setColor(backgroundRole(), c); setPalette(p); }
1062inline const QColor & QWidget::backgroundColor() const { return palette().color(backgroundRole()); }
1063inline const QColor &QWidget::foregroundColor() const { return palette().color(foregroundRole());}
1064inline const QColor &QWidget::eraseColor() const { return palette().color(backgroundRole()); }
1065inline void QWidget::setEraseColor(const QColor &c)
1066{ QPalette p = palette(); p.setColor(backgroundRole(), c); setPalette(p); }
1067inline const QPixmap *QWidget::erasePixmap() const { return 0; }
1068inline void QWidget::setErasePixmap(const QPixmap &pm)
1069{ QPalette p = palette(); p.setBrush(backgroundRole(), QBrush(pm)); setPalette(p); }
1070inline const QColor &QWidget::paletteForegroundColor() const { return palette().color(foregroundRole());}
1071inline const QColor &QWidget::paletteBackgroundColor() const { return palette().color(backgroundRole()); }
1072inline void QWidget::setPaletteBackgroundColor(const QColor &c)
1073{ QPalette p = palette(); p.setColor(backgroundRole(), c); setPalette(p); }
1074inline const QPixmap *QWidget::paletteBackgroundPixmap() const
1075{ return 0; }
1076inline void QWidget::setPaletteBackgroundPixmap(const QPixmap &pm)
1077{ QPalette p = palette(); p.setBrush(backgroundRole(), QBrush(pm)); setPalette(p); }
1078inline QT3_SUPPORT void QWidget::erase() { erase_helper(0, 0, data->crect.width(), data->crect.height()); }
1079inline QT3_SUPPORT void QWidget::erase(const QRect &r) { erase_helper(r.x(), r.y(), r.width(), r.height()); }
1080#endif
1081
1082#define QWIDGETSIZE_MAX ((1<<24)-1)
1083
1084QT_END_NAMESPACE
1085
1086QT_END_HEADER
1087
1088#endif // QWIDGET_H
Note: See TracBrowser for help on using the repository browser.