Something From HelloWorldPlus


對于HelloWorldPlus的分析可以從對象構建一步步深入，它和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的一個枚舉值。它指定默認的皮膚參數必須由
  // 在這個AppUi實例作用范圍內創建的組件提供
   BaseConstructL( EAknEnableSkin );

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

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

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

[1] CEikAppUi 的 BaseConstructL() 方法

protected: void BaseConstructL(TInt aAppUiFlags=0);

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

[2] CEikAppUi 的 ClientRect() 方法

TRect ClientRect() const;

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

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

[3] CEikAppUi 的 AddToStackL()方法

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

把控件放到控件棧中，這個函數經常被GUI應用程序使用，把應用程序視圖放置到控制棧中。

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

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

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

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

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

TInt aPriority=ECoeStackPriorityDefault

控件的棧有限權，這個參數以及其他一些優先權值都是通過一個匿名的枚舉類型定義的。

Tint aStackingFlags=ECoeStackFlagStandard

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

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

二 CCoeControl 類，以及 Draw()方法

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

class CHelloWorldPlusAppView : public CCoeControl
 {
  ……
  ……
 }

draw()方法有如下代碼：

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

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

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

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

   // Query what the current time is
  // 獲取系統當前時間
   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是這個函數的第一個重載版本，傳入一個資源 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的一個數據成員。
   gc.UseFont( iCoeEnv->NormalFont() );
  // 繪制無邊框的水平放置的字體
  // 如果該函數調用時，字體未設置，那么將發生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;

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

所有的圖形函數都是通過圖形環境實現的。

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

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

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

CWindowGc& gc = SystemGc();

[3] CWindowGc 類

窗口圖形環境

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

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

[4] CWindowGc 類的 UseFont()

virtual void UseFont(const CFont *aFont);

設置環境（上下文）字體

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

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

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

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

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

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

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

三、AppView 的 ConstructL() 方法

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

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

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

[1] CCoeControl 的 CreateWindowL()

protected: void CreateWindowL();

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

四、關于OfferKeyEventL()方法

// CHelloWorldPlusAppView::OfferKeyEventL()
// Handles keyevents.
// ---------------------------------------------------------------------------
// 對鍵盤事件的處理
// TKeyEvent鍵盤事件類。它描述了鍵盤事件的細節
// 說明事件的類型，是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);