лекции / Shchupak_Yu._Win32_API_Razrabotka_prilozheniy_dlya_Windows

Третьему параметру функции CreatePen передается цвет пера в виде значения типа COLORREF. Обычно это значение задается либо с помощью макроса RGB, либо с помощью макроса PALETTERGB1. Первый вариант используется, если устройство вывода поддерживает полный диапазон цветов, определяемый 24 битным RGB значением, и следовательно, приложению нет необходимости работать с палит рой. Второй вариант (макрос PALETTERGB) необходимо использовать, если прило жение работает с логической палитрой, например, для моделей дисплеев, которые поддерживают только 256 цветов. В последнем случае система Windows преобра зует запрошенный RGB цвет в наиболее подходящий индекс палитры.

Характеристика пера, названная в таблице «выравниванием», проявляется наиболее существенно, когда линия используется для обводки замкнутых фи гур или для рисования дуг, являющихся частью эллипса. Для всех стилей, кро ме PS_INSIDEFRAME, линия центрируется таким образом, что часть линии оказы вается за пределами ограничивающего контура. Для стиля PS_INSIDEFRAME вся линия рисуется внутри ограничивающего контура. Эту разницу можно заметить, только если параметр nWidth имеет значение большее, чем единица. Например, рисование дуг на рис. 2.5 и 2.6 выполнено пером со стилем PS_INSIDEFRAME. Если же параметр nWidth имеет единичное значение, то стиль PS_INSIDEFRAME совпа дает со стилем PS_SOLID.

Приведем пример использования функции CreatePen. Следующий вызов со здает простое сплошное (однородное) перо красного цвета толщиной 5 логичес ких единиц:

hPen = CreatePen(PS_SOLID, 5, RGB(255, 0, 0));

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

Второй способ создания простых перьев связан с вызовом функции CreatePenIndirect:

HPEN CreatePenIndirect(CONST LOGPEN* lplgpn);

Этой функции в качестве параметра передается адрес структуры типа LOGPEN:

