Connecting Objects to Signals
QML types have predefined signals that are emitted when users interact with the application. For example, the Mouse Area type has a
clicked signal that is emitted whenever the mouse is clicked within the area. Since the signal name is
clicked, the signal handler for receiving this signal is named
A signal is automatically emitted when the value of a QML property changes. This type of signal is a property change signal and signal handlers for these signals are written in the form
on<Property>Changed, where <Property> is the name of the property, with the first letter capitalized.
For example, the Mouse Area type has a
pressed property. To receive a notification whenever this property changes, you would use a signal handler called
For more information about signals and signal handlers, see Signal and Handler Event System.
To access a signal outside of the object that emits it, you can use the Connections type for connecting to signals of arbitrary objects. A connections object can receive any signal from its specified target. You can connect objects to signals that are available to them in the Connections view.
To connect objects to signals:
- In the Connections view, select the Connections tab.
- Select the (Add) button to add a connection.
- Double-click the value in the Target column to add the object to connect to a signal.
- Double-click the value in the Signal Handler column to select the signal that the connection will listen to from a list of all signals available for the object.
Right-click a connection and select Open Connection Editor in the context menu to specify the connection in Connection Editor.
If a signal handler that you need is not listed in the Signal Handler column, you can add it:
- Right-click a component in the Navigator or Form Editor view and select Add New Signal Handler in the context menu.
- In the Signal field, select the signal to handle.
- Select the radio buttons to filter the list to only display frequently used signals or property changes.
- Select OK.
The added signal handler is automatically exported as a property.
© 2021 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.