лекции / Shchupak_Yu._Win32_API_Razrabotka_prilozheniy_dlya_Windows

{

case WM_PAINT:

hDC = BeginPaint(hWnd, &ps);

GetClientRect(hWnd, &rect);

DrawText(hDC, "Hello, World!", -1, &rect,

DT_SINGLELINE | DT_CENTER | DT_VCENTER );

EndPaint(hWnd, &ps); break;

case WM_CLOSE: DestroyWindow(hWnd); break;

case WM_DESTROY: PostQuitMessage(0); break;

default:

return DefWindowProc(hWnd, uMsg, wParam, lParam);

}

return 0;

}

//////////////////////////////////////////////////////////////////////

Создайте проект с именем Hello1, добавьте к нему указанный файл. После ком пиляции и запуска на выполнение на экране должно появиться окно программы, показанное на рис. 1.4.

Рис. 1.4. Окно программы Hello1

А вот теперь придется запастись терпением. Пояснения к программе Hello1 зай мут примерно в восемь раз больше страниц, чем сам код программы.

Файл исходного текста программы

В файле Hello1.cpp расположены только две функции: WinMain и WndProc. WinMain — это точка входа в программу. WndProc — это оконная процедура для главного окна

LPCTSTR lpszMenuName; // указатель на строку, содержащую имя меню, //применяемого по умолчанию для этого класса

LPCTSTR lpszClassName; // указатель на строку, содержащую имя класса окна HICON hIconSm; // дескриптор малой пиктограммы

} WNDCLASSEX;

ПРИМЕЧАНИЕ

Следует упомянуть о некоторых аспектах использованных в этом определении типов данных, а также о венгерской нотации имен полей.

Префиксы LP и lp означают «длинный указатель» (long pointer), являющийся пережитком 16-разряд- ной Windows, в которой различались короткие 16-разрядные указатели и длинные 32-разрядные указатели. В Win 32 API все указатели имеют длину 32 разряда.

Префикс lpfn означает «длинный указатель на функцию» (long pointer to a function). Префикс cb означает «счетчик байтов» (counter of bytes). А префикс hbr — это «дескриптор кисти» (handle to a brush).

Рассмотрим назначение полей структуры WNDCLASSEX.

Значение первого поля, cbSize, должно быть равно длине структуры.

Второе поле, style, может содержать в своем значении один или несколько сти лей, перечисленных в табл. 1.41.

Таблица 1.4. Стили класса окна

Взаголовочных файлах Windows идентификаторы, начинающиеся с префик са CS_, задаются в виде 32 разрядной константы, в которой только один разряд установлен в единичное значение. Например, константа CS_VREDRAW задана как 0x0001, а CS_HREDRAW — как 0x0002. Подобные константы иногда называют пораз рядными флагами (bit flags). Они могут объединяться с помощью операции ИЛИ языка C++.

Врассматриваемой программе используется комбинация стилей CS_HREDRAW | CS_VREDRAW. Это означает, что все окна этого класса должны це ликом перерисовываться при изменении как горизонтального, так и вертикаль ного размеров окна. Если попробовать изменить размеры окна A Hello1 Application, то можно увидеть, что строка текста переместится в новый центр окна. Механизм уведомления оконной процедуры об изменении размеров окна будет рассмотрен позже.

Третье поле, lpfnWndProc, содержит адрес оконной процедуры (в нашей про грамме это — WndProc).

1 В таблице указаны наиболее употребительные стили. Полный список стилей см. в MSDN.

34 Глава 1. «Hello, World!», или Первые шаги к пониманию концепции Windows

Назначение полей 4—6 представляется очевидным1.

Седьмое поле, hIcon, содержит дескриптор пиктограммы, которая предназначе на для этого класса окна. Пиктограмма (синонимы: иконка, значок) — это малень кая битовая картинка, которая появляется на панели задач Windows и в левой ча сти заголовка окна. Значение hIcon обычно получают вызовом функции LoadIcon, которая имеет следующий прототип:

HICON LoadIcon(HINSTANCE hInstance, LPCTSTR lpIconName);

Эта функция загружает ресурс пиктограммы, заданный параметром lpIconName, из экземпляра приложения, указанного параметром hInstance2. Функцию можно использовать также для загрузки одной из системных (предопределенных) пик тограмм, если передать первому аргументу значение NULL. В этом случае второй аргумент должен содержать константу, идентификатор которой начинается с пре фикса IDI_ («идентификатор значка» — ID for icon). Возможные значения второ го аргумента для предопределенных пиктограмм приведены в табл. 1.5.

Таблица 1.5. Предопределенные идентификаторы пиктограмм

Поле hCursor содержит дескриптор курсора мыши, используемого приложени ем в клиентской области окна. Значение hCursor обычно получают с помощью вы зова функции LoadCursor, имеющей следующий прототип:

HCURSOR LoadCursor(HINSTANCE hInstance, LPCTSTR lpCursorName);

