CWinAppEx::LoadState

更新 : 2007 年 11 月

アプリケーション状態を Windows レジストリから読み込みます。

BOOL LoadState(
      CMDIFrameWndEx* pFrame,
   LPCTSTR lpszSectionName = NULL 
);
BOOL LoadState(
      CFrameWndEx* pFrame,
   LPCTSTR lpszSectionName = NULL 
);
BOOL LoadState(
      COleIPFrameWndEx* pFrame,
   LPCTSTR lpszSectionName = NULL 
);
virtual BOOL LoadState(
   LPCTSTR lpszSectionName = NULL,
      CFrameImpl* pFrameImpl = NULL 
);

パラメータ

  • [入力] pFrame
    フレーム ウィンドウ オブジェクトへのポインタ。このメソッドは、レジストリに保存されている状態情報をこのフレーム ウィンドウに適用します。

  • [入力] lpszSectionName
    レジストリ キーの相対パスを含む文字列。

  • [入力] pFrameImpl
    CFrameImpl オブジェクトへのポインタ。このメソッドは、レジストリに保存されている状態情報をこのフレーム ウィンドウに適用します。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

このメソッドは、アプリケーションの状態およびフレーム ウィンドウの状態情報を読み込みます。読み込まれたフレーム ウィンドウの情報は、指定されたフレーム ウィンドウに適用されます。フレーム ウィンドウを指定しなかった場合は、アプリケーション状態情報のみが読み込まれます。アプリケーション情報には、CMouseManager クラスCContextMenuManager クラスCKeyboardManager クラス、および CUserToolsManager クラス の状態が含まれます。

CFrameImpl::OnLoadFrame の既定の実装では、LoadState を呼び出します。

lpszSectionName パラメータはレジストリ エントリの絶対パスではありません。アプリケーションの既定のレジストリ キーの末尾に追加される相対パスです。既定のレジストリ キーを取得または設定するには、CWinAppEx::GetRegistryBase メソッドまたは CWinAppEx::SetRegistryBase メソッドを使用します。

必要条件

ヘッダー : afxwinappex.h

参照

概念

MFC 階層図

参照

CWinAppEx クラス

CWinAppEx::SaveState