Something From HelloWorldPlus


對于HelloWorldPlus的分析可以從對象構(gòu)建一步步深入，它和HelloWorldBasic略有不同之處。

一、AppUi的 ConstructL() 方法

void CHelloWorldPlusAppUi::ConstructL()
 {
   // Initialise app UI with standard value.
   // Flag 'EAknEnableSkin' indicating that default skin parameters should be provided
   // by UI controls created within the scope of this AppUi instance.
   // 用一個標準的值初始化APP UI
  // EAknEnableSkin 是CCoeAppUi的一個枚舉值。它指定默認的皮膚參數(shù)必須由
  // 在這個AppUi實例作用范圍內(nèi)創(chuàng)建的組件提供
   BaseConstructL( EAknEnableSkin );

   // Create view object
  // 創(chuàng)建一個視圖對象
   iAppView = CHelloWorldPlusAppView::NewL( ClientRect() );

   // Add to control stack in order to get key presses.
  // 把視圖對象放入到 控件棧，以便獲得鍵盤事件。
   AddToStackL( iAppView );
 }

在這個函數(shù)中，首先調(diào)用了 BaseConstructL()方法，使用一個標準值初始化AppUi對象。然后調(diào)用自身的靜態(tài)構(gòu)造方法NewL()方法構(gòu)造自身，這里需要關(guān)注的是它的參數(shù) ClientRect() 方法，雖然這個函數(shù)再這里似乎沒有什么實際的用處，但是還是需要了解。AddToStackL()方法則把AppView對象放置到控件棧中，以便獲取鍵盤事件。于是我們要問，什么是控件棧 control stack，它是做什么用的？

[1] CEikAppUi 的 BaseConstructL() 方法

protected: void BaseConstructL(TInt aAppUiFlags=0);

使用一個標準的值來初始化App Ui對象，這個時候應用程序的標準的資源文件被讀取，除非這個函數(shù)被傳入了ENoAppResourceFile或 ENonStandardResourceFile。這個函數(shù)默認參數(shù)值是0，它指定應用程序用戶接口標志。

[2] CEikAppUi 的 ClientRect() 方法

TRect ClientRect() const;

獲得可被應用程序獲得用于繪制的屏幕區(qū)域，但是不包括以下這些區(qū)域：非應用程序區(qū)域，那些地方一直顯示幾乎不變的內(nèi)容、應用程序狀態(tài)欄、應用程序按鈕組、應用程序菜單欄、應用程序標題欄和工具欄。

這里需要重視的是，矩形的直角坐標系是和整個屏幕關(guān)聯(lián)的，例如矩形的左上角點的坐標值可能是(0，45)。這里的意思是，這個獲得的矩形在屏幕中的位置是由一個和屏幕對應的直角坐標系確定的，顯然這個坐標系的(0,0)點位于屏幕的左上角，x軸正向向下，y軸正向向右。

[3] CEikAppUi 的 AddToStackL()方法

void AddToStackL(CCoeControl* aControl,TInt aPriority=ECoeStackPriorityDefault,TInt aStackingFlags=ECoeStackFlagStandard);

把控件放到控件棧中，這個函數(shù)經(jīng)常被GUI應用程序使用，把應用程序視圖放置到控制棧中。

那么，什么是控制棧呢？ 一個UI控件同過把自身壓入控制棧注冊到鍵盤事件。典型的只有視圖對象會把自己加入到控制棧中，然后視圖對象通過OfferKeyEventL()函數(shù)再分配鍵盤事件給它的組件控件。

鍵盤事件被提供給控件棧上的控件，最后一個壓入控制棧的控件通過 OfferKeyEventL()方法首先獲得鍵盤事件，如果這個控件不對這個鍵盤事件做出響應，那么返回EKeyWasNotConsumed,然后鍵盤事件被傳遞到控件棧的下一個控件。

AppUi通常是控件棧的最底下的一個，所以它也是最后一個獲得鍵盤事件的，如果在它前面的控件都多這個鍵盤事件不趕興趣那就掄到AppUi去作出響應了。

AddToStackL() 方法有幾個參數(shù)可以看一下：

CCoeControl* aControl
將要被壓入控制棧的控件；

