WTL (Windows Template Library [from ATL])

Note: How to make WTL available

Local

• Dialog Box, Adding a
• Example
• Gotchas
• Message Map Macros
• Menu Info
• Optimizations
• Wrapper Classes, list of

External

• ddx/ddv (synching data with dialog controls) http://www.codeproject.com/wtl/propsheetddx.asp
• Code Project WTL for MFC Programmers Part 1
• Using the ATL Windowing Classes
• WTL from microsoft http://www.microsoft.com/downloads/details.aspx?FamilyId=1BE1EB52-AA96-4685-99A5-4256737781C5&displaylang=en
• http://www.sellsbrothers.com/tools/#wtl
• http://www.codeproject.com/wtl/
• OpenGL http://www.codeproject.com/wtl/opengl.asp#xx66235xx

Misc (External)

• Message Cracker Wizard
• WTL Reference of some sort

Adding a Dialog Box

Menu Info

Adding a Menu to a window

1. Goto resource view and create the menu.
2. Load the menu like this:

   CMenu menu;
   menu.Attach( LoadMenu( _Module.GetResourceInstance(), MAKEINTRESOURCE(IDR_MENU1)));

3. Include the menu in the windows create

   TestWin.Create( NULL, rcPos, _T("Name Goes Here"), 0, 0, (HMENU)menu);
   

4. Add handlers to the Message map:

   BEGIN_MSG_MAP(CATLWindow)
   	MESSAGE_HANDLER( WM_CLOSE, OnClose)
   	// to link a method per item:
   	COMMAND_ID_HANDLER( ID_MENU_ITEM_1, OnMenuItem1)
   	COMMAND_ID_HANDLER( ID_MENU_ITEM_2, OnMenuItem1)
   	// to make a handler for all messages at once:
   	MESSAGE_HANDLER( WM_COMMAND, OnMenu)
   END_MSG_MAP()

5. Here is what a COMMAND_ID_HANDLER func looks like:

   LRESULT OnMenuItem1( WORD code, WORD id, HWND hwnd, BOOL& bHandled)
   {
   	return 0;
   }
   

6. Here is what a MESSAGE_HANDLER func looks like:

   LRESULT OnMenu( UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled)
   {
   	PostQuitMessage(0);
   	return 0;
   }
   

7. That's it

Gotchas

• Forgetting to add #include "atlcontrols.h"

Optimizations

// If Default buttons are removed, remember to remove (and the functions):
	COMMAND_HANDLER(IDOK, BN_CLICKED, OnClickedOK)
	COMMAND_HANDLER(IDCANCEL, BN_CLICKED, OnClickedCancel)

NOTE: This no longer appears to be valid

// If ActiveX controls don't need to be hosted,
// This:
class CTestDialog : 
	public CAxDialogImpl<ctestdialog>
// Can be replaced with this:
class CTestDialog : 
	public CDialogImpl<ctestdialog>

Message Map Macros

Note: Set bHandled to false if you would like to tell the message handling system to continue passing the message on to other handlers (or leave it true to signal that you have processed the message, and no other handlers need to see it).

Message Map

BEGIN_MSG_MAP(CMainCtrl)
	MESSAGE_HANDLER( WM_PAINT, OnPaint)
	MESSAGE_HANDLER( WM_SETFOCUS, OnSetFocus)
	MESSAGE_HANDLER( WM_KILLFOCUS, OnKillFocus)
	MESSAGE_HANDLER( WM_CREATE, OnCreate)
	// Routes other messages to the chained MSG_MAP:
	CHAIN_MSG_MAP(CMoreMainCtrl)
ALT_MSG_MAP(1)
	MESSAGE_HANDLER( WM_LBUTTONDBLCLK, OnLButtonDblClick)
ALT_MSG_MAP( {AltMsgMapIdNumber} )
	...
END_MSG_MAP

Handlers

Handler Parameters

Function Signatures

Chaining Message Maps

Chaining Message Maps - Parameters

To use CHAIN_MSG_MAP_DYNAMIC the class defining the MSG_MAP must derive from CDynamicChain. It should use
BOOL SetChainEntry( DWORD dwChainId, CMessageMap* pObject, DWORD dwMsgMapId = 0)
to set where chainging for the registered id needs to go (the destination can be set [?and changed?] dynamically at run time)

Reflection

How is it used?? Somehow sends the original message plus OCM_BASE and sends it back to the child control that sent it.

Example

// DO NOT USE #include <windows.h>

// This part can go into stdafx.h:
#include <atlbase.h>
extern CComModule _Module;
#include <atlwin.h>
#include <atlcom.h>
//old way:		#include <atlcontrols.h>
//old way:		using namespace ATLControls;
#include <atlapp.h>
#include <atlctrls.h>
using namespace WTL;

// This should go into a .cpp file:

CComModule _Module;

class CATLWindow :
	public CWindowImpl<CATLWindow, CWindow,
		CWinTraits<WS_SIZEBOX | WS_CAPTION | WS_POPUPWINDOW | WS_VISIBLE, 0>
	>
{
public:
	CATLWindow()
	{
	}
	
	~CATLWindow()
	{
		if (::IsWindow(m_hWnd) ) {
			DestroyWindow();
		}
	}
	
	BEGIN_MSG_MAP(CATLWindow)
		MESSAGE_HANDLER( WM_CLOSE, OnClose)
	END_MSG_MAP()
	
	LRESULT OnClose( UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled)
	{
		PostQuitMessage(0);
		return 0;
	}
};

int APIENTRY WinMain( HINSTANCE hInst, HINSTANCE /*Prev*/, LPSTR lpCmdLine, int nCmdShow)
{
	_Module.Init( NULL, hInst);
	
	CATLWindow TestWin;
	RECT rcPos = { 0, 0, 300, 100 };
	TestWin.Create( NULL, rcPos, _T("Name Goes Here"));
	TestWin.ShowWindow(SW_SHOW);
	
	MSG msg;
	while( GetMessage(&msg, 0, 0, 0))
	{
		TranslateMessage(&msg);
		DispatchMessage(&msg);
	}
	
	return (int) msg.wParam;
}

How to make WTL available

Get the header file atlcontrols.h and put it somewhere reachable, ...\Vc7\include

Wrapper Classes, list of

• Main Wrappers
• Auxilliary Wrappers

Main Wrappers

Auxilliary Wrappers