diff -r e42293e811d8 -r 6c1dfe4da5dd mmappfw_plat/qt_telephony_multimedia_service_api/inc/qtmsglobalvoleffect.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/mmappfw_plat/qt_telephony_multimedia_service_api/inc/qtmsglobalvoleffect.h Tue Aug 31 15:41:40 2010 +0300 @@ -0,0 +1,118 @@ +/* + * Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies). + * All rights reserved. + * This component and the accompanying materials are made available + * under the terms of "Eclipse Public License v1.0" + * which accompanies this distribution, and is available + * at the URL "http://www.eclipse.org/legal/epl-v10.html". + * + * Initial Contributors: + * Nokia Corporation - initial contribution. + * + * Contributors: + * + * Description: QT Bindings for TMS + * + */ + +#ifndef QTMS_GLOBAL_VOL_EFFECT_H +#define QTMS_GLOBAL_VOL_EFFECT_H + +#include +#include +#include +#include +#include "qtmswrapperexport.h" + +// FORWARD DECLARATIONS +namespace TMS +{ +class TMSEffect; +} + +namespace QTMS +{ + +/** + * QTMSGlobalVolEffect class + * + * This class provides volume level control in the global QTMS scope. Volume + * level changes done by any client are adjusted accross all calls serviced + * by the QTMS server. + * + * @lib QTMSapi.lib + * + */ +class QTMS_WRAPPER_DLL_EXPORT QTMSGlobalVolEffect : public QObject, + public QTMSEffect +{ + Q_OBJECT +public: + /** + * Destructor + */ + virtual ~QTMSGlobalVolEffect(); + + /** + * Set global audio volume level. The volume level should be between 0 + * and the max value returned by GetMaxLevel(). + * + * @param level + * the volume level to be set. + * @return + * QTMS_RESULT_SUCCESS if the operation was successful. + */ + gint SetLevel(const guint level); + + /** + * Return current global audio volume level. + * + * @param level + * Volume level to be set. + * + * @return + * QTMS_RESULT_SUCCESS if the operation was successful. + * + */ + gint GetLevel(guint& level); + + /** + * Return max volume level supported by the device. + * + * @param level + * Max volume level. + * + * @return + * QTMS_RESULT_SUCCESS if the operation was successful. + * + */ + gint GetMaxLevel(guint& level); + + /** + * Return effect type. + * + * @param effecttype + * Type of the effect object (QTMS_EFFECT_GLOBAL_VOL). + * + * @return + * QTMS_RESULT_SUCCESS if the operation was successful. + * + */ + virtual gint GetType(QTMSEffectType& effecttype); + + Q_SIGNALS: + void EffectsEvent(const QTMSEffect& tmseffect, QTMSSignalEvent event); + +protected: + /** + * Constructor + */ + QTMSGlobalVolEffect(); + +protected: + TMS::TMSEffect* iEffect; +}; + +} //namespace QTMS + +#endif //QTMS_GLOBAL_VOL_EFFECT_H