Применение Windows API

WinException {
public:
 WinException(char* msg) : _err(::GetLastError), _msg(msg) {}
 DWORD GetError const { return _err; }
 char const* GetMessage const { return _msg; }
private:
 DWORD _err;
 char * _msg;
};

// The out-of-memory handler: throws exception
int NewHandler(size_t size) {
 throw WinException( "Out of memory");
 return 0;
}

class ResString {
 enum { MAX_RESSTRING = 255 };
public:
 ResString(HINSTANCE hInst, int resId);
 operator char const* { return _buf; }
private:
 char _buf[MAX_RESSTRING + 1];
};

ResString::ResString(hinstance hinst, int resid) {
 if (!::LoadString(hinst, resid, _buf, max_resstring + 1)) throw WinException ("Load String failed");
}

Controller

Контроллер — нервная система отдельного экземпляра окна. Он создается с этим окном, хранится с ним и, в заключение, разрушается вместе с ним. Вы можете помещать любую информацию о состоянии, имеющую отношение к специфическому экземпляру окна в его контроллер. Вообще же, контроллер содержит "Вид", который имеет дело с рисованием на поверхности окна, и он имеет доступ к "Модели", которая является мозгом вашего приложения (все это называется MVC, или образцом "Модель-Вид-Контроллер" ("Model-View-Controller"), изобретенным Smalltalk-программистами.

Если, как это часто бывает, ваше приложение имеет только одно окно верхнего уровня, Вы можете непосредственно включать модель в ее контроллер. Это упрощает управление ресурсами, но ценой усиления связи контроллера с моделью. В больших проектах нужно избегать таких связей. Предпочтительнее использовать внутри контроллера "интеллектуальный" указатель на модель.

Большинство методов контроллера требует дескриптора окна, с которым они взаимодействуют. Этот дескриптор передается с каждым сообщением Windows, но проще сохранить его один раз внутри контроллера и использовать всякий раз, когда он необходим. Помните — имеется взаимно однозначное соответствие между контроллерами и экземплярами окон (а следовательно, и их дескрипторами).

class Controller {
public:
 Controller(HWND hwnd, CREATESTRUCT * pCreate);
 ~Controller;
 void Size(int x, int y);
 void Paint;
 void Command(int cmd);
private:
 HWND _hwnd;
 Model _model;
 View _view;
};

Оконная процедура — основной коммутационный узел Windows приложения. Вы не вызываете ее из вашей программы — ее вызывает Windows! Каждый раз когда случается что-то интересное, Windows посылает вашей программе сообщение. Это сообщение передается оконной процедуре. Вы можете обработать его, или передать оконной процедуре, заданной по умолчанию.

Оконная процедура вызывается с указанием дескриптора к окна, к которому направлено данное сообщение. Этот дескриптор однозначно идентифицирует внутреннюю структуру данных Windows, которая соответствует экземпляру окна. Это так часто случОконная процедура вызывается с указанием дескриптора к окна, к которому направлено данное сообщение. Этот дескриптор однозначно идентифицирует внутреннюю структуру данных Windows, которая соответствует экземпляру окна. Это так часто случается, что мы можем обращаться к этой структуре данных и использовать ее, чтобы сохранить некоторые специфические для экземпляра данные. Имеется типовой безопасный способ доступа к этой структуре. Между прочим, элемент GWL_USERDATA этой структуры гарантированно присутствует во всех окнах, включая окна сообщения, диалоговые окна и даже кнопки.

template <class T> inline T
WinGetLong(hwnd hwnd, int which = gwl_userdata) {
 return reinterpret_cast<T>(::GetWindowLong (hwnd, which));
}
template <class T> inline void
WinSetLong(hwnd hwnd, t value, int which = gwl_userdata) {
 ::SetWindowLong(hwnd, which, reinterpret_cast<long>(value));
}

Каждый раз, когда Windows вызывает нашу оконную процедуру, мы хотим сначала восстановить ее контроллер. Вспомните, что может быть несколько окон, совместно использующих ту же самую оконную процедуру, и мы хотим иметь отдельный контроллер для каждого окна. Как мы узнаем, какой из контроллеров используетсять, когда произходит обратный вызов оконной процедуры? Мы можем выяснить это, рассмотрев дескриптор окна. В этом дескрипторе мы сохраняем указатель на контроллер данного окна, используя функцию Win[Set/Get]Long.

Оконная процедура сначала вызывается с сообщением WM_CREATE. В этот момент мы создаем экземпляр контроллера, нициализируем его дескриптором окна и специальной структурой данных по имени CREATESTRUCT, которая передана нам от Windows. Если же мы уже имеем контроллер, то сохраняем указатель на его в соответствующей внутренней Windows-структуре данных помеченной текущим hwnd. В следующий раз оконная процедура вызывается с сообщением, отличным от WM_CREATE, и мы просто восстанавливаем (отыскиваем) указатель на наш контроллер, используя hwnd.

Остальное просто. Оконная процедура интерпретирует параметры сообщения и вызывает соответствующие методы контроллера.

LRESULT CALLBACK WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam) {
 Controller * pCtrl = WinGetLong<Controller *>(hwnd);
 switch (message) {
 case WM_CREATE: // Have to catch exception in case new throws!
 try {
 pCtrl = new Controller(hwnd, reinterpret_cast<CREATESTRUCT *>(lParam));
 WinSetLong<Controller *>(hwnd, pCtrl);
 } catch (WinException e) {
 ::MessageBox(hwnd, e.GetMessage, "Initialization", MB_ICONEXCLAMATION | MB_OK);
 return –1;
 } catch (…) {
 :: MessageBox(hwnd, "Unknown Error", "Initialization", MB_ICONEXCLAMATION | MB_OK);
 return –1;
 }
 return 0;