MFCの基礎 - プログラムの終了のソースを表示

== 概要 ==
Windows APIにおけるプログラムの終了処理の流れを記載する。<br>
ここでは、プログラムをメニュー([ファイル] - [終了])から終了する方法を記載する。<br>
<br><br>

== ウィンドウの破棄とプログラムの終了 ==
[ファイル] - [終了]を選択した時のイベントハンドラで、SendMessage関数を使用してメインウィンドウにWM_CLOSEを発行する。<br>
ここで、SendMessage関数のプロトタイプ宣言は以下の通りである。<br>
 <source lang="c++">
 LRESULT SendMessage(HWND hWnd, UINT Msg, WPARAM wParam, LPARAM lParam);
 </source>
<br>
hWndで指定したウィンドウに、メッセージMsgを送る。メッセージに付随するデータがある場合は、wParamおよびlParamに設定する。<br>
ここでは、WM_CLOSEを発行しているが、WM_CLOSEの場合は、wParamおよびlParamは特に使用しないので0を指定する。<br>
<br>
サンプルコードでは、WM_CLOSEのイベントハンドラでは、MessageBox関数でメッセージを表示している。<br>
"Are you sure you want to quit thie program?"メッセージにおいて、[はい]ボタンを押下した場合、MessageBox関数は[IDYES]を返す。<br>
<br>
ウィンドウを破棄するためには、DestroyWindow関数を使用する。<br>
 <source lang="c++">
 BOOL DestroyWindow(HWND hWnd);
 </source>
<br>
DestroyWindow関数は、hWndで指定したウィンドウに、WM_DESTROYを発行してそれを破棄する。<br>
<br>
メニューのイベントハンドラで終了の確認を行わない理由は、<br>
[閉じる]ボタンが押下されて終了処理を行う場合、自動的にWM_CLOSEがウィンドウに発行されるからである。<br>
このため、メニューのイベントハンドラでは、WM_CLOSEを発行するだけにして、WM_CLOSEのイベントハンドラでウィンドウの破棄を行う。<br>
<br>
WM_DESTROYのイベントハンドラでは、PostQuitMessage関数を使用して、WM_QUITをメッセージキューにポストする。<br>
また、PostQuitMessage関数の引数として、プログラムの終了コードを渡すことができる。ここで渡した値は、WM_QUITのwParam値となる。<br>
WM_QUITを受け取るとGetMessage関数がFALSEとなるため、メッセージループが終了する。<br>
<br>
下図に、プログラムの終了確認の流れを示す。<br>
[[ファイル:WindowsProgram EndProcess 1.png|フレームなし|中央]]
<br><br>

== サンプルコード ==
 <source lang="c++">
 LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
 {
    int id;
    HWND hwndCtl;
    UINT codeNotify;
    PAINTSTRUCT ps;
    HDC hdc;
    RECT rect;
 
    switch(uMsg)
    {
       case WM_CLOSE:
          if(IDYES == MessageBox(hwnd, TEXT("Are you sure you want to quit this program?"), TEXT("Confirmation"), MB_YESNO))
          {
             DestroyWindow(hwnd);
          }
          break;
       case WM_COMMAND:
          id         = (int) LOWORD(wParam);
          hwndCtl    = (HWND) lParam;
          codeNotify = (UINT) HIWORD(wParam);
 
          switch(id)
          {
             case IDM_FILE_EXIT:
                SendMessage ( hwnd, WM_CLOSE, 0, 0 );
                break;
             case IDM_HELP_ABOUT:
                ::MessageBox(NULL, TEXT("Hello, About!"), TEXT("About This Program"), MB_OK);               
                break;          
          }
          break;
       case WM_PAINT:
          hdc = BeginPaint ( hwnd, &ps );
          GetClientRect ( hwnd, &rect );
          DrawText(hdc, TEXT("Hello, world!"), -1, &rect, DT_CENTER | DT_VCENTER | DT_SINGLELINE);
          EndPaint( hwnd, &ps );
          break;
       case WM_SIZE:
          InvalidateRect( hwnd, NULL, TRUE );
          break;
       case WM_DESTROY:
          ::PostQuitMessage( 0 );
          break;
       default:
          return DefWindowProc(hwnd, uMsg, wParam, lParam);
          break;
    }

     return 0;
 }
 </source>
<br><br>

__FORCETOC__
[[カテゴリ:MFC]]