CPen::CreatePen

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

BOOL CreatePen ( int nPenStyle, int nWidth, константа LOGBRUSH * pLogBrush, int nStyleCount = 0, константа DWORD * lpStyle = NULL );

Значення, яке повертається

Nonzero, або маркер логічні пера, у разі успіху; в іншому випадку 0.

Параметри

nPenStyle

Визначає стиль для пера. Переглянути список можливих значень, CPen Конструктор, параметр nPenStyle.

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

Вказує довжину, в одиницях, doubleword, lpStyle масиву. Це значення має бути нуля, якщо nPenStyle не PS_USERSTYLE.

lpStyle

Точок на масив значень, doubleword. Перше значення вказує довжину першого тире в стилі, визначені користувачем, друге значення вказує довжину першого місця і так далі. Вказівник має бути NULL , якщо nPenStyle не PS_USERSTYLE.

Зауваження

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

Ручки, що мають ширину більша за 1 піксел повинні завжди мати на PS_NULL, PS_SOLIDабо PS_INSIDEFRAME стиль.

Якщо перо PS_INSIDEFRAME стиль і колір, який не відповідає кольорів у таблицю кольорів логічним, Перо звертається з dithered кольору. Стиль пера PS_SOLID не може бути використаний для створення пера dithered кольором. Стиль 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