Эта функция загружает ресурс курсора, заданный вторым параметром (lpCursorName), из экземпляра приложения, заданного первым параметром (hInstance)3.

Функцию можно также использовать для загрузки одного из системных (пре допределенных) курсоров, если передать первому аргументу значение NULL. Зна чение второго аргумента при этом выбирается из табл. 1.6.

Таблица 1.6. Предопределенные идентификаторы курсора

1 Поля cbClsExtra и cbWndExtra используются крайне редко.

2 Вопросы создания и использования пользовательских пиктограмм рассматриваются в главе 5.

3 Вопросы создания и использования пользовательских курсоров рассматриваются в главе 5.

Девятое поле, hbrBackground, содержит дескриптор кисти, используемой при ложением для закраски фона в клиентской области окна. Кисть (brush) — это гра фический объект, который представляет собой шаблон пикселов различных цве тов, используемый для закрашивания области. В Windows имеется несколько стандартных или предопределенных кистей. Вызов функции GetStockObject с ар гументом WHITE_BRUSH возвращает дескриптор белой кисти. Так как возвращае мое значение имеет тип HGDIOBJ, то необходимо его преобразование к типу HBRUSH.

Десятое поле, lpszMenuName, указывает на строку, содержащую имя меню, при меняемого по умолчанию для данного класса. Рассматриваемая программа не имеет меню, поэтому поле установлено в NULL.

Поле lpszClassName указывает на строку, содержащую имя класса. Это имя долж но использоваться в параметре lpClassName функции CreateWindow.

Двенадцатое поле, hIconSm, содержит дескриптор малой пиктограммы, кото рая предназначена для использования в строке заголовка окон, созданных при помощи этого класса. Размеры пиктограммы должны быть 16 × 16 пикселов. Если поле равно NULL, то система ищет ресурс пиктограммы, указанный полем hIcon, чтобы сформировать малую пиктограмму из него.

Итак, с заполнением структуры класса окна мы разобрались. Осталось заре гистрировать подготовленный класс, вызвав функцию RegisterClassEx. Это расши ренная версия1 функции RegisterClass из предыдущих версий Windows. В то же время можно пользоваться и функцией RegisterClass, передавая ей адрес структу ры WNDCLASS (а не WNDCLASSEX).

Создание окна

Если регистрация класса окна прошла успешно, то следующий этап — создание окна. Для этого вызывается функция CreateWindow, прототип которой приведен ниже:

1 На это указывает окончание имени Ex, то есть extended — расширенный.

36 Глава 1. «Hello, World!», или Первые шаги к пониманию концепции Windows

);

Рассматривая назначение параметров, не будем забывать, что функция Create Window позволяет создавать не только основное окно приложения, но и любые другие окна, включая окна предопределенных классов, с помощью которых реа лизуются стандартные элементы управления Windows.

Первый параметр, lpClassName, — это указатель на строку, содержащую допус тимое имя класса окна. Таким именем может быть либо имя класса, зарегистриро ванного ранее при помощи функции RegisterClassEx или RegisterClass, либо имя од ного из предопределенных классов, перечисленных в табл. 1.7.

Таблица 1.7. Предопределенные классы окон

Второй параметр, lpWindowName, — это указатель на строку, содержащую имя окна. Место отображения имени зависит от вида окна. Например, для главного окна приложения оно выводится как заголовок окна (см. рис. 1.3), а для окна пре допределенного класса BUTTON размещается по центру кнопки.

1 В зависимости от версии Windows, установленной на компьютере.

38 Глава 1. «Hello, World!», или Первые шаги к пониманию концепции Windows

кнопками для сворачивания, разворачивания и закрытия окна справа на строке заголовка и «толстой» рамкой, позволяющей изменять размеры окна.

Четвертый параметр, x, задает горизонтальную позицию левого верхнего угла окна. Для главного окна позиции x и y определяются в экранных координатах, а для дочерних окон и элементов управления координаты отсчитываются относи тельно левого верхнего угла родительского окна.

Если позиция x не важна, то можно установить значение CW_USEDEFAULT. В этом случае Windows использует значения x и y по умолчанию. Это означает, что сис тема располагает следующие друг за другом перекрывающиеся окна, равномерно отступая по горизонтали и вертикали от левого верхнего угла экрана.

Пятый параметр, y, задает вертикальную позицию левого верхнего угла окна. Если параметр x имеет значение CW_USEDEFAULT, то значение параметра y игнорируется.

Шестой параметр, nWidth, задает ширину окна в пикселах. Если ему присвоено значение CW_USEDEFAULT, то система будет использовать значения nWidth и nHight по умолчанию.

Седьмой параметр, nHight, задает высоту окна в пикселах. Если параметр nWidth установлен в CW_USEDEFAULT, то значение nHight игнорируется.

Восьмой параметр, hWndParent, в рассматриваемой программе имеет значение NULL, поскольку у главного окна программы отсутствует родительское окно. За метим, что, если между двумя окнами существует связь типа родительское—до чернее, дочернее окно всегда появляется только на поверхности родительского.

