Symbian平臺(tái),CEikEdwin文本框研究
自從開(kāi)始接觸Symbian,就覺(jué)得Symbian的UI編程非常困難。難在哪呢?因?yàn)椴恢繱ymbian控件的運(yùn)行機(jī)制,所以在編程過(guò)程中常會(huì)出現(xiàn)一些莫名其妙的錯(cuò)誤,讓人摸不著頭腦。
也許有人會(huì)說(shuō),SDK提供了一些UI的例子,可以進(jìn)行參考。這話倒是不錯(cuò),但問(wèn)題是例子中對(duì)相應(yīng)控件的語(yǔ)句的注釋不夠充分,最后還是被控件的語(yǔ)句弄得云里霧里的,也許寫例子的作者自己覺(jué)得,在代碼之中的邏輯是非常簡(jiǎn)單的,所以注釋就大大的省略了。但對(duì)于像小弟這種缺少對(duì)Symbian平臺(tái)內(nèi)核機(jī)制認(rèn)識(shí)的人來(lái)說(shuō),只能通過(guò)Debug一步一步跟了。
今天正好碰到個(gè)需求,需要做個(gè)類似控制臺(tái)的控件,將程序的運(yùn)行狀態(tài)通過(guò)文本的方式顯示在手機(jī)屏幕上,因?yàn)槠滹@示的字符只局限于英文和數(shù)字,所以就想到自定義一個(gè)繼承于CEikEdwin的文本框控件(CEikEdwin是Symbian中所有文本框類的基類),應(yīng)該能滿足需求。于是通過(guò)對(duì)控件從創(chuàng)建到使用再到析構(gòu)的過(guò)程,進(jìn)行了一些分析。現(xiàn)將得到的結(jié)果記錄在下面,與大家分享。
首先,因?yàn)镃StatusMonitor是繼承于CEikEdwin, 而CEikEdwin是個(gè)控件類,所以,CStatusMonitor也是個(gè)控件。既然是控件,按照Symbian程序的架構(gòu),控件就得放在容器里,所以CStatusMonitor的實(shí)例化過(guò)程就放在容器的ConstructL中了。
這里需要注意,對(duì)于容器來(lái)說(shuō),每個(gè)容器都必須有個(gè)窗口,要么是通過(guò)CreateWindowL()自己建一個(gè),要么就是通過(guò)SetContainerWindowL()用別人已經(jīng)建好的。這一步,必須放在所有容器ConstructL()函數(shù)中的第一步。
然后接著講CStatusMonitor的創(chuàng)建過(guò)程:既然是Symbian自定義控件,那就用Symbian的傳統(tǒng)構(gòu)造方法——二階段構(gòu)造:先通過(guò):
CStatusMonitor *self = new (ELeave) CStatusMonitor;
創(chuàng)建一個(gè)CStatusMonitor的實(shí)例,然后通過(guò)調(diào)用CStatusMonitor的ConstructL()方法,進(jìn)行真是構(gòu)造。這里著重講一下ConstructL()方法中需要做的事和順序:
首先,因?yàn)镾ymbian文本框控件的特殊性,上一步驟中的實(shí)例是一個(gè)還沒(méi)有初始化完的實(shí)例,因此需要調(diào)用CEikEdwin::ConstructL()方法,完成該實(shí)例的構(gòu)造,這也就是CStatusMonitor的ConstructL()中的第一步。CEikEdwin::ConstructL()的說(shuō)明和參數(shù)的解釋在SDK的文檔中有,在此就不作解釋了。
接著,為了能使CStatusMonitor能夠接受用戶通過(guò)按下方向鍵進(jìn)行光標(biāo)移動(dòng)的響應(yīng),需要通過(guò)SetFocus()將程序的焦點(diǎn)給CStatusMonitor。
然后,因?yàn)镃StatusMonitor是放在容器中的控件,因此需要使用容器的窗口作為自己的窗口,所以需要把容器的引用傳給CStatusMonitor,好讓CStatusMonitor在ConstructL中通過(guò)調(diào)用SetContainerWindowL()方法設(shè)置控件的父窗口。
此時(shí),如果需要給文本框加上滑動(dòng)塊,則可以通過(guò)調(diào)用CreateScrollBarFrameL()->SetScrollBarVisibilityL方法進(jìn)行設(shè)置,設(shè)置完后別忘了通過(guò)調(diào)用UpdateScrollBarsL對(duì)滑動(dòng)塊進(jìn)行更新。至此,CStatusMonitor的ConstructL完成。
接著回到容器的ConstructL()中,繼續(xù)執(zhí)行ActivateL()和SetRect()函數(shù),函數(shù)的作用請(qǐng)參見(jiàn)SDK,在此不詳細(xì)說(shuō)明。
值得注意的是,在執(zhí)行了ActivateL()后,程序會(huì)調(diào)用容器的CountComponentControls()函數(shù),獲取當(dāng)前容器中的控件數(shù),別忘了更新這個(gè)數(shù)目哦;還需要注意的是容器的ComponentControl函數(shù),該函數(shù)在CountComponentControls函數(shù)調(diào)用完后被調(diào)用,別忘了在相應(yīng)的case中加上相應(yīng)的控件指針,不然會(huì)報(bào)KERN-EXEC 3空指針錯(cuò)誤。
最后在SetRect()被調(diào)用后,容器的SizeChanged()函數(shù)會(huì)被調(diào)用,在這里,需要調(diào)用控件的SetExtent()函數(shù),設(shè)置控件出現(xiàn)的位置和尺寸大小,如果有滑塊,別忘了設(shè)置滑塊大小,設(shè)置完后再次調(diào)用UpdateScrollBarsL對(duì)控件進(jìn)行更新。
之后就是Symbian程序框架的事情了,編譯、運(yùn)行,文本框就可以顯示在手機(jī)屏幕上了。