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