1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/os/graphics/windowing/windowserver/nga/SERVER/EVENT.H Fri Jun 15 03:10:57 2012 +0200
1.3 @@ -0,0 +1,315 @@
1.4 +// Copyright (c) 1999-2010 Nokia Corporation and/or its subsidiary(-ies).
1.5 +// All rights reserved.
1.6 +// This component and the accompanying materials are made available
1.7 +// under the terms of "Eclipse Public License v1.0"
1.8 +// which accompanies this distribution, and is available
1.9 +// at the URL "http://www.eclipse.org/legal/epl-v10.html".
1.10 +//
1.11 +// Initial Contributors:
1.12 +// Nokia Corporation - initial contribution.
1.13 +//
1.14 +// Contributors:
1.15 +//
1.16 +// Description:
1.17 +// Definition of classes related event handling
1.18 +//
1.19 +//
1.20 +
1.21 +
1.22 +#ifndef __EVENT_H__
1.23 +#define __EVENT_H__
1.24 +
1.25 +#include "EVQUEUE.H"
1.26 +#include <e32std.h>
1.27 +#include <e32base.h>
1.28 +#include <e32svr.h>
1.29 +#include "W32STD.H"
1.30 +#include "w32cmd.h"
1.31 +#include "EVQUEUE.H"
1.32 +#include <w32adll.h>
1.33 +#include "graphics/WSGRAPHICDRAWER.H"
1.34 +#include <graphics/wskeyrouter.h>
1.35 +
1.36 +class CWsClient;
1.37 +class CWsWindowBase;
1.38 +class CWsWindowGroup;
1.39 +class MEventHandler;
1.40 +class CWsHotKey;
1.41 +class CWsCaptureLongKey;
1.42 +class CScreen;
1.43 +class DWsScreenDevice;
1.44 +
1.45 +const TInt KRetryInitialDelay = 100000; //0.01 second
1.46 +
1.47 +struct TEventRequestItem
1.48 + {
1.49 + const CWsWindowBase *iWindow;
1.50 + TInt iParam;
1.51 + TEventControl iCircumstances;
1.52 + TSglQueLink iQue;
1.53 + };
1.54 +
1.55 +class TEventRequestQueue
1.56 + {
1.57 +public:
1.58 + TEventRequestQueue();
1.59 + TEventRequestItem *FindInEventRequestQueueList(const CWsWindowBase &aWindow);
1.60 + void AddToEventRequestListL(const CWsWindowBase &aWindow, TInt aParam, TEventControl aCircumstances);
1.61 + void RemoveFromEventRequestListL(const CWsWindowBase &aWindow);
1.62 + inline TSglQue<TEventRequestItem> &Queue();
1.63 +private:
1.64 + TSglQue<TEventRequestItem> iQueue;
1.65 + };
1.66 +
1.67 +class CRawEventReceiver : public CActive
1.68 + {
1.69 +public:
1.70 + CRawEventReceiver(TInt aPriority);
1.71 + ~CRawEventReceiver();
1.72 + void ConstructL();
1.73 + inline TBool IsReadyToRun() const {return IsActive() && iStatus!=KRequestPending;}
1.74 +protected:
1.75 + void Request();
1.76 + void DoCancel();
1.77 + void RunL();
1.78 +private:
1.79 + TRawEventBuf iEventBuf;
1.80 + };
1.81 +
1.82 +class TRepeatKey
1.83 + {
1.84 +public:
1.85 + TKeyEventRouterOutput iOutput;
1.86 + TInt iInputScanCode;
1.87 + };
1.88 +
1.89 +class CKeyboardRepeat : public CTimer
1.90 + {
1.91 +public:
1.92 + CKeyboardRepeat();
1.93 + static void NewL();
1.94 + static void Destroy();
1.95 + static void KeyDown();
1.96 + static void KeyUp(TInt aScanCode);
1.97 + static void StartRepeat(TInt aInputScanCode, const TKeyEventRouterOutput& aShortEvent, const TKeyEventRouterOutput* aLongEvent);
1.98 + static void CancelRepeat(CWsWindowGroup *aRepeatFocus);
1.99 + static void CancelRepeat(const TAny* aCaptureHandle, TBool aLongCaptureFlag);
1.100 + static void SetRepeatTime(const TTimeIntervalMicroSeconds32 &aInitialTime, const TTimeIntervalMicroSeconds32 &aTime);
1.101 + static void GetRepeatTime(TTimeIntervalMicroSeconds32 &aInitialTime, TTimeIntervalMicroSeconds32 &aTime);
1.102 + static inline TBool IsAreadyActive();
1.103 +private:
1.104 + enum TRepeatType
1.105 + {
1.106 + ERepeatNone,
1.107 + ERepeatNormal,
1.108 + ERepeatLong,
1.109 + ERepeatLongRepeated,
1.110 + };
1.111 +private:
1.112 + static void doCancelRepeat();
1.113 + void RunL();
1.114 +private:
1.115 + static CKeyboardRepeat *iThis; // Needed as CTimer derived parts can't be static
1.116 + static TTimeIntervalMicroSeconds32 iInitialTime;
1.117 + static TTimeIntervalMicroSeconds32 iTime;
1.118 + static TRepeatType iRepeating;
1.119 + static TRepeatKey iCurrentRepeat;
1.120 + static TRepeatKey iAlternateRepeat;
1.121 + static TRepeatKey iLongRepeat;
1.122 + static TBool iAlternateRepeatExists;
1.123 + static CWsCaptureLongKey* iLongCapture;
1.124 + static TInt iRepeatRollover;
1.125 + };
1.126 +
1.127 +struct SNotificationHandler {CAnim* iAnim; TUint32 iNotifications;};
1.128 +struct TDrawerHandler
1.129 + {
1.130 + TDrawerHandler(CWsGraphicDrawer *aDrawer, TUint32 aEvents): iDrawer(aDrawer), iEvents(aEvents) {}
1.131 + CWsGraphicDrawer* iDrawer;
1.132 + TUint32 iEvents;
1.133 + };
1.134 +
1.135 +struct TWsEventHandler
1.136 + {
1.137 + TWsEventHandler(MWsEventHandler *aHandler, TUint32 aEvents): iHandler(aHandler), iEvents(aEvents) {}
1.138 + static TBool CompareHandler(const TWsEventHandler& lhs, const TWsEventHandler& rhs) { return lhs.iHandler == rhs.iHandler; }
1.139 + MWsEventHandler* iHandler;
1.140 + TUint32 iEvents;
1.141 + };
1.142 +
1.143 +class CEventQueueRetry : public CActive
1.144 + {
1.145 +public:
1.146 + static CEventQueueRetry* NewL();
1.147 + ~CEventQueueRetry();
1.148 + void Init(CScreen *aOwner);
1.149 + void Retry(TInt aDelay);
1.150 + void CancelRetry();
1.151 +private:
1.152 + CEventQueueRetry();
1.153 + void ConstructL();
1.154 + // From CActive:
1.155 + void RunL();
1.156 + void DoCancel();
1.157 +
1.158 +private:
1.159 + RTimer iTimer;
1.160 + CScreen *iOwner;
1.161 + TInt iRetrySpinner;
1.162 + RPointerArray<CWsClient> iClientArray;
1.163 + };
1.164 +
1.165 +class TWindowServerEvent
1.166 + {
1.167 + #define EDefaultInitialRepeatTime TTimeIntervalMicroSeconds32(300000)
1.168 + #define EDefaultRepeatTime TTimeIntervalMicroSeconds32(100000)
1.169 +
1.170 + typedef void (*TSendEventFunc)(TEventRequestItem *aQptr, TInt aParam1, TInt aParam2);
1.171 +public:
1.172 + enum {ENumHotKeys=21};
1.173 + enum {EOomEventSecondGap=150}; // Don't resend OOM messages unless at least 150 seconds has passed
1.174 + enum {ERemovedEventHandlerWhileProcessingRawEvents=0x02};
1.175 +public:
1.176 + static void InitStaticsL();
1.177 + static void DeleteStatics();
1.178 + static CWsHotKey* ClearHotKeysL(TInt aHotKey);
1.179 + static void ResetDefaultHotKeyL(TInt aHotKey);
1.180 + static void SetHotKeyL(const TWsClCmdSetHotKey &aHotKey);
1.181 + static void AddCaptureKeyL(const TKeyCaptureRequest& aRequest);
1.182 + static void UpdateCaptureKeyL(const TKeyCaptureRequest& aRequest);
1.183 + static void CancelCaptureKey(TKeyCaptureType aType, TAny* aHandle);
1.184 + static void ClientDestroyed(CWsClient *aClient);
1.185 + static inline void AddToSwitchOnEventListL(const CWsWindowBase &aWindow, TEventControl aCircumstances);
1.186 + static inline void RemoveFromSwitchOnEventList(const CWsWindowBase &aWindow);
1.187 + static inline void AddToErrorMessageListL(const CWsWindowBase &aWindow, TEventControl aCircumstances);
1.188 + static inline void RemoveFromErrorMessageList(const CWsWindowBase &aWindow);
1.189 + static inline void AddToModifierChangedEventListL(const CWsWindowBase &aWindow, TInt aModifierMask, TEventControl aCircumstances);
1.190 + static inline void RemoveFromModifierChangedEventList(const CWsWindowBase &aWindow);
1.191 + static inline void AddToGroupChangeEventListL(const CWsWindowBase &aWindow);
1.192 + static inline void RemoveFromGroupChangeEventEventList(const CWsWindowBase &aWindow);
1.193 + static inline void AddToFocusChangeEventListL(const CWsWindowBase &aWindow);
1.194 + static inline void RemoveFromFocusChangeEventEventList(const CWsWindowBase &aWindow);
1.195 + static inline void AddToGroupListChangeEventListL(const CWsWindowBase &aWindow);
1.196 + static inline void RemoveFromGroupListChangeEventEventList(const CWsWindowBase &aWindow);
1.197 + static inline void AddToScreenDeviceChangeEventListL(const CWsWindowBase &aWindow);
1.198 + static inline void RemoveFromScreenDeviceChangeEventList(const CWsWindowBase &aWindow);
1.199 + static TInt GetModifierState();
1.200 + static inline TInt GetStoredModifierState();
1.201 + static void SetModifierState(TEventModifier aModifier,TModifierState aState);
1.202 + static void ProcessRawEvent(const TRawEvent& aRawEvent);
1.203 + static void ProcessKeyEvent(const TKeyEvent& aKeyEvent,TInt aRepeats);
1.204 + static TBool MousePress(const TRawEvent &aRawEvent, const CWsWindowGroup *aGroupWin);
1.205 + static void SendGroupChangedEvents();
1.206 + static void SendFocusChangedEvents();
1.207 + static void SendGroupListChangedEvents();
1.208 + static void SendVisibilityChangedEvents(CWsWindowBase* aWin, TUint aFlags);
1.209 + static TBool SendDisplayChangedEvents(CWsClient *aWsClient, TInt aDisplayNumber, TInt aConfigurationChangeId, TInt aResolutionListChangeId);
1.210 + static void SendScreenDeviceChangedEvents(CScreen* aScreen);
1.211 + static void SendScreenDeviceChangedEvent(const CWsWindowBase *aWindow);
1.212 + static TBool ProcessErrorMessages(TWsErrorMessage::TErrorCategory aCategory, TInt aError);
1.213 + static void NotifyOom();
1.214 + static void ProcessKeyPress(const TKeyEvent& aKeyEvent, TBool aCheckRepeat,TInt aRepeats);
1.215 + static void QueueKeyPress(const TKeyEventRouterOutput& aOutput, TBool aIsRepeat, TInt aRepeats);
1.216 + static void AddEventHandler(MEventHandler *aEventHandler, TBool aAdvancedPointersEnabled);
1.217 + static void RemoveEventHandler(const MEventHandler *aEventHandler);
1.218 + static void PotentialEventHandlerL(TInt aNum);
1.219 + static TInt AddNotificationHandler(CAnim* aAnim, TUint32 aNotifications);
1.220 + static void RemoveNotificationHandler(CAnim* aAnim);
1.221 + static void PublishNotification(const TWsEvent& aWsEvent);
1.222 + static TInt RegisterDrawerHandler(CWsGraphicDrawer* aDrawer, TUint32 aEvents);
1.223 + static TInt UnregisterDrawerHandler(CWsGraphicDrawer* aDrawer);
1.224 + static TInt RegisterWsEventHandler(MWsEventHandler * aHandler, TUint32 aEvents);
1.225 + static TInt UnregisterWsEventHandler(MWsEventHandler * aHandler);
1.226 + static void NotifyDrawer(const TWservCrEvent& aEvent);
1.227 + static void NotifyScreenDrawingEvent(const TRegion* aRegion);
1.228 + static void NotifyScreenDrawingEvent(const TRect& aRect);
1.229 + static inline const CRawEventReceiver* EventReceiver() {return iEventReceiver;}
1.230 +private:
1.231 + class TRawEventHandler
1.232 + {
1.233 + public:
1.234 + inline TRawEventHandler(MEventHandler *aEventHandler, TBool aAdvancedPointersEnabled);
1.235 + public:
1.236 + MEventHandler *iEventHandler;
1.237 + TBool iAdvancedPointersEnabled;
1.238 + };
1.239 + static void ProcessEventQueue(TEventRequestQueue &aQueue, TSendEventFunc aFunc, TInt aParam1, TInt aParam2);
1.240 + static void DeleteHotKeys();
1.241 + static void QueueKeyEvent(CWsWindowGroup *aWin, TWsEvent &aEvent, TWservEventPriorities aPriority);
1.242 + static void QueueKeyUpDown(const TRawEvent &aRawEvent);
1.243 + static void ConstructDefaultHotKeyL(TInt aHotKey, const TWsWinCmdCaptureKey &aSystemKey);
1.244 + static void ProcessModifierChanges();
1.245 + static void LinkHotKey(CWsHotKey *aWsHotKey);
1.246 + static TBool DrawerCompareFunc(const TDrawerHandler& lhs, const TDrawerHandler& rhs);
1.247 +private:
1.248 + static CKeyTranslator *iKeyTranslator;
1.249 + static TEventRequestQueue iSwitchOnQueue;
1.250 + static TEventRequestQueue iErrorMessageQueue;
1.251 + static TEventRequestQueue iModifierChangedQueue;
1.252 + static TEventRequestQueue iGroupChangedQueue;
1.253 + static TEventRequestQueue iFocusChangedQueue;
1.254 + static TEventRequestQueue iGroupListChangedQueue;
1.255 + static TEventRequestQueue iScreenDeviceChangedQueue;
1.256 + static TTime iPrevOomMessageTime;
1.257 + static CCaptureKeys *iCaptureKeys;
1.258 + static CKeyEventRouter *iKeyEventRouter;
1.259 + static RLibrary iKeyEventRouterLibrary;
1.260 + static CWsHotKey *iHotKeys;
1.261 + static TInt iModifierState;
1.262 + static CRawEventReceiver *iEventReceiver;
1.263 + static RArray<TRawEventHandler> iEventHandlers;
1.264 + static CArrayFixFlat<SNotificationHandler> *iNotificationHandlers;
1.265 + static TInt iPotentialEventHandlers;
1.266 + static RArray<TDrawerHandler>* iDrawerHandlers;
1.267 + static RArray<TWsEventHandler> iWsEventHandlers;
1.268 + static TUint32 iBinaryFlags;
1.269 + static TInt iEventHandlerCount;
1.270 + };
1.271 +
1.272 +
1.273 +//
1.274 +// inlines //
1.275 +//
1.276 +
1.277 +inline TBool CKeyboardRepeat::IsAreadyActive()
1.278 + {
1.279 + return iThis->IsActive();
1.280 + }
1.281 +
1.282 +inline TWindowServerEvent::TRawEventHandler::TRawEventHandler(MEventHandler *aEventHandler, TBool aAdvancedPointersEnabled)
1.283 +: iEventHandler(aEventHandler), iAdvancedPointersEnabled(aAdvancedPointersEnabled)
1.284 + { }
1.285 +
1.286 +inline void TWindowServerEvent::AddToSwitchOnEventListL(const CWsWindowBase &aWindow, TEventControl aCircumstances)
1.287 + {iSwitchOnQueue.AddToEventRequestListL(aWindow, 0, aCircumstances);}
1.288 +inline void TWindowServerEvent::AddToErrorMessageListL(const CWsWindowBase &aWindow, TEventControl aCircumstances)
1.289 + {iErrorMessageQueue.AddToEventRequestListL(aWindow, 0, aCircumstances);}
1.290 +inline void TWindowServerEvent::AddToModifierChangedEventListL(const CWsWindowBase &aWindow, TInt aModifierMask, TEventControl aCircumstances)
1.291 + {iModifierChangedQueue.AddToEventRequestListL(aWindow, aModifierMask, aCircumstances);}
1.292 +inline void TWindowServerEvent::AddToGroupChangeEventListL(const CWsWindowBase &aWindow)
1.293 + {iGroupChangedQueue.AddToEventRequestListL(aWindow, 0, EEventControlAlways);}
1.294 +inline void TWindowServerEvent::AddToFocusChangeEventListL(const CWsWindowBase &aWindow)
1.295 + {iFocusChangedQueue.AddToEventRequestListL(aWindow, 0, EEventControlAlways);}
1.296 +inline void TWindowServerEvent::AddToGroupListChangeEventListL(const CWsWindowBase &aWindow)
1.297 + {iGroupListChangedQueue.AddToEventRequestListL(aWindow, 0, EEventControlAlways);}
1.298 +inline void TWindowServerEvent::AddToScreenDeviceChangeEventListL(const CWsWindowBase &aWindow)
1.299 + {iScreenDeviceChangedQueue.AddToEventRequestListL(aWindow, 0, EEventControlAlways);}
1.300 +
1.301 +inline void TWindowServerEvent::RemoveFromSwitchOnEventList(const CWsWindowBase &aWindow)
1.302 + {iSwitchOnQueue.RemoveFromEventRequestListL(aWindow);}
1.303 +inline void TWindowServerEvent::RemoveFromErrorMessageList(const CWsWindowBase &aWindow)
1.304 + {iErrorMessageQueue.RemoveFromEventRequestListL(aWindow);}
1.305 +inline void TWindowServerEvent::RemoveFromModifierChangedEventList(const CWsWindowBase &aWindow)
1.306 + {iModifierChangedQueue.RemoveFromEventRequestListL(aWindow);}
1.307 +inline void TWindowServerEvent::RemoveFromGroupChangeEventEventList(const CWsWindowBase &aWindow)
1.308 + {iGroupChangedQueue.RemoveFromEventRequestListL(aWindow);}
1.309 +inline void TWindowServerEvent::RemoveFromFocusChangeEventEventList(const CWsWindowBase &aWindow)
1.310 + {iFocusChangedQueue.RemoveFromEventRequestListL(aWindow);}
1.311 +inline void TWindowServerEvent::RemoveFromGroupListChangeEventEventList(const CWsWindowBase &aWindow)
1.312 + {iGroupListChangedQueue.RemoveFromEventRequestListL(aWindow);}
1.313 +inline void TWindowServerEvent::RemoveFromScreenDeviceChangeEventList(const CWsWindowBase &aWindow)
1.314 + {iScreenDeviceChangedQueue.RemoveFromEventRequestListL(aWindow);}
1.315 +inline TInt TWindowServerEvent::GetStoredModifierState()
1.316 + {return(iModifierState);}
1.317 +
1.318 +#endif