TInt aPriority=ECoeStackPriorityDefault

控件的棧有限權(quán)，這個參數(shù)以及其他一些優(yōu)先權(quán)值都是通過一個匿名的枚舉類型定義的。

Tint aStackingFlags=ECoeStackFlagStandard

控件的事件處理行為，這個參數(shù)和上面一個參數(shù)一樣，也是在一個匿名的枚舉類型中定義。

在上文中提到了OfferKeyEventL()方法，這個方法是CCoeControl的一個成員，關(guān)于這個函數(shù)的相關(guān)知識在下文中再做介紹。

二 CCoeControl 類，以及 Draw()方法

HelloWorldPlus 是一個以 EIKON 為模板（圖形框架）的應用，它的視圖類從 CCoeControl 類繼承。

class CHelloWorldPlusAppView : public CCoeControl
 {
  ……
  ……
 }

draw()方法有如下代碼：

// Draw 是一個CCoeControl 類的一個虛函數(shù)
void CHelloWorldPlusAppView::Draw( const TRect& /*aRect*/ ) const
 {

   // Get the standard graphics context
  // 獲得圖象環(huán)境，用于繪制圖形
  // CWindowGc 是一個窗口圖形環(huán)境類
   CWindowGc& gc = SystemGc();

   // 以默認構(gòu)造函數(shù)構(gòu)造一個矩形
  // 這個矩形包括了屏幕的全部面積
  TRect rect = Rect();

   // Clears the screen
  // 清楚屏幕（清楚矩形所包含的窗口）
   gc.Clear( rect );

   // Query what the current time is
  // 獲取系統(tǒng)當前時間
   TTime currentTime;
   currentTime.HomeTime();

   // Format the time into a descriptor, and handle any errors
   TBuf<32> timeAsText;
   _LIT ( KTimeFormat, "%H : %T : %S" );

   // Load a string from the resource file.
  // 從資源文件加載字符串
  // 當前使用的LoadLC是這個函數(shù)的第一個重載版本，傳入一個資源 ID
   HBufC* textResource = StringLoader::LoadLC( R_HEWP_TIME_FORMAT_ERROR );

   // 格式化時間文本
  TRAPD ( err, currentTime.FormatL( timeAsText, KTimeFormat ) );
   // 如果格式化時間文本出錯，那么把錯誤信息賦給時間文本
  if ( err != KErrNone )
 {
 timeAsText = *textResource;
 }

   // Write the time to the display
  // 在屏幕上輸出
  // iCoeEnv 是 CCoeEnv 型的一個CCoeControl的一個數(shù)據(jù)成員。
   gc.UseFont( iCoeEnv->NormalFont() );
  // 繪制無邊框的水平放置的字體
  // 如果該函數(shù)調(diào)用時，字體未設置，那么將發(fā)生Panic
   gc.DrawText( timeAsText, TPoint( 55,60 ) );

  gc.DrawText( timeAsText, TPoint( 55,100 ) );

   // Pop HBuf from CleanUpStack and Destroy it.
   CleanupStack::PopAndDestroy( textResource );
 }

[1] CCoeControl 類

控件的基類，所有控件類都從這個類繼承。

[2] CCoeControl 類的SystemGc() 方法

protected: CWindowGc& SystemGc() const;

獲得標準的圖形環(huán)境，以便在繪制控件時使用。

所有的圖形函數(shù)都是通過圖形環(huán)境實現(xiàn)的。

在圖形環(huán)境被繪制前，它必須已經(jīng)被激活；當它不再被需要的時候，圖形環(huán)境應該處于一種非活動狀態(tài)。當使用 Draw(), DrawNow() 或 DrawDeferred()完成圖形環(huán)境繪制，應用程序其實不需要去做這些事情，圖形繪制在控件框架中被完成 。對于應用程序初始化的繪制工作來說，程序并沒有使用DrawNow() 或DrawDeferred()這些函數(shù)，應用程序只需要使用ActivateGc() 方法激活圖形環(huán)境或使用 DeactivateGc() 方法使圖形環(huán)境處于非活動狀態(tài)。

SystemGc() 方法返回一個 CWindowG 型圖形環(huán)境引用。

在CHelloWorldPlusAppView類的Draw方法中個使用了SystemGc() 方法：

