summaryrefslogtreecommitdiffstats
path: root/plugins/contacts/symbian/contactsmodel/tsrc/ccontactvieweventqueue.h
blob: 1ce6765e154791e5c6eca7812085f6a8478320a8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
/*
* Copyright (c) 2003-2009 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: 
* ContactViewEventQueue Test module
*
*/



#ifndef CContactViewEventQueue_H
#define CContactViewEventQueue_H

// INCLUDES
#include <cntview.h>
#include "cfixedqueue.h"


// CLASS DECLARATION

/**
 * Contact view event queue class.
 */ 
class CContactViewEventQueue : 
        public CTimer, public MContactViewObserver
    {
    public:
        /**
         * Creates a new event queue.
         * @param aView contact view to listen for events.
         * @param aMaxQueueSize maximum size of event queue.
         * @return a new instance of this class.
         */
        static CContactViewEventQueue* NewL
            (CContactViewBase* aView=NULL, TInt aMaxQueueSize=128);
        ~CContactViewEventQueue();

        /**
         * Waits for an event from the database.
         * @param aTimeOut  max time to wait for an event.
         * @param aEvent    the received event, undefined if this function returns false.
         * @return true if an event was received, false if timeout expired first.
         */
        TBool ListenForEvent
            (TTimeIntervalSeconds aTimeOut, 
            TContactViewEvent& aEvent);

        /**
         * Removes all previously arrived events from the queue.
         */
        inline void Flush()
            {
            iQueue.Reset();
            }

		/**
		 * Tells this observer to remove itself from the view
		 * if an ItemRemoved event is received
		 */
		inline void CloseOnItemRemoved(TBool val = ETrue)
			{
			iCloseOnItemRemoved = val;
			}

    private:  // from CTimer
        void RunL();

    private: // From MContactViewObserver.
	    void HandleContactViewEvent
            (const CContactViewBase& aView, const TContactViewEvent& aEvent);

    private:  // Implementation
        CContactViewEventQueue();
        void ConstructL(CContactViewBase* aView, TInt aMaxQueueSize);

    private:  // Data
        /// Ref: the view to listen for events
        CContactViewBase* iView;
        /// Own: event queue array
        CFixedQueue<TContactViewEvent> iQueue;
		/// Flag for observer response to item removed event
		TBool iCloseOnItemRemoved;
    };

#endif

// End of File