CPen::CPen

CPen( );

CPen ( int nPenStyle, int nWidth, COLORREF crColor );
кинути ( CResourceException );

CPen ( int nPenStyle, int nWidth, константа LOGBRUSH * pLogBrush, int nStyleCount = 0, константа DWORD * lpStyle = NULL );
кинути ( CResourceException );

Параметри

nPenStyle

Визначає стиль пера. Цей параметр в першій версії конструктор може бути одне з таких значень:

• PS_SOLID   Створює твердої ручкою.
  
  
• PS_DASH   Створює пунктирні пера. Дійсні тільки тоді, коли ширина пера підрозділи 1-менш, у пристрої.
  
  
• PS_DOT   Створює пунктирною пера. Дійсні тільки тоді, коли ширина пера підрозділи 1-менш, у пристрої.
  
  
• PS_DASHDOT   Створює перо змінного тире і точок. Дійсні тільки тоді, коли ширина пера підрозділи 1-менш, у пристрої.
  
  
• PS_DASHDOTDOT   Створює перо змінного тире і подвійний точок. Дійсні тільки тоді, коли ширина пера підрозділи 1-менш, у пристрої.
  
  
• PS_&NULLnbsp;  Створює null пера.
  
  
• PS_I&NSIDEFRAMEnbsp;  Створює пера, що проведення лінії всередині кадру замкнену фігуру виробництва Windows GDI виводу функцій для визначення обмежуючого прямокутника (наприклад, на Еліпс, прямокутник, RoundRect, пирігта функцій акорд -членів). Коли цей стиль використовується Windows GDI виводу функції, які не вказано обмежуючого прямокутника (наприклад, LineTo член функція), області малювання пера не обмежується кадру.

  Друга версія CPen Конструктор визначає комбінації типу, стиль, кінець шапку і приєднатися до атрибутів. Значення з кожної категорії об'єднати за допомогою порозрядне OR оператор (|). Перо типу може бути одне з таких значень:

• PS_GEOMETRIC   Створює геометричних пера.
  
  
• PS_COSMETIC   Створює косметичних пера.

  Друга версія CPen Конструктор додає такі стилі пера для nPenStyle:

• PS_ALTER&NATEnbsp;  Створює пера, яка встановлює інші кожен піксель. (Цей стиль застосовується тільки для косметичної ручки).
  
  
• PS_USERSTYLE   Створює пера, що використовує стиль масиву, отримані від користувача.

  Кінець cap може бути одне з таких значень:

• PS_E&NDCAP_ROUNDnbsp;  Кінець caps є раунд.
  
  
• PS_E&NDCAP_SQUAREnbsp;  Кінець caps є квадратний.
  
  
• PS_E&NDCAP_FLATnbsp;  Кінець caps є плоскі.

  Об'єднання може бути одне з таких значень:

• PS_JOI&N_BEVELnbsp;  Об'єднання скошеними.
  
  
• PS_JOI&N_MITERnbsp;  Об'єднання mitered, коли вони знаходяться в межах поточне обмеження, встановлені в :: SetMiterLimit функції. Якщо об'єднання перевищує цей ліміт, воно є Багетна рамка.
  
  
• PS_JOI&N_ROUNDnbsp;  Об'єднання — раунд.

nWidth

Визначає ширину пера.

• Для першої версії Конструктор якщо це значення 0, ширина в одиницях пристрій завжди є 1 піксель, незалежно від того, режим відображення.
  
  
• Для друга версія Конструктор Якщо 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.

Зауваження

Якщо ви використовуєте Конструктор без аргументів, слід ініціалізувати кінцевий об'єкт CPen з CreatePen, CreatePenIndirectабо CreateStockObject функції члена. Якщо ви використовуєте Конструктор, що приймає аргументів, то не подальших ініціалізації необхідна. Конструктор з аргументами може кинути виняток, якщо помилка помилки, хоча завжди вдасться конструктора з аргументів.

Огляд CPen |nbsp; Члени класу | Ієрархічна діаграма

Дивіться також CPen::CreatePen, CPen::CreatePenIndirect, CGdiObject::CreateStockObject