Девятый параметр, hMenu, содержит дескриптор меню окна или идентификатор элемента управления. Интерпретация значения параметра зависит от вида окна.

Если приложение использует меню, определенное в классе окна (поле lpszMenuNameв структуре WNDCLASSEX), то параметру hMenuнеобходимо передать значение NULL.

Если создаваемое окно относится к элементу управления, то параметру hMenu передается целочисленное значение, которое далее используется как идентифи катор созданного элемента. Этот идентификатор, например, будет содержаться в сообщениях WM_COMMAND, поступающих от элемента управления.

Десятому параметру, hInstance, должен быть присвоен дескриптор экземпляра приложения, переданный программе в качестве аргумента функции WinMain.

Последний параметр, lParam, в рассматриваемом примере тоже имеет значение NULL. При необходимости он может быть использован в качестве указателя на не кие дополнительные данные, передаваемые окну в момент его создания с помо щью сообщения WM_CREATE.

Итак, функция CreateWindow вызвана. Отработав, она возвращает дескриптор созданного окна. Если по какой то причине создать окно не удалось, то функция возвращает значение NULL. Поэтому рекомендуется проверять возвращаемое функ цией значение и в случае неудачи выдавать соответствующее сообщение, исполь зуя уже знакомую функцию MessageBox.

Использование функции CreateWindowEx

Для создания окна вместо функции CreateWindow может быть вызвана функция CreateWindowEx, прототип которой приведен ниже:

HWND CreateWindowEx(DWORD dwExStyle, LPCTSTR lpClassName,

LPCTSTR lpWindowName, DWORD dwStyle, int x, int y, int nWidth,

int nHeight, HWND hWndParent, HMENU hMenu, HINSTANCE hInstance, LPVOID lParam);

Все параметры этой функции, кроме первого, имеют тот же смысл, что и у функ ции CreateWindow. Первый параметр, dwExStyle, задает расширенный стиль окна, применяемый совместно со стилем, определенным в параметре dwStyle. Напри мер, в качестве расширенного стиля можно задать один или несколько флагов, приведенных в табл. 1.9. Полный список расширенных стилей можно найти в MSDN.

Таблица 1.9. Расширенные стили окна

Функция CreateWindowEx так же, как и функция CreateWindow, может быть при менена для создания любых окон, в том числе и окон элементов управления Windows. Некоторые из расширенных стилей окна предназначены как раз для дочерних окон элементов управления1.

Отображение окна на экране

Для отображения на экране созданного окна вызывается функция ShowWindow, имеющая следующий прототип:

BOOL ShowWindow(HWND hWnd, int nCmdShow);

Первым параметром функции является дескриптор окна, а второй параметр определяет, в каком виде будет показано окно.

При начальном отображении главного окна рекомендуется присваивать вто рому параметру то значение, которое передается приложению через параметр nCmdShow функции WinMain.

При последующих отображениях можно использовать любое из значений, при веденных в табл. 1.102.

1Базовые элементы управления рассматриваются в главе 7, элементы управления общего пользова ния — в главе 8.

2 В таблице приведены наиболее употребляемые значения. Полный список значений см. в MSDN.

40 Глава 1. «Hello, World!», или Первые шаги к пониманию концепции Windows

Таблица 1.10. Значения параметра nCmdShow функции ShowWindow

ПРИМЕЧАНИЕ

Во всех книгах, посвященных программированию с Win32 API, а также в справочных материалах MSDN рекомендуется после вызова функции ShowWindow вызвать функцию UpdateWindow, которая посылает оконной процедуре сообщение WM_PAINT, заставляющее окно перерисовать свою клиентскую область. Однако эксперименты показали, что в этом нет никакой необходимости. Отладочная трассировка сообщений выявила, что результатом работы функции ShowWindow является генерация сообщений WM_SIZE и WM_MOVE, а обрабатывая сообщение WM_SIZE, система всегда генерирует сообщение WM_PAINT. Поэтому вызов функции UpdateWindow в примере закомментирован.

Обработка сообщений

После вывода окна на экран программа должна подготовить себя для получения информации от пользователя. Эта информация обычно вводится с помощью кла виатуры или мыши. Windows поддерживает «очередь сообщений» (message queue) для каждой программы, работающей в системе. Любое действие пользователя система Windows преобразует в «сообщение», которое помещается в указанную очередь.

Программа извлекает сообщения из очереди, выполняя блок команд, извест ный как «цикл обработки сообщений» (message loop):

while (GetMessage(&msg, NULL, 0, 0)) { TranslateMessage(&msg); DispatchMessage(&msg);

}

return msg.wParam;

В этом фрагменте кода переменная msg — это структура типа MSG, которая оп ределена в заголовочных файлах Windows следующим образом:

typedef struct tagMSG {

Интерпретация параметров wParam и lParam зависит от номера сообщения. Тип данных POINT используется для представления точки парой ее координат: