Компоненты библиотеки Win32 API

Библиотека Win32 API содержит более двух тысяч функций, которые позволяют организовать взаимодействие ОС Windows и приложения [16–18]. Кроме того, библиотека включает в себя большое количество типов данных, многие из которых представляют собой переопределение стандартных типов данных языков C и C++, например, тип DWORD означает беззнаковое целое 32-битное число, или синоним типа unsigned long. Кроме простых типов, в библиотеку включены несколько типов структур, например, структура сообщения MSG. Поскольку программы в Windows управляются сообщениями, в библиотеку включены идентификаторы сообщений. Библиотека подключается с помощью заголовочного файла windows.h.

Венгерская нотация

Нотация – это форма записи идентификаторов. Венгерская нотация предложена программистом фирмы Microsoft, одним из разработчиков ОС Windows Карлом Симони. Традиционно используется для Windows-программ, в том числе для обозначений идентификаторов в библиотеке Win32 API. Венгерская нотация позволяет сделать программу более понятной и уменьшить объем комментариев за счет применения «говорящих» идентификаторов. Чтобы применить венгерскую нотацию, надо при задании идентификаторов использовать несколько несложных правил.

Правило 1. Идентификаторы следует начинать с префикса, который обозначает тип переменной и/или ее назначение. Префикс записывается с помощью строчных символов:

Правило 2. Идентификатор может быть составлен из нескольких слов, при этом каждое слово начинается с прописной буквы, остальные буквы – строчные:

lpszMenuName длинный указатель на ASCIIZ-строку, содержащую имя меню,

lpfnWndProc длинный указатель на функцию WndProc() – оконную процедуру (Window Procedure).

Правило 3. Типы переменных (структур, классов и др.) записываются прописными буквами, а имена переменных, объектов – строчными:

MSG msg; //объявление структурной переменной,

HWND hwnd; //объявление дескриптора.

Примеры типов данных, определенных в Win32 API

Windows запрещает приложениям прямой доступ к своим объектам – окнам, меню, устройствам. Получить доступ к таким объектам приложение может с помощью специальных указателей на объекты, называемых дескрипторами. Существует еще одно название дескриптора – хэндл, от английского слова handle, которое можно перевести как средство управления, манипулирования. Дескриптор – это переменная, которая хранит некоторое числовое значение, ассоциированное с конкретным объектом. Ее значение не может быть получено или изменено пользователем, но оно известно операционной системе и может быть передано функциям Win32 API для доступа к соответствующему объекту.

Тип дескриптора записывается в соответствии с правилами венгерской нотации прописными буквами, начинается с префикса H и включает в себя имя объекта (табл. 20.1).

Структуры в Win32 API используются для описания основных объектов в Windows: окон, сообщений, графических объектов (табл. 20.2).

Таблица 20.1

Таблица 20.2

Эти структуры объявлены в Win32 API следующим образом:

Структура POINT

typedef struct tagPOINT

{

LONG x;

LONG y;

} POINT;

Структура RECT

typedef tagRECT

{

LONG left; //x – координата левого верхнего угла

LONG top; //y – координата левого верхнего угла

LONG right; //x – координата правого нижнего угла

LONG bottom; //y – координата правого нижнего угла

} RECT;

Структура BITMAP

typedef struct tagBITMAP

{

LONG bmType; //всегда 0

LONG bmWidth; //ширина рисунка в пикселях

LONG bmHeight; //высота рисунка в пикселях

LONG bmWidthBytes; //число байтов в строке

//развертки

WORD bmPlanes; //количество цветовых плоскостей

WORD bmBitsPixel; //число битов на пиксель

LPVOID bmBits; //байтовый массив изображения

} BITMAP;

Структура PAINTSTRUCT

typedef struct tagPAINTSTRUCT

{

HDC hdc; //дескриптор контекста устройства

BOOL fErase; //TRUE – фон должен быть стерт

RECT rcPaint; //координаты закрашиваемой области

BOOL fRestore; //для внутреннего использования

BOOL fIncUpdate; //для внутреннего использования

BYTE rgbReserved[32]; //зарезервировано

} PAINTSTRUCT;

Структура MSG

typedef struct tagMSG

{

HWND hwnd; //дескриптор окна адресата

UINT msg; //идентификатор (номер) сообщения

WPARAM wParam; //первый параметр сообщения

LPARAM lParam; //второй параметр сообщения

DWORD time; //время регистрации сообщения

POINT pt; //координаты курсора при регистрации

//сообщения

} MSG;

Сообщения – это информация о каком-либо происшествии в системе. Сообщение направляется приложению или окну приложения, которое в ответ должно выполнить некоторые действия. В программе сообщение представлено структурой типа MSG. Информация, помещаемая в структуру, зависит от типа сообщения. Тип сообщения зависит от источника сообщения и задается с помощью идентификатора (номера) сообщения (табл. 20.3).

Таблица 20.3

Таблица 20.4