按键常用函数(以左按键为列):
void SetKeyHandler( FuncPtr funcPtr, U16 keyCode, U16 keyType );
void SetLeftSoftkeyFunction( void (*f)(void), MMI_key_event_type k );
void ChangeLeftSoftkey( U16 s, U16 i );
1. SetKeyHandler与SetLeftSoftkeyFunction
(1). SetKeyHandler
主要作用就是将需要起作用的函数的指针(funcPtr)注册到全局二维数组currKeyFuncPtrs[keyCode][keyType]的相应位置 ;
(2). SetLeftSoftkeyFunction
该函数内部主要流程:
Step1. 调用 register_left_softkey_handler( ),这个函数call SetKeyHandler: 注册三种按键状态函数(left_softkey_down/left_softkey_up/left_softkey_hold),然后再根据触发按键的状态来调用相应的函数
以left_softkey为例, 该函数首先首先刷新按键区域图像(redraw_softkey),然后执行关联函数softkey_functions[key][k]()(注:此处softkey_function[key][k]所对应的函数为Set_left_softkey_function()函数所注册的).
Step2. 在上一步里我们会发现,softkey_functions[key][k]里的函数指针没有初始化
通过 call set_left_softkey_function(f, k); --->softkey_functions[key][k] = f; 这样,就成功的把按键按下/放开的作用函数与具体的动作关联起来了。
Step3. 最后call SetInputboxLSKFunction(f)
--->将上述函数与特定的输入(如触摸笔)关联起来。
(3). 以上两个函数的主要区别:
SetLeftSoftkeyFunction可以识别长按状态并且可以关联触摸笔操作等。
2. ChangeLeftSoftkey
主要执行流程:
Step1. call change_left_softkey: 设置左软键图表,文字
Step2. redraw_softkey: 刷新左软键显示区域