diff -r 000000000000 -r e686773b3f54 phonebookui/Phonebook2/GroupExtension/inc/CPguAddMembersCmd.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/phonebookui/Phonebook2/GroupExtension/inc/CPguAddMembersCmd.h Tue Feb 02 10:12:17 2010 +0200 @@ -0,0 +1,218 @@ +/* +* Copyright (c) 2005-2007 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: Phonebook 2 add to group command object. +* +*/ + + +#ifndef CPGUADDMEMBERSCMD_H +#define CPGUADDMEMBERSCMD_H + +// INCLUDES +#include +#include +#include +#include +#include +#include +#include +#include +#include + +// FORWARD DECLARATIONS +class MPbk2ContactUiControl; +class MVPbkContactGroup; +class MVPbkContactLink; +class MVPbkContactLinkArray; +class CVPbkContactLinkArray; +class MVPbkContactOperationBase; +class MVPbkContactViewBase; +class CPbk2ContactRelocator; + +// CLASS DECLARATION + +/** + * Phonebook 2 add to group command object. + */ +class CPguAddMembersCmd : public CActive, + public MPbk2Command, + private MVPbkSingleContactOperationObserver, + private MVPbkContactObserver, + private MPbk2FetchDlgObserver, + private MVPbkContactViewObserver, + private MVPbkContactSelector, + private MPbk2ContactRelocatorObserver, + private MPbk2ProcessDecoratorObserver + { + public: // Construction and destruction + + /** + * Creates a new instance of this class. + * + * @param aGroup Group link. + * @param aUiControl UI control. + * @return A new instance of this class. + */ + static CPguAddMembersCmd* NewLC( + MVPbkContactLink& aGroup, + MPbk2ContactUiControl& aUiControl ); + + /** + * Destructor. + */ + ~CPguAddMembersCmd(); + + public: // From MPbk2Command + void ExecuteLD(); + void AddObserver( + MPbk2CommandObserver& aObserver ); + void ResetUiControl( + MPbk2ContactUiControl& aUiControl ); + + private: // From CActive + void RunL(); + void DoCancel(); + TInt RunError( + TInt aError ); + + private: // From MVPbkSingleContactOperationObserver + void VPbkSingleContactOperationComplete( + MVPbkContactOperationBase& aOperation, + MVPbkStoreContact* aContact ); + void VPbkSingleContactOperationFailed( + MVPbkContactOperationBase& aOperation, + TInt aError ); + + private: // From MVPbkContactObserver + void ContactOperationCompleted( + TContactOpResult aResult ); + void ContactOperationFailed( + TContactOp aOpCode, + TInt aErrorCode, + TBool aErrorNotified ); + + private: // From MVPbkContactViewObserver + void ContactViewReady( + MVPbkContactViewBase& aView ); + void ContactViewUnavailable( + MVPbkContactViewBase& aView ); + void ContactAddedToView( + MVPbkContactViewBase& aView, + TInt aIndex, + const MVPbkContactLink& aContactLink ); + void ContactRemovedFromView( + MVPbkContactViewBase& aView, + TInt aIndex, + const MVPbkContactLink& aContactLink ); + void ContactViewError( + MVPbkContactViewBase& aView, + TInt aError, + TBool aErrorNotified ); + + private: // From MVPbkContactSelector + TBool IsContactIncluded( + const MVPbkBaseContact& aContact ); + + private: // From MPbk2FetchDlgObserver + TPbk2FetchAcceptSelection AcceptFetchSelectionL( + TInt aNumMarkedEntries, + MVPbkContactLink& aLastSelection ); + void FetchCompletedL( + MVPbkContactLinkArray* aMarkedEntries ); + void FetchCanceled(); + void FetchAborted(); + TBool FetchOkToExit(); + + private: // From MPbk2ContactRelocatorObserver + void ContactRelocatedL( + MVPbkStoreContact* aRelocatedContact ); + void ContactRelocationFailed( + TInt aReason, + MVPbkStoreContact* aContact ); + void ContactsRelocationFailed( + TInt aReason, + CVPbkContactLinkArray* aContacts ); + void RelocationProcessComplete(); + + public: // From MPbk2ProcessDecoratorObserver + void ProcessDismissed( + TInt aCancelCode ); + + private: // Implementation + CPguAddMembersCmd( + MVPbkContactLink& aContactGroup, + MPbk2ContactUiControl& aUiControl ); + void ConstructL(); + void HandleContactLockedEventL(); + void DoLaunchFetchDialogL(); + void PrepareFetchResultsL( + MVPbkContactLinkArray* aMarkedEntries ); + void RelocateContactsL(); + void RelocateContactL( + MVPbkStoreContact* aStoreContact ); + void AddContactsToGroupL(); + void CommitTransactionL(); + void FinishCommand( + TInt aResult ); + void ShowRelocationNoteL( + TInt aCount ); + void ShowProgressNoteL(); + void IssueRequest(); + void IssueStopRequest(); + void SetFocusToLastAddedL(); + + private: // Data structures + /// Process states + enum TState + { + ERetrievingContact, + EHandleContactLockedEvent, + EShowingProgressNote, + EAddingContactsToGroup, + ECommitingTransaction, + EStopping + }; + + private: // Data + /// Ref: UI control + MPbk2ContactUiControl* iUiControl; + /// Ref: Command observer + MPbk2CommandObserver* iCommandObserver; + /// Own: Retrieve group operation + MVPbkContactOperationBase* iRetrieveGroupOperation; + /// Own: Retrieve contact operation + MVPbkContactOperationBase* iRetrieveContactOperation; + /// Ref: A group where to add members + MVPbkContactLink& iGroupLink; + /// Own: Contact group + MVPbkContactGroup* iContactGroup; + /// Own: A filtered view for dialog + MVPbkContactViewBase* iFilteredView; + /// Own: Entries to add to group + CVPbkContactLinkArray* iEntriesToAdd; + /// Own: Entries to relocate + CVPbkContactLinkArray* iEntriesToRelocate; + /// Own: Contact relocator + CPbk2ContactRelocator* iContactRelocator; + /// Own: Decorator for the wait note process + MPbk2ProcessDecorator* iDecorator; + /// Own: Contacts that already belongs to the group + MVPbkContactLinkArray* iContactsInGroup; + /// Own: State of the command + TState iState; + }; + +#endif // CPGUADDMEMBERSCMD_H + +// End of File