Windows API.
Введение.
Это не книга, не учебник. Это статья, призванная помочь Вам в изучении Windows API на языке C/C++, но не учит языку. Многие программы написаны с использованием макросов, описанных в заголовочном файле <WindowsX.h>.
Начало.
Многие, начинающие изучать API (application programming interface – интерфейс программирования приложений), удивляются объему кода, сложности и тп, говорят, что проще сделать в Borlan® Builder®. Если Вы так думаете, то зачем читаете этот текст?
Вы еще здесь? Тогда продолжим серьезно и без лени.
Вот простейший код:
Код 1.0+NoWindow.cpp+------------------------------------------------
| Код |
#include <windows.h>
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpszCmdParam, int nCmdShow)
{
MessageBox(NULL, "Сказала собака баскервилей.", "Ну, здравствуй, Герасим.", MB_OK|MB_ICONEXCLAMATION);
return 0;
} |
Код 1.0+NoWindow.cpp+------------------------------------------------Конец
Что за прараметры?
Начнем с параметров главной функции. Кстати, это САМАЯ главная функция. Функция WndProc (о которой позже) является главной оконной процедурой.
Итак, параметры… HINSTANCE вообще интересный тип. Это своего рода дескриптор объекта (HANDLE).
В первом случае (hInstance) он указывает на тот исполняемый модуль, на основе которого запущен процесс данного кода. Проще говоря, указывает на файл “NoWindow.exe”.
Второй параметр (hPrevInstance) – пережиток Win16. В 32-разрядных приложениях не используется. Раньше обозначал предыдущий запущенный экземпляр данного приложения. Если не ноль, значит Бог есть! Однозначно.
Третий (lpszCmdParam) – строка параметров, которые были посланы программе при запуске. Если их не было, то строка пуста.
Четвертый (nCmdShow) – число, обозначающее вид окна при запуске. Например, свернутое, развернутое, нормальное.
Если решили изменить состояние окна во время выполнения приложения, то это сообщение посылается в окно функцией ShowWindow, например так:
| Код |
ShowWindow(hwnd, SW_SHOWMINIMIZED);
|
За одно, разберем параметры вызова MessageBox.
Первый – дескриптор окна, к которому принадлежит сообщение. Это нужно для того, что бы Windows знала, какое окно его вызвало и, соответственно, сделать его неактивным, пока вы не ответите в нем нажатием какой-нибудь кнопки.
Второй и третий – строки. Соответственно, текста сообщения и текста заголовка сообщения.
Четвертый – самый интересный. В нем указывается стиль сообщения. Они находятся в файле <WinUser.h>. Смотрите MSDN.
Делаем окно.
Начнем сразу с кода:
Код 2.0+SimWnd.cpp+------------------------------------------------
| Код |
#include <windows.h>
#include <windowsx.h>
#define SimWnd_DefProc DefWindowProc
LRESULT CALLBACK WndProc(HWND hwnd, UINT Message, WPARAM wParam, LPARAM lParam);
BOOL Register(HINSTANCE hInstance);
HWND Create(HINSTANCE hInstance, int nCmdShow);
static char szAppName[] = "SimWnd";
static HWND hMainWindow;
void SimWnd_OnDestroy(HWND hwnd);
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
LPSTR lpszCmdParam, int nCmdShow)
{
MSG Msg;
if (!Register(hInstance))
return FALSE;
if (!Create(hInstance, nCmdShow))
return FALSE;
while (GetMessage(&Msg, NULL, 0, 0))
{
TranslateMessage(&Msg);
DispatchMessage(&Msg);
}
return Msg.wParam;
}
BOOL Register(HINSTANCE hInstance)
{
WNDCLASS WndClass;
WndClass.style = CS_HREDRAW | CS_VREDRAW;
WndClass.lpfnWndProc = WndProc;
WndClass.cbClsExtra = 0;
WndClass.cbWndExtra = 0;
WndClass.hInstance = hInstance;
WndClass.hIcon = LoadIcon(NULL, IDI_APPLICATION);
WndClass.hCursor = LoadCursor(NULL, IDC_ARROW);
WndClass.hbrBackground = (HBRUSH)(COLOR_BTNFACE+1);
WndClass.lpszMenuName = NULL;
WndClass.lpszClassName = szAppName;
return (RegisterClass(&WndClass) != 0);
}
HWND Create(HINSTANCE hInstance, int nCmdShow)
{
HWND hwnd = CreateWindow(szAppName, szAppName,
WS_OVERLAPPEDWINDOW,
CW_USEDEFAULT, CW_USEDEFAULT,
CW_USEDEFAULT, CW_USEDEFAULT,
NULL, NULL, hInstance, NULL);
if (hwnd == NULL)
return FALSE;
ShowWindow(hwnd, nCmdShow);
UpdateWindow(hwnd);
return hwnd;
}
LRESULT CALLBACK WndProc(HWND hwnd, UINT Message,
WPARAM wParam, LPARAM lParam)
{
switch (Message)
{
HANDLE_MSG(hwnd, WM_DESTROY, SimWnd_OnDestroy);
default:
return SimWnd_DefProc(hwnd, Message, wParam, lParam);
}
}
void SimWnd_OnDestroy(HWND hwnd)
{
PostQuitMessage(0);
}
|
Код 2.0+SimWnd.cpp+------------------------------------------------Конец
Разбор полетов.
Не маленький код . Но не надо бояться – этот код копируется из приложения в приложение и не надо его учить наизусть (хотя, если есть желание…).
Итак, посмотрим. Три шага создания окна:
1) Регистрация. (Register())
2) Создание. (Create())
3) Обработка сообщений. (WndProc())
Когда мы создаем оконное приложение, мы как бы делаем подкласс объекта «окно» благодаря этим трем шагам. Поясню. При создании кнопки (класс “button”) , регистрацию и обработку сообщений выполняет система, а создание – программист. Программист также может создать свой класс кнопки и сделать ей любые свойства такие, как подсветка или градиент. Но об этом когда-нибудь потом.
При регистрации, мы сообщаем системе, в основном, название нового класса и процедуру обработки его сообщений, ну и некоторые элементы внешнего вида и другие параметры.
Создание окна – тут все просто. Вызов функции CreateWindow(). А при создании нового окна, после этой вызываются ShowWindow() и UpdateWindow(). Они призваны соответственно показать и обновить окно.
Самое сложное и обычно наиболее емкое по коды – это обработка сообщений. Есть такая штука – DefWindowProc – стандартная оконная процедура. Все наше окно полностью работает за счет этой процедуры. Только я поступил так, как делают многие программисты:
| Код |
#define SimWnd_DefProc DefWindowProc
|
Просто дал ей свое название. Единственное сообщение, которое она не обрабатывает, это WM_DESTROY – сообщение о закрытии окна. Если его не обрабатывать, то окна видно не будет, но процесс так и останется. Не очень удобно.
Сообщения.
Все функционирование в Windows основано на сообщениях. Даже то, что вы передвигаете мышь. Точнее её перерисовка. А как их получает оконная процедура? Все начинается тут:
| Код |
while (GetMessage(&Msg, NULL, 0, 0))
{
TranslateMessage(&Msg);
DispatchMessage(&Msg);
}
|
А продолжается тут:
| Код |
LRESULT CALLBACK WndProc(HWND hwnd, UINT Message,
WPARAM wParam, LPARAM lParam)
{
switch (Message)
{
HANDLE_MSG(hwnd, WM_DESTROY, SimWnd_OnDestroy);
default:
return SimWnd_DefProc(hwnd, Message, wParam, lParam);
}
}
|
Функция GetMessage получает сообщение от системы и пересылает его оконной процедуре. Там программист обрабатывает его так, как хочет. Если он этого не делает или ему этого не нужно, то оно обрабатывается стандартной процедурой. Сообщений очень много и приводить их здесь нецелесообразно – займет пару страниц. Скажу только то, что когда я не знал, как называется сообщение, то открывал файл <WinUser.h> искал WM_NULL и смотрел далее сообщения, а по названию определял назначение, далее по справке и, в конце-концов, можно найти.
Рассмотрим параметры в функции WndProc:
1) Дескриптор окна, к которому относится сообщение.
2) Само сообщение.
3) Параметр сообщения.
4) Параметр сообщения.
Зачем два одинаковых параметра? Во-первых, не совсем одинаковые, а во-вторых смотрим: один параметр – 32 бита и второй 32. Очень многое можно указать в 64 битах, да еще 4 с лишним миллиарда возможных сообщений. Перейдем к практическим занятиям.
Делаем кнопки!
Код 2.1+SimWnd.cpp+------------------------------------------------
| Код |
#include <windows.h>
#include <windowsx.h>
#define SimWnd_DefProc DefWindowProc
LRESULT CALLBACK WndProc(HWND hwnd, UINT Message, WPARAM wParam, LPARAM lParam);
BOOL Register(HINSTANCE hInstance);
HWND Create(HINSTANCE hInstance, int nCmdShow);
static char szAppName[] = "SimWnd";
static HWND hMainWindow;
void SimWnd_OnDestroy(HWND hwnd);
BOOL SimWnd_OnCreate(HWND hwnd, CREATESTRUCT* pCreateStruct);
void SimWnd_OnCommand(HWND hwnd, int id, HWND hwndCtl, UINT codeNotify);
#define BT_FIRSTBUTTON 10001
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
LPSTR lpszCmdParam, int nCmdShow)
{
MSG Msg;
if (!Register(hInstance))
return FALSE;
if (!Create(hInstance, nCmdShow))
return FALSE;
while (GetMessage(&Msg, NULL, 0, 0))
{
TranslateMessage(&Msg);
DispatchMessage(&Msg);
}
return Msg.wParam;
}
BOOL Register(HINSTANCE hInstance)
{
WNDCLASS WndClass;
WndClass.style = CS_HREDRAW | CS_VREDRAW;
WndClass.lpfnWndProc = WndProc;
WndClass.cbClsExtra = 0;
WndClass.cbWndExtra = 0;
WndClass.hInstance = hInstance;
WndClass.hIcon = LoadIcon(NULL, IDI_APPLICATION);
WndClass.hCursor = LoadCursor(NULL, IDC_ARROW);
WndClass.hbrBackground = (HBRUSH)(COLOR_BTNFACE+1);
WndClass.lpszMenuName = NULL;
WndClass.lpszClassName = szAppName;
return (RegisterClass(&WndClass) != 0);
}
HWND Create(HINSTANCE hInstance, int nCmdShow)
{
HWND hwnd = CreateWindow(szAppName, szAppName,
WS_OVERLAPPEDWINDOW,
CW_USEDEFAULT, CW_USEDEFAULT,
CW_USEDEFAULT, CW_USEDEFAULT,
NULL, NULL, hInstance, NULL);
if (hwnd == NULL)
return FALSE;
ShowWindow(hwnd, nCmdShow);
UpdateWindow(hwnd);
return hwnd;
}
LRESULT CALLBACK WndProc(HWND hwnd, UINT Message,
WPARAM wParam, LPARAM lParam)
{
switch (Message)
{
HANDLE_MSG(hwnd, WM_DESTROY, SimWnd_OnDestroy);
HANDLE_MSG(hwnd, WM_CREATE, SimWnd_OnCreate);
HANDLE_MSG(hwnd, WM_COMMAND, SimWnd_OnCommand);
default:
return SimWnd_DefProc(hwnd, Message, wParam, lParam);
}
}
void SimWnd_OnDestroy(HWND hwnd)
{
PostQuitMessage(0);
}
BOOL SimWnd_OnCreate(HWND hwnd, CREATESTRUCT* pCreateStruct)
{
CreateWindow("button", "Кнопка", WS_CHILD|WS_VISIBLE,
10, 10, 90, 25, hwnd,
HMENU(BT_FIRSTBUTTON),
pCreateStruct->hInstance, NULL);
return TRUE;
}
void SimWnd_OnCommand(HWND hwnd, int id, HWND hwndCtl, UINT codeNotify)
{
switch (id)
{
case BT_FIRSTBUTTON:
MessageBox(hwnd, "Ё-моё!", "Работает,", MB_OK|MB_ICONEXCLAMATION);
break;
}
}
|
Код 2.1+SimWnd.cpp+------------------------------------------------Конец
У Вас мог возникнуть вопрос, как узнать сигнатуру функций обработки сообщений. Просто. В файле <WindowsX.h> есть такой шаблон Cls_OnXXXXX. То есть, если нам нужен обработчик сообщения WM_COMMAND, то ищем Cls_OnCommand и смотрим сигнатуру.
Разбор полетов.
В этом коде мы использовали два новых сообщения: WM_CREATE и WM_COMMAND. Первое программист использует для задания «предпусковых» установок и создания динамических элементов управления. В нашем примере был употреблен второй случай – создание кнопки.
WM_COMMAND призвано реагировать на команды программе, в основном, от элементов управления. Например, на нажатие кнопки.
Заметьте, что объем кода 2.1 не многим больше, чем в 2.0. Об этом я и говорил в начале, что основная часть кода копируется из приложения в приложение.
В обработчике OnCreate вызывается функция CreateWindow, вот ее параметры:
1) Символьное название класса.
2) Название элемента или текс в новом элементе.
3) Стиль окна. Их много…
4,5,6,7) Координаты x, y, dx, dy.
8) Дескриптор окна-родителя.
9) Дескриптор меню или идентификатор элемента.
10) Дескриптор модуля.
11) Указатель на значение, которое будет послано в структуре CREATESTRUCT.
В основном, этот обработчик используется для загрузки настроек, ресурсов, подключения динамических библиотек и т. п.
Обработчик OnCommand имеет менее разнообразное назначение (хотя, кто знает, что можно выдумать…). Этот обработчик получает четыре параметра – дескриптор главного окна, идентификатор элемента, дескриптор этого элемента и дополнительная информация. В последнем примере обрабатывается идентификатор кнопки, который задается 9-м параметром функции CreateWindow, в котором указывается целое число, преобразованное с помощью HMENU. А пример достаточно полно показывает «способ употребления» этого обработчика.
В файле тот же текст, но в формате "doc".
Остаюсь без компьютера (еду в инст). Статью писал наскоро, потому прошу модераторов редактировать недостатки, сообщаяя о них на ПМ.
|
так собственно сам вопрос как строку к этому страшному LPСWSTR приводить... перепробовал все известные мне способы 
, из знакомых никто не знает 
. 
это коносольный компиль, а это
