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 );

ส่งกลับค่า

Nonzero หรือหมายเลขอ้างอิงของปากกาแบบลอจิคัล ถ้าสำเร็จ 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

ระบุความยาว ในหน่วย 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รุ่นที่สองเริ่มต้นตรรกะ cosmetic หรือทรงเรขาคณิตปากกาที่มีการระบุ ลักษณะ กว้าง และแปรงแอตทริบิวต์ ความกว้างของปากกา cosmetic เสมอคือ 1 ความกว้างของปากกาทรงเรขาคณิตจะระบุในหน่วยของโลกเสมอ หลังจากที่โปรแกรมประยุกต์สร้างปากกาแบบลอจิคัล นั้นสามารถเลือกปากกาที่ลงในบริบทอุปกรณ์ โดยการเรียกการCDC::SelectObject ฟังก์ชัน หลังจากเลือกปากกาลงในบริบทอุปกรณ์ นั้นจะถูกใช้เมื่อต้องการวาดเส้นตรงและเส้นโค้ง?

• ถ้าnPenStyle PS_COSMETICและPS_USERSTYLEรายการในอาร์เรย์lpStyleระบุความยาวของเส้นประและช่องว่างในลักษณะหน่วย มีกำหนดลักษณะหน่วย โดยอุปกรณ์ที่ปากกาที่ใช้ในการวาดเส้น?
  
  
• ถ้าnPenStyle PS_GEOMETRICและPS_USERSTYLEรายการในอาร์เรย์lpStyleระบุความยาวของเส้นประและช่องว่างในหน่วยทางลอจิคัล?
  
  
• ถ้าnPenStyle PS_ALTERNATEหน่วยลักษณะจะถูกละเว้น และตั้งค่าเป็นพิกเซลอื่น ๆ ทุก?

เมื่อโปรแกรมประยุกต์ไม่ต้องกำหนดปากกา ควรเรียกใช้ฟังก์ชันCGdiObject::DeleteObjectสมาชิก หรือทำลายวัตถุCPenดังนั้นทรัพยากรถูกใช้งานไม่ แอปพลิเคชันไม่ควรลบปากกาเมื่อเลือกปากกาในบริบทอุปกรณ์?

ภาพรวม CPen |nbsp สมาชิกของคลาส| แผนภูมิของลำดับชั้น(&N)

ดูเพิ่มเติมnbspCPen::CreatePenIndirect, CPen::CPen, CGdiObject::DeleteObject, LOGBRUSH(&N)