diff -r 666f914201fb -r 2fe1408b6811 epoc32/include/mw/eiklbo.h --- a/epoc32/include/mw/eiklbo.h Tue Nov 24 13:55:44 2009 +0000 +++ b/epoc32/include/mw/eiklbo.h Tue Mar 16 16:12:26 2010 +0000 @@ -1,1 +1,85 @@ -eiklbo.h +/* +* Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members +* which accompanies this distribution, and is available +* at the URL "http://www.symbianfoundation.org/legal/licencesv10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: +* +*/ + + +#if !defined(__EIKLBO_H__) +#define __EIKLBO_H__ + +class CEikListBox; + +/** +* List box observer interface. +* +* Each list box observer may be registered with a number of list +* boxes; each of these send events to the list box observer through +* its HandeListBoxEventL() method. +* +* Writing derived classes: +* +* Application authors should implement a class which derives from this +* interface to receive events from list boxes +*/ +class MEikListBoxObserver + { + public: + + /** + * List box event codes + */ + enum TListBoxEvent + { + /** Keypress event. */ + EEventEnterKeyPressed, + /** Item single-tap event */ + EEventItemClicked, + /** Item two-taps event. */ + EEventItemDoubleClicked, + /** Special event: reported by directory tree and directory contents list boxes. */ + EEventItemActioned, + /** Editing started. */ + EEventEditingStarted, + /** Editing stopped. */ + EEventEditingStopped, + /** Pen is down and over an item */ + EEventPenDownOnItem, + /** Pen is dragged from item to another */ + EEventItemDraggingActioned, + /** Panning is started */ + EEventPanningStarted, + /** Panning is stopped */ + EEventPanningStopped, + /** Flick is started */ + EEventFlickStarted, + /** Flick is stopped */ + EEventFlickStopped + }; + + public: + /** + * Handles list box events. + * + * This pure virtual function is invoked by CEikListBox to + * notify the observer of list box events. + * + * @param aListBox The originating list box. + * @param aEventType A code for the event. Further information + * may be obtained by accessing the list box itself. + */ + virtual void HandleListBoxEventL(CEikListBox* aListBox, TListBoxEvent aEventType)=0; + }; + +#endif