· Page d'accueil · Toutes les classes · Classes principales · Annotées · Classes groupées · Modules · Fonctions ·

SoundEffect

The SoundEffect type provides a way to play sound effects in QML. More...

Inherits QtObject

SoundEffect instantiates the C++ class QSoundEffect

List of all members, including inherited members

Properties

loops : int
loopsRemaining : int
status : enumeration

Methods

play()
stop()

Detailed Description

SoundEffect is part of the QtMultimedia 5.0 module.

The following example plays a WAV file on mouse click.

 import QtQuick 2.0
 import QtMultimedia 5.0

 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() }
     }
 }

Property Documentation

loops : int

This property provides a way to control the number of times to repeat the sound on each play().

Set to SoundEffect.Infinite to enable infinite looping.

read-onlyloopsRemaining : int

This property contains the number of loops remaining before the sound effect stops by itself, or SoundEffect.Infinite if that's what has been set in loops.

read-onlystatus : enumeration

This property indicates the current status of the SoundEffect as enumerated within SoundEffect. Possible statuses are listed below.

Value	Description
SoundEffect.Null	No source has been set or the source is null.
SoundEffect.Loading	The SoundEffect is trying to load the source.
SoundEffect.Ready	The source is loaded and ready for play.
SoundEffect.Error	An error occurred during operation, such as failure of loading the source.

Method Documentation

SoundEffect::play()

Start playback of the sound effect, looping the effect for the number of times as specified 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() }
 }

SoundEffect::stop()

Stop current playback.

Note that if the backend is PulseAudio, due to the limitation of the underlying API, calling stop will only prevent next looping but will not be able to stop current playback immediately.

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.

Documentation sources may be obtained from www.qt-project.org.

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

Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia.	Qt 5.0-snapshot
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !