1 /****************************************************************************
2 **
3 ** Copyright (C) 2015 The Qt Company Ltd.
4 ** Contact: http://www.qt.io/licensing/
5 **
6 ** This file is part of the QtCore module of the Qt Toolkit.
7 **
8 ** $QT_BEGIN_LICENSE:LGPL$
9 ** Commercial License Usage
10 ** Licensees holding valid commercial Qt licenses may use this file in
11 ** accordance with the commercial license agreement provided with the
12 ** Software or, alternatively, in accordance with the terms contained in
13 ** a written agreement between you and The Qt Company. For licensing terms
14 ** and conditions see http://www.qt.io/terms-conditions. For further
15 ** information use the contact form at http://www.qt.io/contact-us.
16 **
17 ** GNU Lesser General Public License Usage
18 ** Alternatively, this file may be used under the terms of the GNU Lesser
19 ** General Public License version 2.1 or version 3 as published by the Free
20 ** Software Foundation and appearing in the file LICENSE.LGPLv21 and
21 ** LICENSE.LGPLv3 included in the packaging of this file. Please review the
22 ** following information to ensure the GNU Lesser General Public License
23 ** requirements will be met: https://www.gnu.org/licenses/lgpl.html and
24 ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
25 **
26 ** As a special exception, The Qt Company gives you certain additional
27 ** rights. These rights are described in The Qt Company LGPL Exception
28 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
29 **
30 ** GNU General Public License Usage
31 ** Alternatively, this file may be used under the terms of the GNU
32 ** General Public License version 3.0 as published by the Free Software
33 ** Foundation and appearing in the file LICENSE.GPL included in the
34 ** packaging of this file.  Please review the following information to
35 ** ensure the GNU General Public License version 3.0 requirements will be
36 ** met: http://www.gnu.org/copyleft/gpl.html.
37 **
38 ** $QT_END_LICENSE$
39 **
40 ****************************************************************************/
41 
42 #include "qcoreevent.h"
43 #include "qcoreapplication.h"
44 #include "qcoreapplication_p.h"
45 
46 #include "qmutex.h"
47 #include "qset.h"
48 
49 QT_BEGIN_NAMESPACE
50 
51 /*!
52     \class QEvent
53     \brief The QEvent class is the base class of all
54     event classes. Event objects contain event parameters.
55 
56     \ingroup events
57 
58     Qt's main event loop (QCoreApplication::exec()) fetches native
59     window system events from the event queue, translates them into
60     QEvents, and sends the translated events to \l{QObject}s.
61 
62     In general, events come from the underlying window system
63     (spontaneous() returns true), but it is also possible to manually
64     send events using QCoreApplication::sendEvent() and
65     QCoreApplication::postEvent() (spontaneous() returns false).
66 
67     QObjects receive events by having their QObject::event() function
68     called. The function can be reimplemented in subclasses to
69     customize event handling and add additional event types;
70     QWidget::event() is a notable example. By default, events are
71     dispatched to event handlers like QObject::timerEvent() and
72     QWidget::mouseMoveEvent(). QObject::installEventFilter() allows an
73     object to intercept events destined for another object.
74 
75     The basic QEvent contains only an event type parameter and an
76     "accept" flag.  The accept flag set with accept(), and cleared
77     with ignore(). It is set by default, but don't rely on this as
78     subclasses may choose to clear it in their constructor.
79 
80     Subclasses of QEvent contain additional parameters that describe
81     the particular event.
82 
83     \sa QObject::event(), QObject::installEventFilter(),
84         QWidget::event(), QCoreApplication::sendEvent(),
85         QCoreApplication::postEvent(), QCoreApplication::processEvents()
86 */
87 
88 
89 /*!
90     \enum QEvent::Type
91 
92     This enum type defines the valid event types in Qt. The event
93     types and the specialized classes for each type are as follows:
94 
95     \value None                             Not an event.
96     \value AccessibilityDescription         Used to query accessibility description texts (QAccessibleEvent).
97     \value AccessibilityHelp                Used to query accessibility help texts (QAccessibleEvent).
98     \value AccessibilityPrepare             Accessibility information is requested.
99     \value ActionAdded                      A new action has been added (QActionEvent).
100     \value ActionChanged                    An action has been changed (QActionEvent).
101     \value ActionRemoved                    An action has been removed (QActionEvent).
102     \value ActivationChange                 A widget's top-level window activation state has changed.
103     \value ApplicationActivate              The application has been made available to the user.
104     \value ApplicationActivated             This enum has been deprecated. Use ApplicationActivate instead.
105     \value ApplicationDeactivate            The application has been suspended, and is unavailable to the user.
106     \value ApplicationFontChange            The default application font has changed.
107     \value ApplicationLayoutDirectionChange The default application layout direction has changed.
108     \value ApplicationPaletteChange         The default application palette has changed.
109     \value ApplicationWindowIconChange      The application's icon has changed.
110     \value ChildAdded                       An object gets a child (QChildEvent).
111     \value ChildInserted                    An object gets a child (QChildEvent). Qt3Support only, use ChildAdded instead.
112     \value ChildPolished                    A widget child gets polished (QChildEvent).
113     \value ChildRemoved                     An object loses a child (QChildEvent).
114     \value Clipboard                        The clipboard contents have changed (QClipboardEvent).
115     \value Close                            Widget was closed (QCloseEvent).
116     \value CloseSoftwareInputPanel          A widget wants to close the software input panel (SIP).
117     \value ContentsRectChange               The margins of the widget's content rect changed.
118     \value ContextMenu                      Context popup menu (QContextMenuEvent).
119     \value CursorChange                     The widget's cursor has changed.
120     \value DeferredDelete                   The object will be deleted after it has cleaned up.
121     \value DragEnter                        The cursor enters a widget during a drag and drop operation (QDragEnterEvent).
122     \value DragLeave                        The cursor leaves a widget during a drag and drop operation (QDragLeaveEvent).
123     \value DragMove                         A drag and drop operation is in progress (QDragMoveEvent).
124     \value Drop                             A drag and drop operation is completed (QDropEvent).
125     \value EnabledChange                    Widget's enabled state has changed.
126     \value Enter                            Mouse enters widget's boundaries.
127     \value EnterEditFocus                   An editor widget gains focus for editing.
128     \value EnterWhatsThisMode               Send to toplevel widgets when the application enters "What's This?" mode.
129     \value FileOpen                         File open request (QFileOpenEvent).
130     \value FocusIn                          Widget gains keyboard focus (QFocusEvent).
131     \value FocusOut                         Widget loses keyboard focus (QFocusEvent).
132     \value FontChange                       Widget's font has changed.
133     \value GrabKeyboard                     Item gains keyboard grab (QGraphicsItem only).
134     \value GrabMouse                        Item gains mouse grab (QGraphicsItem only).
135     \value GraphicsSceneContextMenu         Context popup menu over a graphics scene (QGraphicsSceneContextMenuEvent).
136     \value GraphicsSceneDragEnter           The cursor enters a graphics scene during a drag and drop operation (QGraphicsSceneDragDropEvent).
137     \value GraphicsSceneDragLeave           The cursor leaves a graphics scene during a drag and drop operation (QGraphicsSceneDragDropEvent).
138     \value GraphicsSceneDragMove            A drag and drop operation is in progress over a scene (QGraphicsSceneDragDropEvent).
139     \value GraphicsSceneDrop                A drag and drop operation is completed over a scene (QGraphicsSceneDragDropEvent).
140     \value GraphicsSceneHelp                The user requests help for a graphics scene (QHelpEvent).
141     \value GraphicsSceneHoverEnter          The mouse cursor enters a hover item in a graphics scene (QGraphicsSceneHoverEvent).
142     \value GraphicsSceneHoverLeave          The mouse cursor leaves a hover item in a graphics scene (QGraphicsSceneHoverEvent).
143     \value GraphicsSceneHoverMove           The mouse cursor moves inside a hover item in a graphics scene (QGraphicsSceneHoverEvent).
144     \value GraphicsSceneMouseDoubleClick    Mouse press again (double click) in a graphics scene (QGraphicsSceneMouseEvent).
145     \value GraphicsSceneMouseMove           Move mouse in a graphics scene (QGraphicsSceneMouseEvent).
146     \value GraphicsSceneMousePress          Mouse press in a graphics scene (QGraphicsSceneMouseEvent).
147     \value GraphicsSceneMouseRelease        Mouse release in a graphics scene (QGraphicsSceneMouseEvent).
148     \value GraphicsSceneMove          Widget was moved (QGraphicsSceneMoveEvent).
149     \value GraphicsSceneResize          Widget was resized (QGraphicsSceneResizeEvent).
150     \value GraphicsSceneWheel               Mouse wheel rolled in a graphics scene (QGraphicsSceneWheelEvent).
151     \value Hide                             Widget was hidden (QHideEvent).
152     \value HideToParent                     A child widget has been hidden.
153     \value HoverEnter                       The mouse cursor enters a hover widget (QHoverEvent).
154     \value HoverLeave                       The mouse cursor leaves a hover widget (QHoverEvent).
155     \value HoverMove                        The mouse cursor moves inside a hover widget (QHoverEvent).
156     \value IconDrag                         The main icon of a window has been dragged away (QIconDragEvent).
157     \value IconTextChange                   Widget's icon text has been changed.
158     \value InputMethod                      An input method is being used (QInputMethodEvent).
159     \value KeyPress                         Key press (QKeyEvent).
160     \value KeyRelease                       Key release (QKeyEvent).
161     \value LanguageChange                   The application translation changed.
162     \value LayoutDirectionChange            The direction of layouts changed.
163     \value LayoutRequest                    Widget layout needs to be redone.
164     \value Leave                            Mouse leaves widget's boundaries.
165     \value LeaveEditFocus                   An editor widget loses focus for editing.
166     \value LeaveWhatsThisMode               Send to toplevel widgets when the application leaves "What's This?" mode.
167     \value LocaleChange                     The system locale has changed.
168     \value NonClientAreaMouseButtonDblClick A mouse double click occurred outside the client area.
169     \value NonClientAreaMouseButtonPress    A mouse button press occurred outside the client area.
170     \value NonClientAreaMouseButtonRelease  A mouse button release occurred outside the client area.
171     \value NonClientAreaMouseMove           A mouse move occurred outside the client area.
172     \value MacSizeChange                    The user changed his widget sizes (Mac OS X only).
173     \value MenubarUpdated                   The window's menu bar has been updated.
174     \value MetaCall                         An asynchronous method invocation via QMetaObject::invokeMethod().
175     \value ModifiedChange                   Widgets modification state has been changed.
176     \value MouseButtonDblClick              Mouse press again (QMouseEvent).
177     \value MouseButtonPress                 Mouse press (QMouseEvent).
178     \value MouseButtonRelease               Mouse release (QMouseEvent).
179     \value MouseMove                        Mouse move (QMouseEvent).
180     \value MouseTrackingChange              The mouse tracking state has changed.
181     \value Move                             Widget's position changed (QMoveEvent).
182     \value Paint                            Screen update necessary (QPaintEvent).
183     \value PaletteChange                    Palette of the widget changed.
184     \value ParentAboutToChange              The widget parent is about to change.
185     \value ParentChange                     The widget parent has changed.
186     \value PlatformPanel                    A platform specific panel has been requested.
187     \value Polish                           The widget is polished.
188     \value PolishRequest                    The widget should be polished.
189     \value QueryWhatsThis                   The widget should accept the event if it has "What's This?" help.
190     \value RequestSoftwareInputPanel        A widget wants to open a software input panel (SIP).
191     \value Resize                           Widget's size changed (QResizeEvent).
192     \value Shortcut                         Key press in child for shortcut key handling (QShortcutEvent).
193     \value ShortcutOverride                 Key press in child, for overriding shortcut key handling (QKeyEvent).
194     \value Show                             Widget was shown on screen (QShowEvent).
195     \value ShowToParent                     A child widget has been shown.
196     \value SockAct                          Socket activated, used to implement QSocketNotifier.
197     \value StateMachineSignal               A signal delivered to a state machine (QStateMachine::SignalEvent).
198     \value StateMachineWrapped              The event is a wrapper for, i.e., contains, another event (QStateMachine::WrappedEvent).
199     \value StatusTip                        A status tip is requested (QStatusTipEvent).
200     \value StyleChange                      Widget's style has been changed.
201     \value TabletMove                       Wacom tablet move (QTabletEvent).
202     \value TabletPress                      Wacom tablet press (QTabletEvent).
203     \value TabletRelease                    Wacom tablet release (QTabletEvent).
204     \value OkRequest                        Ok button in decoration pressed. Supported only for Windows CE.
205     \value TabletEnterProximity             Wacom tablet enter proximity event (QTabletEvent), sent to QApplication.
206     \value TabletLeaveProximity             Wacom tablet leave proximity event (QTabletEvent), sent to QApplication.
207     \value Timer                            Regular timer events (QTimerEvent).
208     \value ToolBarChange                    The toolbar button is toggled on Mac OS X.
209     \value ToolTip                          A tooltip was requested (QHelpEvent).
210     \value ToolTipChange                    The widget's tooltip has changed.
211     \value UngrabKeyboard                   Item loses keyboard grab (QGraphicsItem only).
212     \value UngrabMouse                      Item loses mouse grab (QGraphicsItem only).
213     \value UpdateLater                      The widget should be queued to be repainted at a later time.
214     \value UpdateRequest                    The widget should be repainted.
215     \value WhatsThis                        The widget should reveal "What's This?" help (QHelpEvent).
216     \value WhatsThisClicked                 A link in a widget's "What's This?" help was clicked.
217     \value Wheel                            Mouse wheel rolled (QWheelEvent).
218     \value WinEventAct                      A Windows-specific activation event has occurred.
219     \value WindowActivate                   Window was activated.
220     \value WindowBlocked                    The window is blocked by a modal dialog.
221     \value WindowDeactivate                 Window was deactivated.
222     \value WindowIconChange                 The window's icon has changed.
223     \value WindowStateChange                The \l{QWidget::windowState()}{window's state} (minimized, maximized or full-screen) has changed (QWindowStateChangeEvent).
224     \value WindowTitleChange                The window title has changed.
225     \value WindowUnblocked                  The window is unblocked after a modal dialog exited.
226     \value ZOrderChange                     The widget's z-order has changed. This event is never sent to top level windows.
227     \value KeyboardLayoutChange             The keyboard layout has changed.
228     \value DynamicPropertyChange            A dynamic property was added, changed or removed from the object.
229     \value TouchBegin                       Beginning of a sequence of touch-screen and/or track-pad events (QTouchEvent)
230     \value TouchUpdate                      Touch-screen event (QTouchEvent)
231     \value TouchEnd                         End of touch-event sequence (QTouchEvent)
232     \value WinIdChange                      The window system identifer for this native widget has changed
233     \value Gesture                          A gesture was triggered (QGestureEvent)
234     \value GestureOverride                  A gesture override was triggered (QGestureEvent)
235 
236     User events should have values between \c User and \c{MaxUser}:
237 
238     \value User                             User-defined event.
239     \value MaxUser                          Last user event ID.
240 
241     For convenience, you can use the registerEventType() function to
242     register and reserve a custom event type for your
243     application. Doing so will allow you to avoid accidentally
244     re-using a custom event type already in use elsewhere in your
245     application.
246 
247     \omitvalue Accel
248     \omitvalue AccelAvailable
249     \omitvalue AccelOverride
250     \omitvalue AcceptDropsChange
251     \omitvalue ActivateControl
252     \omitvalue CaptionChange
253     \omitvalue ChildInsertedRequest
254     \omitvalue ChildInserted
255     \omitvalue Create
256     \omitvalue DeactivateControl
257     \omitvalue Destroy
258     \omitvalue DragResponse
259     \omitvalue EmbeddingControl
260     \omitvalue HelpRequest
261     \omitvalue IconChange
262     \omitvalue LayoutHint
263     \omitvalue Quit
264     \omitvalue Reparent
265     \omitvalue ShowWindowRequest
266     \omitvalue Speech
267     \omitvalue Style
268     \omitvalue ThreadChange
269     \omitvalue ZeroTimerEvent
270     \omitvalue ApplicationActivated
271     \omitvalue ApplicationDeactivated
272     \omitvalue MacGLWindowChange
273     \omitvalue MacGLClearDrawable
274     \omitvalue NetworkReplyUpdated
275     \omitvalue FutureCallOut
276     \omitvalue UpdateSoftKeys
277     \omitvalue NativeGesture
278 */
279 
280 /*!
281     Contructs an event object of type \a type.
282 */
QEvent(Type type)283 QEvent::QEvent(Type type)
284     : d(0), t(type), posted(false), spont(false), m_accept(true)
285 {}
286 
287 /*!
288     Destroys the event. If it was \link
289     QCoreApplication::postEvent() posted \endlink,
290     it will be removed from the list of events to be posted.
291 */
292 
~QEvent()293 QEvent::~QEvent()
294 {
295     if (posted && QCoreApplication::instance())
296         QCoreApplicationPrivate::removePostedEvent(this);
297 }
298 
299 
300 /*!
301     \property  QEvent::accepted
302     the accept flag of the event object
303 
304     Setting the accept parameter indicates that the event receiver
305     wants the event. Unwanted events might be propagated to the parent
306     widget. By default, isAccepted() is set to true, but don't rely on
307     this as subclasses may choose to clear it in their constructor.
308 
309     For convenience, the accept flag can also be set with accept(),
310     and cleared with ignore().
311 */
312 
313 /*!
314     \fn void QEvent::accept()
315 
316     Sets the accept flag of the event object, the equivalent of
317     calling setAccepted(true).
318 
319     Setting the accept parameter indicates that the event receiver
320     wants the event. Unwanted events might be propagated to the parent
321     widget.
322 
323     \sa ignore()
324 */
325 
326 
327 /*!
328     \fn void QEvent::ignore()
329 
330     Clears the accept flag parameter of the event object, the
331     equivalent of calling setAccepted(false).
332 
333     Clearing the accept parameter indicates that the event receiver
334     does not want the event. Unwanted events might be propagated to the
335     parent widget.
336 
337     \sa accept()
338 */
339 
340 
341 /*!
342     \fn QEvent::Type QEvent::type() const
343 
344     Returns the event type.
345 */
346 
347 /*!
348     \fn bool QEvent::spontaneous() const
349 
350     Returns true if the event originated outside the application (a
351     system event); otherwise returns false.
352 
353     The return value of this function is not defined for paint events.
354 */
355 
356 class QEventUserEventRegistration
357 {
358 public:
359     QMutex mutex;
360     QSet<int> set;
361 };
Q_GLOBAL_STATIC(QEventUserEventRegistration,userEventRegistrationHelper)362 Q_GLOBAL_STATIC(QEventUserEventRegistration, userEventRegistrationHelper)
363 
364 /*!
365     \since 4.4
366     \threadsafe
367 
368     Registers and returns a custom event type. The \a hint provided
369     will be used if it is available, otherwise it will return a value
370     between QEvent::User and QEvent::MaxUser that has not yet been
371     registered. The \a hint is ignored if its value is not between
372     QEvent::User and QEvent::MaxUser.
373 */
374 int QEvent::registerEventType(int hint)
375 {
376     QEventUserEventRegistration *userEventRegistration
377         = userEventRegistrationHelper();
378     if (!userEventRegistration)
379         return -1;
380 
381     QMutexLocker locker(&userEventRegistration->mutex);
382 
383     // if the type hint hasn't been registered yet, take it
384     if (hint >= QEvent::User && hint <= QEvent::MaxUser && !userEventRegistration->set.contains(hint)) {
385         userEventRegistration->set.insert(hint);
386         return hint;
387     }
388 
389     // find a free event type, starting at MaxUser and decreasing
390     int id = QEvent::MaxUser;
391     while (userEventRegistration->set.contains(id) && id >= QEvent::User)
392         --id;
393     if (id >= QEvent::User) {
394         userEventRegistration->set.insert(id);
395         return id;
396     }
397     return -1;
398 }
399 
400 /*!
401     \class QTimerEvent
402     \brief The QTimerEvent class contains parameters that describe a
403     timer event.
404 
405     \ingroup events
406 
407     Timer events are sent at regular intervals to objects that have
408     started one or more timers. Each timer has a unique identifier. A
409     timer is started with QObject::startTimer().
410 
411     The QTimer class provides a high-level programming interface that
412     uses signals instead of events. It also provides single-shot timers.
413 
414     The event handler QObject::timerEvent() receives timer events.
415 
416     \sa QTimer, QObject::timerEvent(), QObject::startTimer(),
417     QObject::killTimer()
418 */
419 
420 /*!
421     Constructs a timer event object with the timer identifier set to
422     \a timerId.
423 */
QTimerEvent(int timerId)424 QTimerEvent::QTimerEvent(int timerId)
425     : QEvent(Timer), id(timerId)
426 {}
427 
428 /*! \internal
429 */
~QTimerEvent()430 QTimerEvent::~QTimerEvent()
431 {
432 }
433 
434 /*!
435     \fn int QTimerEvent::timerId() const
436 
437     Returns the unique timer identifier, which is the same identifier
438     as returned from QObject::startTimer().
439 */
440 
441 /*!
442     \class QChildEvent
443     \brief The QChildEvent class contains event parameters for child object
444     events.
445 
446     \ingroup events
447 
448     Child events are sent immediately to objects when children are
449     added or removed.
450 
451     In both cases you can only rely on the child being a QObject (or,
452     if QObject::isWidgetType() returns true, a QWidget). This is
453     because in the QEvent::ChildAdded case the child is not yet fully
454     constructed; in the QEvent::ChildRemoved case it might have
455     already been destructed.
456 
457     The handler for these events is QObject::childEvent().
458 */
459 
460 /*!
461     Constructs a child event object of a particular \a type for the
462     \a child.
463 
464     \a type can be QEvent::ChildAdded, QEvent::ChildRemoved,
465     QEvent::ChildPolished, or QEvent::ChildRemoved.
466 
467     \sa child()
468 */
QChildEvent(Type type,QObject * child)469 QChildEvent::QChildEvent(Type type, QObject *child)
470     : QEvent(type), c(child)
471 {}
472 
473 /*! \internal
474 */
~QChildEvent()475 QChildEvent::~QChildEvent()
476 {
477 }
478 
479 /*!
480     \fn QObject *QChildEvent::child() const
481 
482     Returns the child object that was added or removed.
483 */
484 
485 /*!
486     \fn bool QChildEvent::added() const
487 
488     Returns true if type() is QEvent::ChildAdded; otherwise returns
489     false.
490 */
491 
492 /*!
493     \fn bool QChildEvent::removed() const
494 
495     Returns true if type() is QEvent::ChildRemoved; otherwise returns
496     false.
497 */
498 
499 /*!
500     \fn bool QChildEvent::polished() const
501 
502     Returns true if type() is QEvent::ChildPolished; otherwise returns
503     false.
504 */
505 
506 /*!
507     \class QCustomEvent
508     \brief The QCustomEvent class provides support for custom events.
509 
510     \compat
511 
512     QCustomEvent has a \c{void *} that can be used to store custom
513     data.
514 
515     In Qt 3, QObject::customEvent() took a QCustomEvent pointer. We
516     found out that this approach was unsatisfactory, because
517     there was often no safe way of deleting the data held in the
518     \c{void *}.
519 
520     In Qt 4, QObject::customEvent() takes a plain QEvent pointer.
521     You can add custom data by subclassing.
522 
523     \sa QObject::customEvent(), QCoreApplication::notify()
524 */
525 
526 /*!
527     \fn QCustomEvent::QCustomEvent(int type, void *data)
528 
529     Constructs a custom event object with the event \a type and a
530     pointer to \a data. The value of \a type must be at least as
531     large as QEvent::User. By default, the data pointer is set to 0.
532 */
533 #ifdef QT3_SUPPORT
QCustomEvent(int type,void * data)534 QCustomEvent::QCustomEvent(int type, void *data)
535     : QEvent(static_cast<Type>(type))
536 {
537     d = reinterpret_cast<QEventPrivate *>(data);
538 }
539 
540 /*! \internal
541 */
~QCustomEvent()542 QCustomEvent::~QCustomEvent()
543 {
544 }
545 #endif
546 /*!
547     \fn void QCustomEvent::setData(void *data)
548 
549     \compat
550 
551     Sets the generic data pointer to \a data.
552 
553     \sa data()
554 */
555 
556 /*!
557     \fn void *QCustomEvent::data() const
558 
559     \compat
560 
561     Returns a pointer to the generic event data.
562 
563     \sa setData()
564 */
565 
566 /*!
567     \fn bool QChildEvent::inserted() const
568 
569     \compat
570 
571     A child has been inserted if the event's type() is ChildInserted.
572 */
573 
574 /*!
575     \class QDynamicPropertyChangeEvent
576     \since 4.2
577     \brief The QDynamicPropertyChangeEvent class contains event parameters for dynamic
578     property change events.
579 
580     \ingroup events
581 
582     Dynamic property change events are sent to objects when properties are
583     dynamically added, changed or removed using QObject::setProperty().
584 */
585 
586 /*!
587     Constructs a dynamic property change event object with the property name set to
588     \a name.
589 */
QDynamicPropertyChangeEvent(const QByteArray & name)590 QDynamicPropertyChangeEvent::QDynamicPropertyChangeEvent(const QByteArray &name)
591     : QEvent(QEvent::DynamicPropertyChange), n(name)
592 {
593 }
594 
595 /*!
596     \internal
597 */
~QDynamicPropertyChangeEvent()598 QDynamicPropertyChangeEvent::~QDynamicPropertyChangeEvent()
599 {
600 }
601 
602 /*!
603     \fn QByteArray QDynamicPropertyChangeEvent::propertyName() const
604 
605     Returns the name of the dynamic property that was added, changed or
606     removed.
607 
608     \sa QObject::setProperty(), QObject::dynamicPropertyNames()
609 */
610 
611 QT_END_NAMESPACE
612