typedef struct tagLOGPEN {

Член структуры width имеет тип POINT, но Windows использует только величи ну width.x как толщину пера и игнорирует значение width.y.

Таким образом, сначала определяется переменная типа LOGPEN, например:

LOGPEN logpen;

Затем полям этой переменной присваиваются нужные значения, например:

logpen.style = PS_SOLID; logpen.width.x = 10; logpen.color = RGB(255, 0, 0);

И только после этого вызывается функция CreatePenIndirect:

hPen = CreatePenIndirect(&logpen);

1 См. раздел «Управление цветом. Вывод пиксела».

Простые перья, созданные с помощью функции CreatePenIndirect, обладают точ но такими же характеристиками, что и перья, созданные функцией CreatePen.

Обратите внимание на то, что функции CreatePen и CreatePenIndirect не требуют дескриптора контекста устройства. Они создают логические перья, которые никак не связаны с контекстом устройства, пока не будет вызвана функция SelectObject.

Покажем возможный сценарий использования нескольких перьев в программе. Допустим, приложению требуются три нестандартных пера: красное толщиной 2, зеленое толщиной 5 и синее пунктирное. Сначала нужно определить переменные для хранения дескрипторов этих перьев:

static HPEN hPen1, hPen2, hPen3;

Сами перья могут быть созданы в процессе обработки сообщения WM_CREATE:

hPen1 = CreatePen(PS_SOLID, 2, RGB(255, 0, 0));

hPen2 = CreatePen(PS_SOLID, 5, RGB(0, 255, 0)); hPen3 = CreatePen(PS_DASH, 1, RGB(0, 0, 255));

В процессе обработки сообщения WM_PAINT можно выбрать одно из этих перь ев в контекст устройства и рисовать с его помощью:

SelectObject(hDC, hPen1);

//... функции рисования линий SelectObject(hDC, hPen2);

//... функции рисования линий

Впроцессе обработки сообщения WM_DESTROY рекомендуется удалить эти перья:

DeleteObject(hPen1);

DeleteObject(hPen2);

DeleteObject(hPen3);

Это наиболее общий подход. Но возможны и другие сценарии. Например, мож но создать перо в блоке обработки сообщения WM_PAINT и удалить его перед вызо вом функции EndPaint или даже после ее вызова.

Кроме того, можно создавать перья «на лету», объединяя вызовы функций

CreatePen и SelectObject в одну инструкцию:

SelectObject(hDC, CreatePen(PS_DOT, 0, RGB(255, 255, 0)));

Теперь последующее рисование линий будет выполняться желтым пером с то чечным стилем. Закончив рисовать, нужно удалить выбранное перо. Но как это сделать, если его дескриптор не сохранен? В этом случае на выручку приходит функция SelectObject с ее свойством возвращать дескриптор объекта, выбранного в контекст устройства ранее. Таким образом, можно удалить перо при помощи выбора стандартного пера BLACK_PEN в контекст устройства и удаления значения, возвращенного функцией SelectObject:

DeleteObject(SelectObject(hDC, GetStockObject(BLACK_PEN)));

Рассмотрим слегка модифицированную версию последнего примера. Дело в том, что можно сохранить дескриптор пера при первом вызове SelectObject:

hPen = SelectObject(hDC, CreatePen(PS_DOT, 0, RGB(255, 255, 0)));

Если это первый вызов SelectObject после получения дескриптора контекста устройства, то hPen примет значение дескриптора стандартного пера BLACK_PEN. Тогда после окончания рисования выбранным пером его удаление можно совмес тить с возвратом в контекст устройства стандартного пера:

DeleteObject(SelectObject(hDC, hPen));

из табл. 2.8. На рис. 2.10 показано, как выглядит буква Z, состоящая из трех утолщенных линий с разными завершениями. Линии нарисованы при помощи фун кции LineTo. Для большей четкости картины в местах стыковки вторая линия нарисо вана более светлым пером, чем первая и третья линии. Тонкие белые линии, нанесен ные поверх фигуры, обозначают положение базовых осей каждой линии.

Рис. 2.9. Простые и расширенные геометрические перья толщиной 10 пикселов

Рис. 2.10. Стыковка линий с разными завершениями

Учтите, что если вы будете рисовать при помощи функции LineTo все три ли нии пером одного и того же цвета в режиме рисования R2_XORPEN, то на стыках из за повторной прорисовки образуются «провалы», как показано на рис. 2.11, слева. Та же Z образная фигура, нарисованная функцией Polyline (на рис. 2.11 в центре и справа), таких провалов не имеет. При этом фигура справа демонстрирует воз можность заливки линий с помощью кисти. В данном случае перед созданием гео метрического пера поле lbStyle структуры LOGBRUSH было установлено в значение

BS_HATCHED, а поле lbHatch — в значение HS_DIAGCROSS1.

Рис. 2.11. Рисование геометрическим пером в режиме рисования R2_XORPEN

Функция Polyline относится к группе функций GDI, позволяющих выполнить рисование нескольких линий и кривых за один вызов. Функции этой группы обла дают тем замечательным свойством, что обеспечивают плавную стыковку линий. Именно для них имеет значение тип соединения геометрического пера, устанавли ваемый флагом из табл. 2.9. По умолчанию в контексте устройства используется флаг PS_JOIN_ROUND. На рис. 2.12 показаны различные типы соединений в сочета нии с разными типами завершения геометрического пера. Рисование производи лось при помощи функции Polyline.

1 Работа с объектом логической кисти рассматривается далее в разделе «Кисти».

Для дескрипторов логических кистей зарезервирован тип HBRUSH (handle to a brush), поэтому новая кисть объявляется следующим образом:

HBRUSH hBrush;

Значение дескриптора получают вызовом соответствующей функции. Вид вы зываемой функции зависит от типа кисти. Так же как и при работе с перьями, созданные кисти выбираются в контекст устройства с помощью функции SelectObject, после чего заливка всех замкнутых фигур осуществляется выбранной кистью. Ког да кисть перестает быть нужной, рекомендуется вернуть в контекст устройства прежнюю кисть, а ненужную кисть удалить при помощи функции DeleteObject. В разделе «Простые перья» были приведены возможные сценарии использова ния нескольких перьев в одном приложении. Аналогичные сценарии можно ис пользовать и для работы приложения с несколькими кистями.

Стандартные кисти

Стандартные кисти, предоставляемые GDI, приведены в табл. 2.10.

Таблица 2.10. Стандартные кисти

Все кисти, приведенные в таблице, — сплошные, то есть все 8 × 8 пикселов растра имеют один и тот же цвет. Кисть DC, реализованная только в Windows 2000, относится к числу новых средств GDI. Так же как и перо DC, кисть DC позволяет изменять свой цвет после ее выбора в контекст устройства. Для этого предназна чена функция SetDCBrushColor.

Чтобы получить дескриптор стандартной кисти, достаточно вызвать функцию GetStockObject с одной из констант, приведенных в табл. 2.10, например:

hBrush = (HBRUSH) GetStockObject(GRAY_BRUSH);

Пользовательские кисти

Стандартные кисти хороши простотой своего использования, но их возможности явно недостаточны для нужд многих приложений. Поэтому Windows содержит функции, создающие пользовательские кисти следующих типов: сплошные кисти,

штриховые кисти и растровые кисти.

Сплошные кисти

Сплошная кисть создается вызовом функции CreateSolidBrush:

HBRUSH CreateSolidBrush(COLORREF crColor);

Ее единственному параметру crColor передается цвет кисти в виде значения типа COLORREF. Обычно это значение задается при помощи макроса RGB или PALETTERGB1. Первый вариант используется, если устройство вывода поддерживает полный диапазон цветов, определяемый 24 битным RGB значением. В этом случае при ложению нет необходимости работать с палитрой. Второй вариант необходимо использовать, если приложение работает с логической палитрой. В последнем случае Windows преобразует запрошенный в макросе PALETTERGB цвет в наиболее подходящий индекс палитры. Если подходящий индекс не найден, то устройство имитирует нужный цвет, комбинируя доступные цвета при помощи смешения (dithering).

Примеры использования сплошной кисти можно найти в листингах глав 3 и 6.

Штриховые кисти

Штриховая кисть создается вызовом функции CreateHatchBrush:

HBRUSH CreateHatchBrush(int fnStyle, COLORREF clrref);

Параметр fnStyle, задающий стиль штриховки, может принимать значения

HS_HORIZONTAL, HS_VERTICAL, HS_BDIAGONAL, HS_FDIAGONAL, HS_CROSS и HS_DIAGCROSS. На рис. 2.13 показано, как выглядят эти стили при заливке прямоугольников размером 64 × 64 пиксела (верхний ряд). В нижней части рисунка приведены в увеличенном виде минимальные блоки, соответствующие этим штриховым ки стям. Каждый минимальный блок представляет собой растр размером 8 × 8 пик

селов.

Рис. 2.13. Стили штриховых кистей

В штриховых кистях пикселы делятся на основные и фоновые. На рис. 2.13 ос новные пикселы показаны более темным цветом. Цвет основных пикселов зада ется параметром clrref, а цвет фоновых пикселов определяется атрибутом цвета фона графических элементов в контексте устройства, который можно устанавли вать при помощи функции SetBkColor. Фоновые пикселы выводятся только в том случае, если установлен режим смешивания фона OPAQUE.

GDI позволяет также устанавливать базовую точку штриховой кисти с помо щью функции SetBrushOrgEx:

BOOL SetBrushOrgEx(HDC hdc, int nXOrg, int nYOrg, LPPOINT lppt);

Базовая точка (nXOrg, nYOrg), задаваемая в системе координат устройства, оп ределяет привязку левого верхнего пиксела штрихового узора. Остальные блоки пикселов выстраиваются соответствующим образом. Параметр lppt содержит ад рес структуры типа POINT, в которой запоминается прежняя базовая точка. По умолчанию координаты базовой точки кисти равны (0, 0).

1 См. раздел «Управление цветом. Вывод пиксела».

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

Чтобы программа смогла загрузить файл Star.bmp, нужно поместить его в пап ку с проектом Hello2. После компиляции и запуска на выполнение программа долж на нарисовать прямоугольник, показанный на рис. 2.15.

Рис. 2.15. Заливка прямоугольника растровой кистью

В системах Windows 95/98 накладывается ограничение на применение рас тровых кистей. Битовые образы кистей не могут превышать размер 8 × 8 пиксе лов. В случае превышения размера используется квадрат 8 × 8 из левого верхнего угла изображения.

Пример использования растровой кисти приведен в главе 11.

Структура LOGBRUSH и функция CreateBrushIndirect

Win32 GDI предоставляет еще одну функцию — CreateBrushIndirect, позволяющую создать логическую кисть любого из трех рассмотренных выше типов:

HBRUSH CreateBrushIndirect(CONST LOGBRUSH* lplb);

Параметр lplb — это адрес структуры типа LOGBRUSH, в которой задаются пара метры кисти:

typedef struct tagLOGBRUSH { UINT lbStyle; COLORREF lbColor;

LONG lbHatch; } LOGBRUSH;

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

Таблица 2.11. Возможные значения поля lbStyle

1 Функции, рисующие замкнутые фигуры, рассматриваются в следующем разделе.