diff -r 7d48bed6ce0c -r 987c9837762f satui/satapp/inc/satappaction.h --- a/satui/satapp/inc/satappaction.h Tue Aug 31 15:45:17 2010 +0300 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,108 +0,0 @@ -/* -* 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: -* -* -*/ - -#ifndef SATAPPACTION_H -#define SATAPPACTION_H - -#include -#include -#include -#include -#include // for symbian-to-qt conversions -#include "MSatUiObserver.h" // for the param type definitions -#include "satappconstant.h" - -// class declaration -class SatAppAction : public QObject -{ - Q_OBJECT - -public: - /** creates an action with given identity (TSatAction) */ - SatAppAction(int action, QObject *parent = 0); - ~SatAppAction(); - - /** synchronous wait until the action has been completed */ - void waitUntilCompleted(); - /** completes the action with guiven response */ - void complete(TSatUiResponse resp); - -public slots: - - /** completes the action */ - void complete() {complete(response());} - - // comfy methods for completing with certain response - void completeWithSuccess() {complete(ESatSuccess);} - void completeWithFailure() {complete(ESatFailure);} - void completeWithNoResponse() {complete(ESatNoResponseFromUser);} - void completeWithBackRequested() {complete(ESatBackwardModeRequestedByUser);} - void completeWithSessionTerminated() {complete(ESatSessionTerminatedByUser);} - -signals: - - /** signalled when the action has been completed */ - void actionCompleted(SatAppAction *action); - -public: // param access - - /** returns the identity of the action (TSatAction) */ - int action() {return mAction;} - - /** sets the action response */ - void setResponse(TSatUiResponse resp) {mResponse=resp;} - /** the action response (TSatUiResponse) */ - TSatUiResponse response() {return mResponse;} - - /** sets a value (arbitary type) */ - void set(const QString& key, QVariant value); - - /** sets QString value after doing symbian-to-qt conversion */ - void set(const QString& key, const TDesC& value); - /** sets QStringList value after doing symbian-to-qt conversion */ - void set(const QString& key, const MDesCArray& value); - /** sets QList value after doing symbian-to-qt conversion */ - void set(const QString& key, CArrayFixFlat& value); - /** sets int(millisec) value after doing symbian-to-qt conversion */ - void set(const QString& key, TTimeIntervalSeconds& value); - /** sets int(millisec) value after doing symbian-to-qt conversion */ - void set(const QString& key, TTimeIntervalMicroSeconds& value); - - /** returns a value (arbitary type) */ - QVariant value(const QString &key); - /** whether a value is present */ - bool hasValue(const QString &key); - -private: // data - - // identity of this action - int mAction; - - // response - TSatUiResponse mResponse; - - // parameter map - QMap mParams; - - // internal action state - enum State {Active,Waiting,Completed}; - State mState; -}; - -#endif // SATAPPACTION_H -