CPen::CreatePen

發行項
02/28/2013

建立一個邏輯化妝產品或幾何畫筆與指定的樣式、寬度和筆刷屬性，並將其附加至 CPen 物件。

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

參數

nPenStyle
為畫筆指定樣式。如需可能值的清單，請參閱 CPen 建構函式的 nPenStyle 參數。
nWidth
指定畫筆的寬度。
- 對於 CreatePen第一個版本，則為，如果這個值是零，不管對應模式，以裝置單位表示的寬度永遠是以像素為單位)。
- 對於 CreatePen第二個版本，則為，否則為 nPenStylePS_GEOMETRIC，此寬度 (以邏輯單位為單位。如果 nPenStyle 是 PS_COSMETIC，必須設定這個寬度設定為{1}。
crColor
包含畫筆的 RGB 色彩。
pLogBrush
對 LOGBRUSH 結構的點。如果 nPenStyle 是 PS_COSMETIC， LOGBRUSH 結構的 lbColor 成員指定畫筆的色彩，並 LOGBRUSH 結構的 lbStyle 成員必須設定為 BS_SOLID。如果 nPenStyle 是 PS_GEOMETRIC，所有成員必須使用指定這個畫筆的筆刷屬性。
nStyleCount
在兩字單位指定長度，則為， lpStyle 陣列。如果不是， nPenStylePS_USERSTYLE，這個值必須為零。
lpStyle
對的兩點數值。第一個值在一個使用者定義樣式指定第一條虛線的長度，第二個值指定第一個空格的長度，依此類推。如果不是， nPenStylePS_USERSTYLE，這個指標必須是空值。

傳回值

如果成功，則為非零值為，則方法會失敗。

備註

CreatePen 第一版中使用指定的樣式、寬度和色彩的畫筆。畫筆之後可以選取做為收到目前筆為所有裝置內容。

具有大於一個寬度的畫筆的像素一定要有 PS_NULL、 PS_SOLID或 PS_INSIDEFRAME 樣式。

如果畫筆有 PS_INSIDEFRAME 樣式和邏輯色彩表中沒有符合色彩的某個色彩時，畫筆繪製一經遞色的色彩。PS_SOLID 筆模式無法用來建立一經遞色的色彩的畫筆。如果畫筆寬度小於或等於為 .，模式 PS_INSIDEFRAME 與 PS_SOLID 是相同的。

CreatePen 第二版初始化具有指定的樣式、寬度和筆刷屬性的一個邏輯化妝產品或幾何畫筆。一支化妝畫筆的寬度永遠為;幾何一支畫筆的寬度 (以全局單位表示一律指定。在應用程式建立邏輯畫筆後，就可以選取畫筆選取到裝置內容中呼叫 CDC::SelectObject 函式。在畫筆選取到裝置內容後，就可以用它來繪製直線和曲線。

如果 nPenStyle 是 PS_COSMETIC 和 PS_USERSTYLE，在 lpStyle 陣列的輸入樣式單位指定虛線的長度和空格。樣式單位由畫筆來繪製線條的裝置所定義。
如果 nPenStyle 是 PS_GEOMETRIC 和 PS_USERSTYLE，在 lpStyle 陣列的輸入以邏輯單位指定虛線的長度和空格。
如果 nPenStyle 是 PS_ALTERNATE，樣式單位被忽略，而其他像素設定。

當應用程式不再需要特定一支畫筆時，應該呼叫 CGdiObject::DeleteObject 成員函式或終結物件，因此 CPen 資源不再使用。當畫筆在裝置內容時，選取應用程式不應該刪除畫筆。

範例

CPen myPen1, myPen2;

// Create a solid red pen of width 2.
myPen1.CreatePen(PS_SOLID, 2, RGB(255,0,0));

// Create a geometric pen.
LOGBRUSH logBrush;
logBrush.lbStyle = BS_SOLID;
logBrush.lbColor = RGB(0,255,0);
myPen2.CreatePen(PS_DOT|PS_GEOMETRIC|PS_ENDCAP_ROUND, 2, &logBrush);