LPPOINT - указатель на массив координат, соединяемых граничных точек;
Третий параметр - число соединяемых точек.
Функция PolyPolygon позволяет нарисовать за один вызов несколько многоугольников и определена так:
BOOL FAR PASCAL PolyPolygon(HDC, LPPOINT, LPINT, int);
HDC - логический номер контекста устройства;
LPPOINT - указатель на массив координат, соединяемых граничных точек всех создаваемых многоугольников;
LPINT - указатель на массив типа int. Элементы массива задают число точек в каждом многоугольнике*
Последний параметр задает количество точек в массиве LPINT, то есть количество многоугольников.
Для рисования закрашенного эллипса используется функция Ellipse. Онаопределяетсятак:
BOOL FAR PASCAL Ellipse(HDC, int, int, int, int);
HDC - логический номер контекста устройства;
Остальные параметры определяют координаты
ограничивающего прямоугольника.
Функция Chord используется для рисования частичной дуги, концы которой соединены сегментом линии. Для этого также используется ограничивающий прямоугольник. Определение функции следующее:
BOOL FAR PASCAL Chord(HDC,
int, int,
int, int,
int, int,
int, int);
HDC - логический номер контекста устройства;
Следующие четыре параметры определяют координаты
ограничивающего прямоугольника.
Далее указываются координаты начальной и конечной точки сегмента линии.
Функция Pie аналогична функции Chord, только рисует не хорду, а сектор эллипса. Она определена следующим образом:
BOOL FAR PASCAL Pie(HDC,
int, int,
int, int,
int, int,
int, int);
HDC - логический номер контекста устройства;
Следующие четыре параметры определяют координаты
ограничивающего прямоугольника.
Далее указываются координаты начальной и конечной точки сектора.
Для рисования прямоугольника используется функция
Rectangle.Ее прототип:
BOOL FAR PASCAL Rectangle(HDC, int, int, int, int);
HDC - логический номер контекста устройства;
Остальные параметры определяют координаты
прямоугольника.
Если требуется нарисовать прямоугольник с закругленными краями, то имеется функция RoundRect. Онаопределената:
BOOL FAR PASCAL RoundRect(HDC,
int, int,
int, int,
int, int);
HDC - логический номер контекста устройства;
Следующие четыре параметры определяют координаты
прямоугольника.
Последние два параметра задают ширину и высоту ограничивающего прямоугольника для эллипса, используемого при скруглении угла.
Вывод текста
Для вывода текста имеется пять основных функций.
Функция TextOut предназначена для вывода одной строки. Она определена следующим образом:
BOOL FAR PASCAL TextOut(HDC, int, int, LPSTR, int);
HDC - логический номер контекста устройства;
Следующие два параметры определяют координаты точки привязки выводимой стоки текста.
LPSTR - указатель на выводимую символьную строку.
Последний параметр - число символов в строке текста.
Более мощный вариант функции TextOut представляет собой функция ExtTextOut. Она позволяет управлять интервалом между строками и вырезкой
BOOL FAR PASCAL ExtTextOut( HDC,
int, int,
WORD wOptions,
LPRECT lpRect,
LPSTR lpString,
WORD nCount,
LPINT lpDx );
HDC - логический номер контекста устройства;
Следующие два параметры определяют координаты точки привязки выводимой стоки текста.
wOptions - флаг, принимающий значение 0, ETO_CLIPPED, ETO_OPAQUE и ETO_CLIPPED|ETO_OPAQUE, позволяющий устанавливать прямоугольные области вырезки и при выводе текста затирать фон.
lpRect - указатель на структуру прямоугольника;
lpString - указатель на выводимую символьную строку.
nCount - число символов в строке текста. lpDx -
указатель на массив значений интервалов между
символами.
Функция TabbedTextOut при выводе текста распространяет знаки табуляции до позиций табуляции. Это обеспечивает удобный способ выравнивания столбцов данных. Прототип функции:
LONG FAR PASCAL TabbedTextOut(HDC,
int, int,
LPSTR, int, LPINT, int);
HDC - логический номер контекста устройства;
Следующие два параметры определяют координаты точки привязки выводимой стоки текста.
LPSTR - указатель на выводимую символьную строку.
Следующий параметр - число символов в строке текста.
LPINT - указатель на массив позиций табуляции;
Последний параметр - число элементов массиве позиций табуляции.
Функция DrawText обеспечивает некоторую возможность форматирования и переход в автоматическом режиме на новую строчку при большом количестве строк текста. Еепрототип:
int FAR PASCAL DrawText(HDC, LPSTR, int, LPRECT, WORD);
HDC - логический номер контекста устройства;
LPSTR - указатель на выводимую символьную строку.
Следующий параметр - число символов в строке текста. LPRECT - указатель на структуру прямоугольника,
определяющего позицию вывода и границы для форматирования. Последний параметр определяет режим форматирования.
Для отображения заблокированных пунктов меню и
заблокированных элементов управления блоками диалога Менеджер
Окон использует функцию GrayString.
ЭЛЕМЕНТЫ ОКОННОГО ИНТЕРФЕЙСА
Окна Windows
Главное окно приложения
Каждое приложение располагается в своем собственном окне и имеет по крайней мере хотя бы одно окно - главное окно приложения. Из приложения Windows непосредственно нельзя осуществить вывод на экран, так как экран является разделяемым ресурсом, а средством его разделения являются окна. Таким образом, прежде чем отобразить что-либо на экране, нужно создать окно, и только в окне можно осуществить вывод.
Функция главного окна приложения выполняет в программе ту же роль, что функция main() программы на Си для MS-DOS. При создании окна функция библиотеки SDK выполняет специальные действия начальной подготовки в DOS, не явно осуществляемых функцией main(). Поэтому приложение не содержит функции main(), роль которой выполняет функция WinMain(), получающая управление в начальный момент загрузки приложения. Функция WinMain() выполняет следующие основные действия:
- регистрация класса окна приложения и другие
инициализации;
- создание основного окна приложения и, возможно, других, подчиненных окон;
- запуск цикла обработки сообщений, помещаемых в очередь приложения;
- завершение работы приложения при извлечении из очереди сообщения WM_QUIT.
Прототип функции WinMain выглядит так:
int PASCAL WinMain
(
HANDLE instance, // дескрипторпредыдущейкопии
HANDLE prevInstance, // предыдущаякопия
LPSTR cmdLine, // указательнакоманднуюстроку
int cmdShow // флаг "окно открыто/закрыто"
);
instance - однозначно определяет каждую копию
приложения, если приложение запущено несколько раз.
prevInstance - определяет копию данного приложения, которая была последней активной копией. Если этот параметр равен 0, то других копий приложения, исполняемых в данный момент не существует.
cmdLine - дальний указатель на командную строку, оканчивающуюся нулем. Он позволяет приложениям получать данные через командную строку.
cmdShow - определяет, как приложение первоначально отображать на экране: пиктограммы (cmdShow = SW_SHOWMINNOACTIVE) или в виде открытого окна (cmdShow = SW_SHOWNORMAL). Константы SW_SHOWMINNOACTIVE и SW_SHOWNORMAL определены во включаемом файле windows.h.
Регистрация класса окна
Любое окно принадлежит к одному из существующих классов. Класс окна должен быть создан до того, как окно будет отображено на экране. Класс окна определяет общие свойства всех окон данного класса, например: форму курсора при перемещении его в области окна или имя меню, определенного для окон этого класса.
Характеристики окна задаются при регистрации класса окна (в структуре класса окна) и при создании окна. Наиболее общие характеристики окон задаются при регистрации класса окна. Окна, создаваемые при помощи функции CreateWindiw, должны иметь зарегистрированный ранее класс окон.
Есть несколько стандартных классов окон с заранее определенными свойствами. Однако, как правило, каждое приложение регистрирует свой собственный класс с тем, чтобы можно было управлять всеми свойствами окна приложения.
Для того, чтобы зарегистрировать класс окон, следует правильно заполнить структуру типа WNDCLASS и передать эту структуру в виде параметра функции RegisterClass. Структура класса окна имеет вид:
typedef struct tagWNDCLASS
WORD style; // тип окна
LONG (FAR PASCAL *lpfnWndProc)(); // функция окна int cbClsExtra; // размер доп. памяти
int cbWndExtra; // размер доп. памяти
HANDLE hInstance; // индекс копии приложения
HICON hIcon; // индекс пиктограммы
HCURSOR hCursor; // индекс курсора
HBRUSH hbrBackground; // цвет фона окна
LPSTR lpszMenuName; // имя меню
LPSTR lpszClassName; // имя класса окна
WNDCLASS;
lpszClassName - указатель на строку, содержащую имя класса. Поскольку определенный в приложении класс доступен всем приложениям, имя класса не должно повторятся в разных приложениях.
hInstance - манипулятор копии, создающей класс окна; должно содержать индекс копии приложения.
lpfnWndProc - указатель на функцию поддержки окна. Краткое описание этой функции смотри в следующем разделе.
style - содержит набор флагов, определяющих свойства окна. По умолчанию присваивается NULL.
hBrBackground - определяет цвет фона окна.
hCursor - определяет курсор, используемый в данном окне по умолчанию.
hIcon - определяет пиктограмму (icon), которая будет отображаться при переводе окна в неактивное состояние.
lpszMenuName - указатель на имя меню окна, определенное в файле ресурсов.
cbClsExtra - определяет число байт, которое необходимо дополнительно запросить у Windows под эту структуру. Этот обьем памяти будет зарезервирован в конце структуры для всех окон данного класса.
clWndExtra - определяет число байт, которое необходимо дополнительно запросить у Windows для размещения всех структур, создаваемых совместно с данным классом.
После определения полей структуры WNDCLASS необходимо зарегистрировать класс при помощи функции RegisterClass.
BOOL FAR PASCAL RegisterClass( LPWNDCLASS winClass );
Если регистрация класса прошла успешно, то возвращаемое значение TRUE, в противном случае - FALSE.
При регистрации класса окна Windows копирует структуру, описывающую класс окна, в системную область, чтобы другим копиям приложения уже не надо было ее регистрировать.
Функция окна приложения
Функция окна приложения занимается тем, что обрабатывает все сообщения для окон данного класса. Это функция всегда