Практическое руководство. Создание виртуальной схемы сообщений для класса шаблона
Сопоставление сообщения в MFC предоставляет эффективный способ непосредственно Windows сообщения в соответствующий экземпляр объекта C C++. Примеры целевых объектов схемы сообщений относятся классы MFC приложения, классы документов и представлений, классы элементов управления и т д
Объявлены, используя макрос BEGIN_MESSAGE_MAP объявлен, что традиционные сопоставления сообщений MFC начала сопоставления сообщений, запись макроса для каждого метода класса обработчика сообщений и, наконец макрос END_MESSAGE_MAP объявлен конца сопоставления сообщений.
Одно ограничение с макросом BEGIN_MESSAGE_MAP выполняется, когда он используется совместно с классом, содержащая аргументы шаблона. При использовании с шаблонным классом, этот макрос приведет к ошибке времени компиляции ошибку с отсутствующими параметрам шаблона при выполнении расширения макроса. Макрос BEGIN_TEMPLATE_MESSAGE_MAP был разработан для разрешения классы, содержащий один аргумент шаблона для объявления собственные схемы сообщений.
Пример
Рассмотрим пример, в котором класс MFC CListBox расширяется, чтобы обеспечить синхронизацию с внешним источником данных. Вымышленный класс CSyncListBox объявляется следующим образом:
// 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
};
Класс CSyncListBox атрибутами в одном типе, который описывает источник данных его синхронизировать с. Он также объявить 3 метода, которые будут участвовать в схеме классов сообщений: OnPaint, OnDestroy и OnSynchronize. Метод OnSynchronize реализуется следующим образом:
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;
}
Описанная выше реализация позволяет класс CSyncListBox, чтобы настроить на любом типе класса, который реализует метод GetCount, например CArray, CList и CMap. Функция StringizeElement шаблонная функция с прототипом:
// Template function for converting an element within a collection
// to a CString object
template<typename CollectionT>
CString StringizeElement(CollectionT* pCollection, INT iIndex);
Обычно схема сообщений для этого класса может быть определена следующим образом:
BEGIN_MESSAGE_MAP(CSyncListBox, CListBox)
ON_WM_PAINT()
ON_WM_DESTROY()
ON_MESSAGE(LBN_SYNCHRONIZE, OnSynchronize)
END_MESSAGE_MAP()
пользователя LBN_SYNCHRONIZE, где пользовательское сообщение, определенное приложением, например:
#define LBN_SYNCHRONIZE (WM_USER + 1)
Сопоставление вышеуказанное макроса не будет компилироваться, из-за факту, спецификация шаблона класса CSyncListBox будет потерян при выполнении расширения макроса. Макрос BEGIN_TEMPLATE_MESSAGE_MAP это решает, включив указанный параметр шаблона в развернутое сопоставление макроса. Схема сообщений для этого класса становится:
BEGIN_TEMPLATE_MESSAGE_MAP(CSyncListBox, CollectionT, CListBox)
ON_WM_PAINT()
ON_WM_DESTROY()
ON_MESSAGE(LBN_SYNCHRONIZE, OnSynchronize)
END_MESSAGE_MAP()
В следующем примере демонстрируется потребление примера класса CSyncListBox с помощью объекта CStringList:
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);
}
}
Для выполнения теста функция StringizeElement должен быть настроен для работы с классом CStringList:
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
}