查看源代码 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_ROUNDwxCAP_PROJECTINGwxCAP_BUTT 之一。

返回对画笔颜色的引用。

返回画笔连接样式,可以是 wxJOIN_BEVELwxJOIN_ROUNDwxJOIN_MITER 之一。

返回画笔样式。

返回画笔宽度。

如果画笔已初始化,则返回 true。

默认构造函数。

复制构造函数,使用 overview_refcount。

从颜色对象、画笔宽度和样式构造画笔。

设置画笔端盖样式,可以是 wxCAP_ROUNDwxCAP_PROJECTINGwxCAP_BUTT 之一。

画笔的颜色更改为给定的颜色。

设置画笔连接样式,可以是 wxJOIN_BEVELwxJOIN_ROUNDwxJOIN_MITER 之一。

设置画笔样式。

设置画笔宽度。

类型

函数

-spec destroy(This :: wxPen()) -> ok.

销毁对象

-spec getCap(This) -> wx:wx_enum() when This :: wxPen().

返回画笔端盖样式,可以是 wxCAP_ROUNDwxCAP_PROJECTINGwxCAP_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_BEVELwxJOIN_ROUNDwxJOIN_MITER 之一。

默认值为 wxJOIN_ROUND

参见: setJoin/2

-spec getStyle(This) -> wx:wx_enum() when This :: wxPen().

返回画笔样式。

参见

-spec getWidth(This) -> integer() when This :: wxPen().

返回画笔宽度。

参见: setWidth/2

-spec isOk(This) -> boolean() when This :: wxPen().

如果画笔已初始化,则返回 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 和其他平台的不同版本支持上述样式非常不同的子集,因此请小心处理。

参见

链接到此函数

setCap(This, CapStyle)

查看源代码
-spec setCap(This, CapStyle) -> ok when This :: wxPen(), CapStyle :: wx:wx_enum().

设置画笔端盖样式,可以是 wxCAP_ROUNDwxCAP_PROJECTINGwxCAP_BUTT 之一。

默认值为 wxCAP_ROUND

参见: getCap/1

链接到此函数

setColour(This, Colour)

查看源代码
-spec setColour(This, Colour) -> ok when This :: wxPen(), Colour :: wx:wx_colour().

画笔的颜色更改为给定的颜色。

参见: getColour/1

链接到此函数

setColour(This, Red, Green, Blue)

查看源代码
-spec setColour(This, Red, Green, Blue) -> ok
                   when This :: wxPen(), Red :: integer(), Green :: integer(), Blue :: integer().
链接到此函数

setJoin(This, Join_style)

查看源代码
-spec setJoin(This, Join_style) -> ok when This :: wxPen(), Join_style :: wx:wx_enum().

设置画笔连接样式,可以是 wxJOIN_BEVELwxJOIN_ROUNDwxJOIN_MITER 之一。

默认值为 wxJOIN_ROUND

参见: getJoin/1

-spec setStyle(This, Style) -> ok when This :: wxPen(), Style :: wx:wx_enum().

设置画笔样式。

参见: new/2

-spec setWidth(This, Width) -> ok when This :: wxPen(), Width :: integer().

设置画笔宽度。

参见: getWidth/1