查看源代码 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