The SBJ MVC Framework - The Model, from Abstraction to Realization

//------------------------------------------------------------------------------
// $Workfile: WndController.h $
// $Header: /SbjDev/SbjCore/WndController.h 4     10/14/08 1:12p Steve $
//
//	Copyright � 2008 SbjCat
// All rights reserved.
//
//
// *** Authors ***
//	 Steve Johnson
//
// $Revision: 4 $
//
//-----------------------------------------------------------------------------

#pragma once

#include "CmdTargetController.h"

namespace SbjCore
{
	namespace Mvc
	{
		struct WndControllerImpl;

		/** 

		The WndController class provides message management for 
		ControlledWndT classes. It is derived from CmdTargetController 
		and adds handling of non-CmdMsg Windows messages (WndMsgs).  
		For information on how message handling differs in the Mvc 
		framework from that in the MFC framework, see the Mvc overview. 

		When WndMsgs are received by the ControlledWndT they are
		first routed to its WndController so that the WndMsgHandlers 
		maintained in the handler map of its base Controller class can have
		an opportunity to handle the message before the default CWnd 
		MFC style message processing.		

		*/
		class AFX_EXT_CLASS WndController :	public CmdTargetController
		{
			DECLARE_DYNCREATE(WndController)
		public:
			WndController();
			
			virtual ~WndController();
		
		public:		
			void SetWnd(CWnd* p);

			CWnd* GetWnd() const;

			SbjCore::Utils::Menu::ItemRange PrepareCtxMenu(CMenu& ctxMenu);
			
		public:			

			BOOL HandleWndMsg(UINT message, WPARAM wParam, LPARAM lParam, LRESULT* pResult);
			
			bool CallDefaultFirst(UINT message);
			
		protected:
			virtual SbjCore::Utils::Menu::ItemRange OnPrepareCtxMenu(CMenu& ctxMenu);

		private:
			virtual bool OnRoutCmdMsg(UINT nID,		
				int nCode,							
				void* pExtra,						
				AFX_CMDHANDLERINFO* pHandlerInfo);	

		private:
			struct WndControllerImpl* const m_pImpl;
		};
		
		
	}
}

//*** Modification History ***
// $Log: /SbjDev/SbjCore/WndController.h $
// 
// 4     10/14/08 1:12p Steve
// Implemented Deletes