CWindowGc& gc = SystemGc();

[3] CWindowGc 類

窗口圖形環(huán)境

絕大多數(shù)的窗口環(huán)境繪制函數(shù)都映射到等價的 CFbsBitGc 類函數(shù)——他們作用于任意屏幕上與窗口左上角關(guān)聯(lián)的直角坐標系。

總體來說， 如果服務端函數(shù)遇到某些可以使之發(fā)生異常退出的情形時，并不異常退出，而是返回一個錯誤值，以說明函數(shù)發(fā)生異常退出的情況。這樣，leave可以在client/server分界點的適當?shù)囊粋?cè)被處理。

[4] CWindowGc 類的 UseFont()

virtual void UseFont(const CFont *aFont);

設置環(huán)境（上下文）字體

字體是用于文本繪制的。如果字體已經(jīng)位于字體位圖服務器的內(nèi)存中，那么GDI(圖形設備接口，Graphic Device Interface)就會共享那個拷貝。

GDI 可以在不同的上下文中實現(xiàn)純抽象組件。在它的底部定義了繪圖基本元素以及實現(xiàn)與設備無管繪圖的一些。

UseFont()函數(shù)必須在文本繪制之前調(diào)用，否則主調(diào)線程就會發(fā)生Panic。

該函數(shù)需要一個CFont型參數(shù)，它是一個設備字體。

在 HelloWorldPlus中，使用iCoeEnv->NormalFont()來獲得設備字體。

[5] 語句：iCoeEnv->NormalFont()

iCoeEnv 是 CCoeEnv 型的一個CCoeControl的一個數(shù)據(jù)成員。CCoeEnv、CCoeControl和CCoeAppUi一起組成了控件環(huán)境CONE（Component Enviroment）。
NormalFont()這個函數(shù)的作用是獲取標準的環(huán)境字體。這個字體在控件環(huán)境CONE初始化時被創(chuàng)建。

三、AppView 的 ConstructL() 方法

void CHelloWorldPlusAppView::ConstructL( const TRect& aRect )
 {
   // Create a window for this application view
  // 創(chuàng)建一個自己 App View 的窗口
   CreateWindowL();

   // Set the windows size
  // 設置自身窗口的尺寸，該函數(shù)的調(diào)用將導致 SizeChangedL（）函數(shù)被調(diào)用
   SetRect( aRect );

   // Activate the window, which makes it ready to be drawn
  // 激活這個窗口，使可被繪制
   ActivateL();
 }

[1] CCoeControl 的 CreateWindowL()

protected: void CreateWindowL();

創(chuàng)建一個控件的窗口，被創(chuàng)建的窗口屬于應用程序窗口組的子窗口。這個函數(shù)使一個指定控件成為一個窗口擁有的控件，并且通常在控件的 ConstructL()方法中被調(diào)用。

四、關(guān)于OfferKeyEventL()方法

// CHelloWorldPlusAppView::OfferKeyEventL()
// Handles keyevents.
// ---------------------------------------------------------------------------
// 對鍵盤事件的處理
// TKeyEvent鍵盤事件類。它描述了鍵盤事件的細節(jié)
// 說明事件的類型，是Press,keydown還是 keyup 或是其它
TKeyResponse CHelloWorldPlusAppView::OfferKeyEventL(
 const TKeyEvent& aKeyEvent,TEventCode aType )
 {

 // We only want the key press, not the key up/down event
 if ( aType == EEventKey )
 {
 // Check if the 2 key was pressed
 if ( aKeyEvent.iCode == KDeviceKeyTwo )
 {

 // Load a string from the resource file.
 HBufC* textResource = StringLoader::LoadLC( R_HEWP_KEY_TWO_PRESSED );

 CAknInformationNote* informationNote;
 informationNote = new ( ELeave ) CAknInformationNote;
 informationNote->ExecuteLD( *textResource );

 // Pop HBuf from CleanUpStack and Destroy it.
 CleanupStack::PopAndDestroy( textResource );
 return EKeyWasConsumed;
 }
 }

 // Return the default functionality
 return CCoeControl::OfferKeyEventL( aKeyEvent, aType );
 }

[1] OfferKeyEventL()

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