檢視原始碼 wxPen (wx v2.4.3)
畫筆是用於繪製輪廓的繪圖工具。
它用於繪製線條以及繪製矩形、橢圓形等的輪廓。它具有顏色、寬度和樣式。
注意：在單色顯示器上，wxWidgets 會將所有非白色的畫筆顯示為黑色。
請勿在程式開始之前在堆疊上初始化物件，因為其他必要的結構可能尚未設置。 相反，請定義全域物件指標，並在 wxApp::OnInit()（wx 中未實現）或在需要時建立它們。
應用程式可能希望動態創建具有不同特性的畫筆，因此存在創建大量重複畫筆的危險。 因此，應用程式可能希望透過使用全域畫筆列表 ?wxThePenList，並呼叫成員函式 wxPenList::FindOrCreatePen() (wx 中未實現) 來取得畫筆的指標。有關更多資訊，請參閱 wxPenList (wx 中未實現)。
此類別內部使用引用計數和寫入時複製，因此此類別的兩個實例之間的賦值非常廉價。 因此，您可以使用實際的物件而不是指標，而不會有效率問題。 如果此類別的實例發生變更，它將在內部建立自己的資料，因此先前使用引用計數共用資料的其他實例不會受到影響。
預定義物件 (包含 wx.hrl)
?wxNullPen
?wxBLACK_DASHED_PEN
?wxBLACK_PEN
?wxBLUE_PEN
?wxCYAN_PEN
?wxGREEN_PEN
?wxYELLOW_PEN
?wxGREY_PEN
?wxLIGHT_GREY_PEN
?wxMEDIUM_GREY_PEN
?wxRED_PEN
?wxTRANSPARENT_PEN
?wxWHITE_PEN
參見
wxWidgets 文件：wxPen
摘要
函式
銷毀物件
傳回畫筆端點樣式，可能是 wxCAP\_ROUND、wxCAP\_PROJECTING 和 wxCAP\_BUTT 之一。
傳回畫筆顏色的參考。
傳回畫筆連接樣式，可能是 wxJOIN\_BEVEL、wxJOIN\_ROUND 和 wxJOIN\_MITER 之一。
傳回畫筆樣式。
傳回畫筆寬度。
如果畫筆已初始化，則傳回 true。
預設建構函式。
複製建構函式，使用 overview_refcount。
從顏色物件、畫筆寬度和樣式建構畫筆。
設定畫筆端點樣式，可能是 wxCAP\_ROUND、wxCAP\_PROJECTING 和 wxCAP\_BUTT 之一。
畫筆的顏色會變更為給定的顏色。
設定畫筆連接樣式，可能是 wxJOIN\_BEVEL、wxJOIN\_ROUND 和 wxJOIN\_MITER 之一。
設定畫筆樣式。
設定畫筆寬度。
類型
-type wxPen() :: wx:wx_object().
函式
-spec destroy(This :: wxPen()) -> ok.
銷毀物件
-spec getCap(This) -> wx:wx_enum() when This :: wxPen().
傳回畫筆端點樣式，可能是 wxCAP\_ROUND、wxCAP\_PROJECTING 和 wxCAP\_BUTT 之一。
預設值為 wxCAP_ROUND。
參見：setCap/2
-spec getColour(This) -> wx:wx_colour4() when This :: wxPen().
傳回畫筆顏色的參考。
參見：setColour/4
-spec getJoin(This) -> wx:wx_enum() when This :: wxPen().
傳回畫筆連接樣式，可能是 wxJOIN\_BEVEL、wxJOIN\_ROUND 和 wxJOIN\_MITER 之一。
預設值為 wxJOIN_ROUND。
參見：setJoin/2
-spec getStyle(This) -> wx:wx_enum() when This :: wxPen().
傳回畫筆樣式。
參見
傳回畫筆寬度。
參見：setWidth/2
如果畫筆已初始化，則傳回 true。
請注意，無法查詢未初始化的畫筆物件的任何畫筆屬性，並且對其呼叫所有存取器方法都將導致斷言失敗。
-spec new() -> wxPen().
預設建構函式。
畫筆將不會初始化，並且 isOk/1 將會傳回 false。
-spec new(Colour) -> wxPen() when Colour :: wx:wx_colour(); (Pen) -> wxPen() when Pen :: wxPen().
複製建構函式，使用 overview_refcount。
-spec new(Colour, [Option]) -> wxPen() when Colour :: wx:wx_colour(), Option :: {width, integer()} | {style, wx:wx_enum()}.
從顏色物件、畫筆寬度和樣式建構畫筆。
備註：不同版本的 Windows 和其他平台的不同版本支援的樣式子集差異很大，因此請謹慎處理。
參見
-spec setCap(This, CapStyle) -> ok when This :: wxPen(), CapStyle :: wx:wx_enum().
設定畫筆端點樣式，可能是 wxCAP\_ROUND、wxCAP\_PROJECTING 和 wxCAP\_BUTT 之一。
預設值為 wxCAP_ROUND。
參見：getCap/1
-spec setColour(This, Colour) -> ok when This :: wxPen(), Colour :: wx:wx_colour().
畫筆的顏色會變更為給定的顏色。
參見：getColour/1
-spec setJoin(This, Join_style) -> ok when This :: wxPen(), Join_style :: wx:wx_enum().
設定畫筆連接樣式，可能是 wxJOIN\_BEVEL、wxJOIN\_ROUND 和 wxJOIN\_MITER 之一。
預設值為 wxJOIN_ROUND。
參見：getJoin/1
-spec setStyle(This, Style) -> ok when This :: wxPen(), Style :: wx:wx_enum().
設定畫筆樣式。
參見：new/2
設定畫筆寬度。
參見：getWidth/1