OfferKeyEventL()和HandleKeyEventL()

by spurs       http://blog.csdn.net/spurs/archive/2007/11/03/1864831.aspx

 

做symbian平台以来，很少用到对非soft按键的处理。平时都只用HandleCommandL（） 就可以了，昨天突然想使用对其他按键的事件的处理。控件CCoeControl里面有个虚函数OfferKeyEventL(),AppUi里面也有个函数 HandleKeyEventL()，两个都可以对按键事件进行处理。为了确认他们的执行顺序，加了断点，做以下实验。

EMCCSoft里面的一个普通的例子，controls，在里面有个simpleVIew类，里面包含有继承自CCoeControl的类 SimpleControl，SimpleControl实现了函数OfferKeyEventL（），然后在simpleView的 ConstructL（）里面把SimpleControl加j进了控件栈，AddToStack()。

   当没有加入控件栈的时候，进入系统后，无论怎么按按键，一直都是执行AppUI里面的HandleKeyEventL().当没有加入控件栈时候，让 AppUI里面的HandleKeyEventL（）返回EKeyEventWasConsumed，就没有进入到单步调试页面.

    当加入控件栈的时候，让SimpleControl里面的OfferKeyEventL（）返回EKeyWasConsumed，则首先执行OfferKeyEventL（），然后执行AppUi里面的HandleKeyEventL()。

   让SimpleControl里面的OfferKeyEventL()返回EKeyWasConsumed,则按下按键后，就一直在SimpleControl里面的OfferKeyEventL()执行。

    让SimpleControl（）里面的OfferkeyEventL（）返回EKeyWasNotConsumed，则AppUi里面的 HandleKeyEventL（）也返回EKeyEventWasNotConsumed，则首先执行SimpleControl里面的 OfferKeyEventL()，然后执行AppUi里面的HandleKeyEventL().

   让SimpleControl()里面的OfferKeyEvent返回EKeyWasNotconsumed，AppUi里面的 HandleKeyEventL()返回EKeyWasConsumed.则一直在SimpleControl里面的OfferLeyEventL()里面操作两个都EKeyWasConsumed的时候，出错，一直在调试状态，没有办法显示图像。

 

by  

cool_li

 

OfferKeyEventL()

 

virtual TKeyResponse OfferKeyEventL(const TKeyEvent& aKeyEvent,TEventCode aType);

这个函数专门用于处理键盘事件，如果对程序的交互和运行需要通过键盘控制，那么视图类就应该去实现这个方法。如果类实现这个方法，特别需要注意的是，若对象没有对键盘事件作出响应那么应该返回EKeyWasNotConsumed ，反之，若对象对该键盘事件做出了响应那么就要返回EKeyWasConsumed。当键盘事件发生时，控制框架调用每一个在控件栈中对象的 OfferKeyEventL()函数，直到他们中其中的一个可以处理这个键盘事件并返回EKeyWasConsumed。

参数：
const TKeyEvent& aKeyEvent ：键盘事件。TKeyEvent 类描述了键盘事件的细节，他包括四个属性，分别是iCode, iModifiers, iRepeats, iScanCode 。当处理一个TKeyEvent的时候，TStdScanCode型的iScanCode通常被TKeyCode型的iCode取代。

TEventCode aType ：键盘事件类型，包括：EEventKey, EEventKeyUp or EEventKeyDown


返回值指明对象是否处理了这个键盘事件。

任意一个键盘的按键事件都将导致三个独立的事件:EEventKeyDown, EEventKey和EEventKeyUp,事实上他们触发的顺序也是这个样子的。为可以获得可以被OfferKeyEventL()函数处理的键盘事件，应用程序必须调用CCoeAppUi::AddToStackL()方法，把控件压入到栈中。这只是对控件起作用，而不是组成控件的控件组件。复合控件如果有需要的话也可以把键盘事件传递给他们的组件控件，但是组件控件本身并不可以在控制栈上。

如果一个类覆盖了 CCoeControl::OfferKeyEventL() 方法那么他同时也要覆盖InputCapabilities() 虚函数，返回一个TCoeInputCapabilities 对象，这个对象的属性符合OfferKeyEventL()函数的行为。通常没有必要在内部调用InputCapabilities() 方法，而这个方法也一般被UI控制框架调用。

 

 

 

 

 

 

当用户按下一个键后，keyboard hardware就会生成一个中断，由keyboard driver捕捉,之后分解出这次按键事件的key code，然后driver将它发送到系统端的一个线程——被称为window server，而window server又会把它发向在window group中拥有焦点的那个应用程序中，这个步骤是使用一个control environment(CONE)来完成的，它是window server和user interface library之间的一个API函数。

从api函数中可以看出这个处理过程当windows server发送一个按键的事件便调用AppUI中的HandleWsEventL()，HandleWsEventL()方法首先调用CCoeControl::OfferKeyEventL()如果OfferKeyEvent()返回EKeyWasNotConsumed则继续调用AppUI中的HandleKeyEventL()。如果OffKeyEventL()处理了事件则返回EKeyWasConsumed。

如果想直接调用AppUI中的HandleKeyEventL()可以通过set ECoeStackFlagRefusesAllKeys 来省去调用OfferKeyEventL()。

每次按键都会产生3个事件类型1 EEventKeyDown，2 EEventKeyUp，3 EEventKeyDown；可以从OfferKeyEventL(const TKeyEvent& aKeyEvent,TEventCode aType)中的aType中得到事件类型。aKeyEvent是一个struct可以得到按键的更多属性，eg：iCode指名按了哪个键(键名在e32keys.h中)iRepeats可以判断是重复按键还是长按键。如果想改变系统的按键重复率可以通过RWsSession 的SetKeyboardRepeatRate方法来设置。

S60手机默认情况下是不能接受连续按键的且只有先按下的键可以被接受（也就是按键阻塞，电源键和编辑键默认为非按键阻塞）。可以通过s60提供的CAKnAppUI中的SetKeyBlockMode()方法来取消按键阻塞。