查看源码 wxBrush (wx v2.4.3)
画刷是一种用于填充区域的绘图工具。
它用于绘制矩形、椭圆等的背景。它具有颜色和样式。
在单色显示器上,除非颜色确实是黑色,否则 wxWidgets 会将所有画刷显示为白色。
在程序开始之前,不要在堆栈上初始化对象,因为其他必需的结构可能尚未设置。相反,定义指向对象的全局指针,并在 wxApp::OnInit
(在 wx 中未实现)或需要时创建它们。
应用程序可能希望动态创建具有不同特征的画刷,因此存在创建大量重复画刷的风险。因此,应用程序可能希望通过使用画刷的全局列表 ?wxTheBrushList 并调用成员函数 wxBrushList::FindOrCreateBrush()
(在 wx 中未实现)来获取指向画刷的指针。
此类在内部使用引用计数和写时复制,因此此类两个实例之间的赋值非常廉价。因此,您可以直接使用实际对象而不是指针,而不会产生效率问题。如果更改此类的实例,它将在内部创建自己的数据,以便先前使用引用计数共享数据的其他实例不受影响。
预定义对象(包含 wx.hrl)
?wxNullBrush
?wxBLACK_BRUSH
?wxBLUE_BRUSH
?wxCYAN_BRUSH
?wxGREEN_BRUSH
?wxYELLOW_BRUSH
?wxGREY_BRUSH
?wxLIGHT_GREY_BRUSH
?wxMEDIUM_GREY_BRUSH
?wxRED_BRUSH
?wxTRANSPARENT_BRUSH
?wxWHITE_BRUSH
参见
wxWidgets 文档: wxBrush
摘要
函数
销毁对象
返回对画刷颜色的引用。
获取指向点画位图的指针。
返回画刷样式,即 ?wxBrushStyle 值之一。
如果画刷的样式为任何阴影填充,则返回 true。
如果画刷已初始化,则返回 true。
默认构造函数。
复制构造函数,使用引用计数。
从颜色对象和 style
构造画刷。
使用红色、绿色和蓝色值设置画刷颜色。
设置点画位图。
设置画刷样式。
类型
-type wxBrush() :: wx:wx_object().
函数
-spec destroy(This :: wxBrush()) -> ok.
销毁对象
-spec getColour(This) -> wx:wx_colour4() when This :: wxBrush().
返回对画刷颜色的引用。
参见: setColour/4
-spec getStipple(This) -> wxBitmap:wxBitmap() when This :: wxBrush().
获取指向点画位图的指针。
如果画刷没有 wxBRUSHSTYLE_STIPPLE
样式,则此位图可能非 NULL 但未初始化(即 wxBitmap
:isOk/1
返回 false)。
参见: setStipple/2
-spec getStyle(This) -> wx:wx_enum() when This :: wxBrush().
返回画刷样式,即 ?wxBrushStyle 值之一。
参见
如果画刷的样式为任何阴影填充,则返回 true。
参见: getStyle/1
如果画刷已初始化,则返回 true。
请注意,未初始化的画刷对象无法查询任何画刷属性,并且对其调用所有访问器方法都会导致断言失败。
-spec new() -> wxBrush().
默认构造函数。
-spec new(Colour) -> wxBrush() when Colour :: wx:wx_colour(); (Brush) -> wxBrush() when Brush :: wxBrush:wxBrush() | wxBitmap:wxBitmap().
复制构造函数,使用引用计数。
-spec new(Colour, [Option]) -> wxBrush() when Colour :: wx:wx_colour(), Option :: {style, wx:wx_enum()}.
从颜色对象和 style
构造画刷。
-spec setColour(This, Colour) -> ok when This :: wxBrush(), Colour :: wx:wx_colour().
使用红色、绿色和蓝色值设置画刷颜色。
参见: getColour/1
-spec setStipple(This, Bitmap) -> ok when This :: wxBrush(), Bitmap :: wxBitmap:wxBitmap().
设置点画位图。
备注:样式将设置为 wxBRUSHSTYLE_STIPPLE
,除非位图具有与之关联的掩码,在这种情况下,样式将设置为 wxBRUSHSTYLE_STIPPLE_MASK_OPAQUE
。
参见: wxBitmap
-spec setStyle(This, Style) -> ok when This :: wxBrush(), Style :: wx:wx_enum().
设置画刷样式。
参见: getStyle/1