Como: criar um mapa da mensagem para uma classe de modelo
Mapeamento de mensagem no MFC fornece uma maneira eficiente para direcionar mensagens Windows para uma instância de objeto C++ apropriada.Exemplos de destinos de mapa de mensagem do MFC incluem classes do aplicativo, documento e exibir classes, classes de controle e assim por diante.
Tradicionais MFC mensagem mapas são declarados usando o BEGIN_MESSAGE_MAP macro para declarar o início do mapa da mensagem, uma entrada de macro para cada método de classe de manipulador de mensagem e, finalmente, o END_MESSAGE_MAP macro para declarar o fim do mapa da mensagem.
Uma limitação com o BEGIN_MESSAGE_MAP macro ocorre quando é usado em conjunto com uma classe que contém os argumentos de modelo.Quando usado com uma classe de modelo, essa macro causará um erro de tempo de compilação devido a parâmetros de modelo ausentes durante a expansão de macro.O BEGIN_TEMPLATE_MESSAGE_MAP macro foi projetada para permitir mapas de classes que contêm um argumento de modelo único para declarar sua própria mensagem.
Exemplo
Considere um exemplo onde o MFC CListBox classe é estendida para fornecer sincronização com uma fonte de dados externa.A fictícia CSyncListBox classe é declarada da seguinte maneira:
// Extends the CListBox class to provide synchronization with
// an external data source
template <typename CollectionT>
class CSyncListBox : public CListBox
{
public:
CSyncListBox();
virtual ~CSyncListBox();
afx_msg void OnPaint();
afx_msg void OnDestroy();
afx_msg LRESULT OnSynchronize(WPARAM wParam, LPARAM lParam);
DECLARE_MESSAGE_MAP()
// ...additional functionality as needed
};
O CSyncListBox classe é modelado em um único tipo que descreve a fonte de dados serão sincronizados com.Ele também declara três métodos que participarão do mapa da mensagem da classe: OnPaint, OnDestroy, e OnSynchronize.O OnSynchronize método é implementado da seguinte maneira:
template <class CollectionT>
LRESULT CSyncListBox<CollectionT>::OnSynchronize(WPARAM, LPARAM lParam)
{
CollectionT* pCollection = (CollectionT*)(lParam);
ResetContent();
if(pCollection != NULL)
{
INT nCount = (INT)pCollection->GetCount();
for(INT n = 0; n < nCount; n++)
{
CString s = StringizeElement(pCollection, n);
AddString(s);
}
}
return 0L;
}
A implementação acima permite que o CSyncListBox classe ser especializado em qualquer tipo de classe que implementa o GetCount método, como CArray, CList, e CMap.O StringizeElement é uma função de modelo protótipo pelo seguinte:
// Template function for converting an element within a collection
// to a CString object
template<typename CollectionT>
CString StringizeElement(CollectionT* pCollection, INT iIndex);
Normalmente, o mapa da mensagem para essa classe seria definido como:
BEGIN_MESSAGE_MAP(CSyncListBox, CListBox)
ON_WM_PAINT()
ON_WM_DESTROY()
ON_MESSAGE(LBN_SYNCHRONIZE, OnSynchronize)
END_MESSAGE_MAP()
onde LBN_SYNCHRONIZE é uma mensagem de usuário personalizado definida pelo aplicativo, tais como:
#define LBN_SYNCHRONIZE (WM_USER + 1)
O mapa de macro acima não serão compilados, devido ao fato de que a especificação de modelo para o CSyncListBox classe serão encontrada durante a expansão de macro.O BEGIN_TEMPLATE_MESSAGE_MAP macro soluciona isso incorporando o parâmetro do modelo especificado para o mapa de macro expandidas.O mapa da mensagem para essa classe torna-se:
BEGIN_TEMPLATE_MESSAGE_MAP(CSyncListBox, CollectionT, CListBox)
ON_WM_PAINT()
ON_WM_DESTROY()
ON_MESSAGE(LBN_SYNCHRONIZE, OnSynchronize)
END_MESSAGE_MAP()
A seguir demonstra o exemplo de uso de CSyncListBox classe usando um CStringList objeto:
void CSyncListBox_Test(CWnd* pParentWnd)
{
CSyncListBox<CStringList> ctlStringLB;
ctlStringLB.Create(WS_CHILD | WS_VISIBLE | LBS_STANDARD | WS_HSCROLL,
CRect(10,10,200,200), pParentWnd, IDC_MYSYNCLISTBOX);
// Create a CStringList object and add a few strings
CStringList stringList;
stringList.AddTail(_T("A"));
stringList.AddTail(_T("B"));
stringList.AddTail(_T("C"));
// Send a message to the list box control to synchronize its
// contents with the string list
ctlStringLB.SendMessage(LBN_SYNCHRONIZE, 0, (LPARAM)&stringList);
// Verify the contents of the list box by printing out its contents
INT nCount = ctlStringLB.GetCount();
for( INT n = 0; n < nCount; n++ )
{
TCHAR szText[256];
ctlStringLB.GetText(n, szText);
TRACE(_T("%s\n"), szText);
}
}
Para concluir o teste, o StringizeElement função deve ser especializada para trabalhar com o CStringList classe:
template<>
CString StringizeElement(CStringList* pStringList, INT iIndex)
{
if (pStringList != NULL && iIndex < pStringList->GetCount())
{
POSITION pos = pStringList->GetHeadPosition();
for( INT i = 0; i < iIndex; i++ )
{
pStringList->GetNext(pos);
}
return pStringList->GetAt(pos);
}
return CString(); // or throw, depending on application requirements
}