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 = boş );

Dönüş değeri

Sıfır veya mantıksal bir kalem, başarılı olursa kolu; Aksi halde 0.

Parametreleri

nPenStyle

Kalem stilini belirtir. Olası değerler listesi için bkz: nPenStyle parametresi CPen Oluşturucu.

nWidth

Kalem genişliğini belirtir.

• Bu değer 0 ise CreatePenilk sürümü için aygıt birimlerinde her zaman eşleme moduna bakmaksızın 1 piksel genişliğidir.
  
  
• Eğer nPenStyle PS_GEOMETRIC, CreatePenikinci sürümü için genişlik mantıksal birimler cinsinden verilir. NPenStyle PS_COSMETICise, genişliği 1 olarak ayarlanmalıdır.

crColor

Kalem bir rgb rengi içerir.

pLogBrush

İşaret eden bir logbrush yapısı. NPenStyle PS_COSMETICise, logbrush yapısı lbColor üyesi kalemin rengini belirtir ve logbrush yapısı lbStyle üyesi BS_SOLIDiçin ayarlanmış olması gerekir. NPenStyle PS_GEOMETRICise, tüm üyeler kalem fırça özniteliklerini belirtmek için kullanılmalıdır.

nStyleCount

Uzunluk lpStyle dizinin doubleword birimler cinsinden belirtir. NPenStyle ps_userstyle değilse, bu değerin sıfır olması gerekir.

lpStyle

Doubleword değerleri noktaları bir dizi. İlk değer, kullanıcı tanımlı bir stili ilk çizgi uzunluğunu belirtir, ikinci değer ilk uzay ve uzunluğunu belirtir. NPenStyle ps_userstyle ise bu işaretçi null olmalıdır.

Açıklamalar

CreatePen ilk sürümü belirtilen stil, genişlik ve renk kalemle başlatır. Kalem sonradan herhangi bir aygıt içeriği için geçerli kalem olarak seçilebilir.

Kalem genişliği 1 piksel büyük olan her zaman ps_null, PS_SOLIDveya PS_INSIDEFRAME tarzı olmalıdır.

Kalem kalem PS_INSIDEFRAME tarzı ve mantıksal Renk tablosunda bir renk eşleşmeyen bir renk varsa, bir tanesinin bir renkle çizilir. PS_SOLID kalem tarzı bir kalem ile bir tanesinin renk oluşturmak için kullanılamaz. Kalem kalınlığını 1'e eşit veya küçükse stili PS_INSIDEFRAME PS_SOLID için aynıdır.

CreatePen ikinci sürümü belirtilen, genişlik, stil ve öznitelikleri fırça olan mantıksal kozmetik ya da geometrik kalem başlatır. Kozmetik kalem genişliği daima 1'dir; geometrik kalem genişliği her zaman dünya birimleri cinsinden belirtilir. Mantıksal bir kalem bir uygulamayı oluşturduktan sonra bu kalem bir aygıt içeriğini CDC::SelectObjectçağırarak seçebilirsiniz işlevi. Bir aygıt içeriğini kalem seçildikten sonra bu çizgiler ve eğriler çizmek için kullanılabilir.

• NPenStyle PS_COSMETIC ve ps_userstyleise, girişleri lpStyle dizi uzunlukları tireler ve boşluklar stil birimlerinde belirtin. Bir stil birimi olan bir çizgi çizmek için kalem kullanılan aygıt tarafından tanımlanır.
  
  
• NPenStyle PS_GEOMETRIC ve ps_userstyle lpStyle dizideki girdiler tireleri ve boşlukları uzunlukları mantıksal birimler cinsinden belirtin.
  
  
• NPenStyle ps_alternateise, stil birimi sayılır ve diğer her piksel olarak ayarlanır.

Bir uygulama artık belirli bir kalem gerektirdiğinde, bu CGdiObject::DeleteObject üye işlev çağrısı veya kaynak artık kullanımda bu yüzden CPen nesnesi yok. Bir aygıt bağlamında kalemi seçildiğinde uygulama kalem silmemeniz gerekir.

CPen genel bakış |nbsp; Sınıf üyeleri | Hiyerarşi çizelgesi

Ayrıca bkz: CPen::CreatePenIndirect, CPen::CPen, CGdiObject::DeleteObject, logbrush