CPen::CreatePen

BOOL CreatePen ( int nPenStyle, int nWidth, COLORREF crColor );

BOOL CreatePen ( int nPenStyle, int nWidth, const LOGBRUSH * pLogBrush, int nStyleCount = 0, const DWORD * lpStyle = NULL );

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

Ненулевое значение, или дескриптор логической пера, в случае успеха; в противном случае 0.

Параметры

nPenStyle

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

nWidth

Определяет ширину пера.

• Для первой версии CreatePenесли это значение равно 0, ширина в единицах устройства всегда будет 1 пиксель, независимо от режима отображения.
  
  
• Для второй версии CreatePenесли nPenStyle является PS_GEOMETRIC, ширина дается в логических единицах. Если nPenStyle PS_COSMETIC, ширина должно быть присвоено 1.

crColor

Содержит цвет RGB для пера.

pLogBrush

Указывает на LOGBRUSH структуры. Если nPenStyle PS_COSMETIC, lbColor член LOGBRUSH структуры определяет цвет пера и lbStyle член LOGBRUSH структуры должно быть присвоено значение BS_SOLID. Если nPenStyle PS_GEOMETRIC, все члены должны использоваться для определения атрибутов кисти пера.

nStyleCount

Задает длину, в единицах двойных слов, lpStyle массива. Это значение должно быть нулевым, если nPenStyle не PS_USERSTYLE.

lpStyle

Указывает на массив значений двойных слов. Первое значение указывает длину первого тире в пользовательский стиль, второе значение указывает длину первой пространства и так далее. Этот указатель должен иметь значение NULL , если nPenStyle не PS_USERSTYLE.

Примечания

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

Ручки, которые должны иметь ширину больше, чем 1 точка всегда должен иметь стиль PS_NULL, PS_SOLIDили PS_INSIDEFRAME.

Если ручка имеет PS_INSIDEFRAME стиль и цвет, который не соответствует цвет в таблице цветов логической, перо рисуется цветом, полутона. Стиль пера PS_SOLID не может использоваться для создания pen с цветом, полутона. Стиль PS_INSIDEFRAME идентичен PS_SOLID , если толщина пера меньше или равен 1.

Вторая версия CreatePen Инициализирует логический косметических или геометрические перо, имеющий указанный стиль, ширину и кисти атрибутов. Ширина пера косметических всегда равно 1; Ширина геометрические пера всегда указываются в международных единицах измерения. После того, как приложение создает логический пен, то можно выбрать это перо в контекст устройства путем вызова CDC::SelectObject функции. После того, как ручка выбрана в контекст устройства, она может использоваться для рисования прямых и кривых линий.

• Если nPenStyle PS_COSMETIC и PS_USERSTYLE, записи в массиве lpStyle указывают длину штрихов и пробелов в стиле единицах. Блок стиля определяется устройством, в котором используется перо для рисования линии.
  
  
• Если nPenStyle является PS_GEOMETRIC и PS_USERSTYLE, записи в lpStyle массиве указать длину штрихов и пробелов в логических единицах.
  
  
• Если nPenStyle PS_ALTERNATE, подразделение стиль игнорируется, и каждый пиксел имеет значение.

Когда приложение больше не требует конкретного пен, следует вызвать функцию-член CGdiObject::DeleteObject или уничтожить объект CPen , чтобы ресурс уже не используется. Приложение не следует удалять пера, когда перо выбран в контекст устройства.

Обзор CPen |nbsp; Члены класса | Иерархическая схема

См. также CPen::CreatePenIndirect, CPen::CPen, CGdiObject::DeleteObject, LOGBRUSH