Функция ExtCreatePen (wingdi.h)

Функция ExtCreatePen создает логическое косметическое или геометрическое перо с указанными атрибутами стиля, ширины и кисти.

Синтаксис

HPEN ExtCreatePen(
  [in] DWORD          iPenStyle,
  [in] DWORD          cWidth,
  [in] const LOGBRUSH *plbrush,
  [in] DWORD          cStyle,
  [in] const DWORD    *pstyle
);

Параметры

[in] iPenStyle

Сочетание атрибутов type, style, end cap и join. Значения из каждой категории объединяются с помощью побитового оператора OR ( | ).

Тип пера может иметь одно из следующих значений.

Стиль пера может иметь одно из следующих значений.

Конец задается только для геометрических перьев. Конечное ограничение может иметь одно из следующих значений.

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

[in] cWidth

Ширина пера. Если параметр dwPenStyle имеет PS_GEOMETRIC, ширина задается в логических единицах. Если параметр dwPenStyle имеет PS_COSMETIC, ширина должна быть равна 1.

[in] plbrush

Указатель на структуру LOGBRUSH . Если параметр dwPenStyle PS_COSMETIC, элемент lbColor задает цвет пера, а для элемента lpStyle необходимо задать значение BS_SOLID. Если параметр dwPenStyle является PS_GEOMETRIC, необходимо использовать все элементы для указания атрибутов кисти пера.

[in] cStyle

Длина массива lpStyle в единицах DWORD. Это значение должно быть равно нулю, если параметр dwPenStyle не является PS_USERSTYLE.

Количество стилей ограничено 16.

[in] pstyle

Указатель на массив. Первое значение указывает длину первого дефиса в пользовательском стиле, второе — длину первого пробела и т. д. Этот указатель должен иметь значение NULL , если dwPenStyle не является PS_USERSTYLE.

Если массив lpStyle превышен во время рисования линий, указатель сбрасывается в начало массива. Если это происходит и dwStyleCount является четным числом, шаблон дефисов и пробелов повторяется. Однако если dwStyleCount является нечетным, то при сбросе указателя шаблон будет меняться— первый элемент lpStyle теперь ссылается на пробелы, второй — на дефисы и т. д.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение представляет собой дескриптор, идентифицирующий логическое перо.

Если функция выполняется неудачно, возвращается нулевое значение.

Комментарии

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

Ширина геометрического пера всегда указывается в единицах мира. Ширина косметической ручки всегда равна 1.

Конечные крышки и соединения указываются только для геометрических перьев.

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

Если параметр dwPenStyle имеет значение PS_COSMETIC и PS_USERSTYLE, записи в массиве lpStyle указывают длину дефисов и пробелов в единицах стиля. Единица стиля определяется устройством, где перо используется для рисования линии.

Если параметр dwPenStyle PS_GEOMETRIC и PS_USERSTYLE, записи в массиве lpStyle указывают длину дефисов и пробелов в логических единицах.

Если параметр dwPenStyle PS_ALTERNATE, единица стиля игнорируется, а все остальные пиксели задаются.

Если элемент lbStyle структуры LOGBRUSH , на который указывает lplb , BS_PATTERN, то растровое изображение, на которое указывает элемент lbHatch этой структуры, не может быть разделом DIB. Раздел DIB — это растровое изображение, созданное createDIBSection. Если это растровое изображение является разделом DIB, функция ExtCreatePen завершается ошибкой .

Если приложению больше не требуется указанное перо, оно должно вызвать функцию DeleteObject для удаления пера.

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

Примеры

Пример см. в разделе Использование перьев.

Требования

См. также раздел

CreateDIBSection

Createpen

CreatePenIndirect

DeleteObject

GetObject

LOGBRUSH

Функции пера

Обзор перьев

SelectObject

SetMiterLimit