WTL解析(1) CMessageLoop

突然ですが、WTLの理解をもう少し深くしたいので、WTLのクラス、マクロについて調べ、まとめていくことにしました。

先ず最初のクラスは、CMessageLoopです。

CMessageLoopの機能

a.WTLにおけるメッセージループの標準実装の提供

b.メッセージフィルタの制御

c.アイドル時処理の制御

CMessageLoopのメンバ、メソッド

CMessageLoopは、次のメンバ変数、メンバメソッドを持っています。

メンバ変数

メンバメソッド

• 
  Run
  
  メッセージループ本体
• 
  AddMessageFilter
  
  メッセージフィルタを登録します。
• 
  RemoveMessageFilter
  
  メッセージフィルタを削除します。
• 
  AddIdleHandler
  
  アイドルハンドラを追加します。
• 
  RemoveIdleHandler
  
  アイドルハンドラを削除します。
• 
  AddUpdateUI
  
  UpdateUIハンドラを追加します。
• 
  IsIdleMessage
  
  現在アイドル状態かどうかを検出します。
• 
  PreTranslateMessage
  
  メッセージをTransleteする前の処理を行います。
• 
  OnIdle
  
  アイドル時の処理を行います。

次に機能詳細を見ていきます。

a.WTLにおけるメッセージループの標準実装の提供

Windowsプログラミングではお決まりの処理、メッセージループの実装を提供します。
MFCでは隠蔽されて見えない部分ですね。

Run()メソッド

メッセージループの本体はRun()メソッドです。処理内容は、
1.メッセージを受け取り(GetMessage())、PreTranslateMessage(メッセージフィルタ）メソッドを呼び出す。

2.通常のメッセージTranslate,Dispatchをする

3.ユーザからのアクション（入力）がないとき、OnIdle(アイドル時処理)メソッドを呼び出す。

というものです。

1.と3.についてはb,cで詳しく見ていくとして、2.の部分を中心にのRunメソッドのソースを見てみます。

000465| // message loop
000466|     int Run()
000467|     {
000468|         BOOL bDoIdle = TRUE;
000469|         int nIdleCount = 0;
000470|         BOOL bRet;
000471|
000472|         for(;;)
000473|         {
000474|             while(bDoIdle && !::PeekMessage(&m_msg, NULL, 0, 0, PM_NOREMOVE))
000475|             {
000476|                 if(!OnIdle(nIdleCount++))
000477|                     bDoIdle = FALSE;
000478|             }
000479|
000480|             bRet = ::GetMessage(&m_msg, NULL, 0, 0);
000481|
000482|             if(bRet == -1)
000483|             {
000484|                 ATLTRACE2(atlTraceUI, 0, _T("::GetMessage returned -1 (error)\n"));
000485|                 continue;   // error, don't process
000486|             }
000487|             else if(!bRet)
000488|             {
000489|                 ATLTRACE2(atlTraceUI, 0, _T("CMessageLoop::Run - exiting\n"));
000490|                 break;   // WM_QUIT, exit message loop
000491|             }
000492|
000493|             if(!PreTranslateMessage(&m_msg))
000494|             {
000495|                 ::TranslateMessage(&m_msg);
000496|                 ::DispatchMessage(&m_msg);
000497|             }
000498|
000499|             if(IsIdleMessage(&m_msg))
000500|             {
000501|                 bDoIdle = TRUE;
000502|                 nIdleCount = 0;
000503|             }
000504|         }
000505|
000506|         return (int)m_msg.wParam;
000507|     }