AfxOleCanExitApp

更新 : 2007 年 11 月

アプリケーションが終了できるかどうかを示します。

BOOL AFXAPI AfxOleCanExitApp( );

戻り値

アプリケーションが終了可能な場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

アプリケーションのオブジェクトが明示的に参照されている場合、アプリケーションは終了できません。グローバル関数 AfxOleLockApp と AfxOleUnlockApp は、それぞれアプリケーション オブジェクトの参照カウンタを増加、減少させます。このカウンタが 0 以外の場合、アプリケーションは終了できません。このカウンタが 0 以外のときにユーザーがシステム メニューの [閉じる] をクリックするか [ファイル] メニューの [終了] を選択すると、アプリケーションのメイン ウィンドウは (破棄されずに) 非表示になります。フレームワークは、この関数を CFrameWnd::OnClose で呼び出します。

使用例

// Helper exit function for automation server
BOOL CMainFrame::CanExit()
{
   if (AfxOleCanExitApp())
   {
      // No outstanding object counts - go ahead and exit
      return TRUE;
   } 
   else
   {
      // There are outstanding OLE object counts...
      // hide app to give user impression that application has exited.
      ShowWindow(SW_HIDE);
      // take user out of control of the app
      AfxOleSetUserCtrl(FALSE);
      return FALSE;
   }
}

必要条件

ヘッダー : <afxdisp.h>

参照

概念

MFC マクロとグローバル

参照

AfxOleLockApp

AfxOleUnlockApp