The SoundEffect element provides a way to play sound effects in QML. More...
This element was introduced in Qt Mobility 1.0.
This element is part of the QtMultimediaKit 1.1 module.
The following example plays a WAV file on mouse click.
import Qt 4.7 import QtMultimediaKit 1.1 Text { text: "Click Me!"; font.pointSize: 24; width: 150; height: 50; SoundEffect { id: playSound source: "soundeffect.wav" } MouseArea { id: playArea anchors.fill: parent onPressed: { playSound.play() } } }
loops : int |
This property provides a way to control the number of times to repeat the sound on each play().
Set to -1 (infinite) to enable infinite loop.
This property group was introduced in Qt Mobility 1.0.
muted : bool |
This property provides a way to control muting.
This property group was introduced in Qt Mobility 1.0.
read-onlyplaying : bool |
This property indicates if the soundeffect is playing or not.
This property group was introduced in Qt Mobility 1.1.
source : url |
This property provides a way to control the sound to play.
This property group was introduced in Qt Mobility 1.0.
read-onlystatus : int |
This property indicates the following status of the soundeffect.
Null: no source has been set or is null. Loading: the soundeffect is trying to load the source. Ready: the source is loaded and ready for play. Error: some error happened during operation, such as failure of loading the source.
This property group was introduced in Qt Mobility 1.0.
volume : qreal |
This property holds the volume of the playback, from 0.0 (silent) to 1.0 (maximum volume). Note: Currently this has no effect on Mac OS X and Symbian.
This property group was introduced in Qt Mobility 1.0.
This handler is called when the number of loops has changed.
This documentation was introduced in Qt Mobility 1.0.
This handler is called when the mute state has changed.
This documentation was introduced in Qt Mobility 1.0.
This handler is called when the playing property has changed.
This documentation was introduced in Qt Mobility 1.0.
This handler is called when the source has changed.
This documentation was introduced in Qt Mobility 1.0.
This handler is called when the status property has changed.
This documentation was introduced in Qt Mobility 1.0.
This handler is called when the volume has changed.
This documentation was introduced in Qt Mobility 1.0.
Start playback of the sound effect, looping the effect for the number of times as specificed in the loops property.
This is the default method for SoundEffect.
SoundEffect { id: playSound source: "soundeffect.wav" } MouseArea { id: playArea anchors.fill: parent onPressed: { playSound.play() } }
This documentation was introduced in Qt Mobility 1.0.
Stop current playback. Note that if the backend is PulseAudio, due to the limitation of the underlying API, tis stop will only prevent next looping but will not be able to stop current playback immediately.
This documentation was introduced in Qt Mobility 1.0.
© 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide.
All other trademarks are property of their respective owners. Privacy Policy
Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia.
Alternatively, this document may be used under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.