1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html><head><title>QBrush Class Reference</title><style>h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
td.postheader { font-family: sans-serif }
tr.address { font-family: sans-serif }
body { background: #ffffff; color: black; }
</style></head><body><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr /><td align="left" valign="top" width="32"><img align="left" border="0" height="32" src="images/rb-logo.png" width="32" /></td><td width="1">  </td><td class="postheader" valign="center"><a href="../pyqt4ref.html"><font color="#004faf">Home</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="modules.html"><font color="#004faf">Modules</font></a></td></table><h1 align="center">QBrush Class Reference<br /><sup><sup>[<a href="qtgui.html">QtGui</a> module]</sup></sup></h1><p>The QBrush class defines the fill pattern of shapes drawn by <a href="qpainter.html">QPainter</a>. <a href="#details">More...</a></p>
<h3>Methods</h3><ul><li><div class="fn" /><b><a href="qbrush.html#QBrush">__init__</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qbrush.html#QBrush-2">__init__</a></b> (<i>self</i>, Qt.BrushStyle <i>bs</i>)</li><li><div class="fn" /><b><a href="qbrush.html#QBrush-3">__init__</a></b> (<i>self</i>, QColor <i>color</i>, Qt.BrushStyle <i>bs</i> = Qt.SolidPattern)</li><li><div class="fn" /><b><a href="qbrush.html#QBrush-4">__init__</a></b> (<i>self</i>, Qt.GlobalColor <i>color</i>, Qt.BrushStyle <i>bs</i> = Qt.SolidPattern)</li><li><div class="fn" /><b><a href="qbrush.html#QBrush-5">__init__</a></b> (<i>self</i>, QColor <i>color</i>, QPixmap <i>pixmap</i>)</li><li><div class="fn" /><b><a href="qbrush.html#QBrush-6">__init__</a></b> (<i>self</i>, Qt.GlobalColor <i>color</i>, QPixmap <i>pixmap</i>)</li><li><div class="fn" /><b><a href="qbrush.html#QBrush-7">__init__</a></b> (<i>self</i>, QPixmap <i>pixmap</i>)</li><li><div class="fn" /><b><a href="qbrush.html#QBrush-8">__init__</a></b> (<i>self</i>, QGradient <i>gradient</i>)</li><li><div class="fn" /><b><a href="qbrush.html#QBrush-9">__init__</a></b> (<i>self</i>, QVariant)</li><li><div class="fn" /><b><a href="qbrush.html#QBrush-10">__init__</a></b> (<i>self</i>, QBrush <i>brush</i>)</li><li><div class="fn" />QColor <b><a href="qbrush.html#color">color</a></b> (<i>self</i>)</li><li><div class="fn" />QGradient <b><a href="qbrush.html#gradient">gradient</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qbrush.html#isOpaque">isOpaque</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qbrush.html#setColor">setColor</a></b> (<i>self</i>, QColor <i>color</i>)</li><li><div class="fn" /><b><a href="qbrush.html#setColor-2">setColor</a></b> (<i>self</i>, Qt.GlobalColor <i>acolor</i>)</li><li><div class="fn" /><b><a href="qbrush.html#setStyle">setStyle</a></b> (<i>self</i>, Qt.BrushStyle)</li><li><div class="fn" /><b><a href="qbrush.html#setTexture">setTexture</a></b> (<i>self</i>, QPixmap <i>pixmap</i>)</li><li><div class="fn" />Qt.BrushStyle <b><a href="qbrush.html#style">style</a></b> (<i>self</i>)</li><li><div class="fn" />QPixmap <b><a href="qbrush.html#texture">texture</a></b> (<i>self</i>)</li></ul><h3>Special Methods</h3><ul><li><div class="fn" />bool <b><a href="qbrush.html#__eq__">__eq__</a></b> (<i>self</i>, QBrush <i>b</i>)</li><li><div class="fn" />bool <b><a href="qbrush.html#__ne__">__ne__</a></b> (<i>self</i>, QBrush <i>b</i>)</li></ul><a name="details" /><hr /><h2>Detailed Description</h2><p>A
<a href="qcolor.html">QColor</a>
may be used whenever a
<a href="qbrush.html">QBrush</a>
is expected.</p>
<p>The QBrush class defines the fill pattern of shapes drawn by <a href="qpainter.html">QPainter</a>.</p>
<p>A brush has a style, a color, a gradient and a texture.</p>
<p>The brush <a href="qbrush.html#style">style</a>() defines the fill pattern using the <a href="qt.html#BrushStyle-enum">Qt.BrushStyle</a> enum. The default brush style is <a href="qt.html#BrushStyle-enum">Qt.NoBrush</a> (depending on how you construct a brush). This style tells the painter to not fill shapes. The standard style for filling is <a href="qt.html#BrushStyle-enum">Qt.SolidPattern</a>. The style can be set when the brush is created using the appropiate constructor, and in addition the <a href="qbrush.html#setStyle">setStyle</a>() function provides means for altering the style once the brush is constructed.</p>
<p align="center"><img alt="Brush Styles" src="images/brush-styles.png" /></p>
<p>The brush <a href="qbrush.html#color">color</a>() defines the color of the fill pattern. The color can either be one of Qt's predefined colors, <a href="qt.html#GlobalColor-enum">Qt.GlobalColor</a>, or any other custom <a href="qcolor.html">QColor</a>. The currently set color can be retrieved and altered using the <a href="qbrush.html#color">color</a>() and <a href="qbrush.html#setColor">setColor</a>() functions, respectively.</p>
<p>The <a href="qbrush.html#gradient">gradient</a>() defines the gradient fill used when the current style is either <a href="qt.html#BrushStyle-enum">Qt.LinearGradientPattern</a>, <a href="qt.html#BrushStyle-enum">Qt.RadialGradientPattern</a> or <a href="qt.html#BrushStyle-enum">Qt.ConicalGradientPattern</a>. The gradient can only be set when constructing the brush, while the <a href="qbrush.html#texture">texture</a>() can be set using the appropiate constructor or by using the <a href="qbrush.html#setTexture">setTexture</a>() function. The <a href="qbrush.html#texture">texture</a>() defines the pixmap used when the current style is <a href="qt.html#BrushStyle-enum">Qt.TexturePattern</a>.</p>
<p>Note that applying <a href="qbrush.html#setTexture">setTexture</a>() makes <a href="qbrush.html#style">style</a>() == <a href="qt.html#BrushStyle-enum">Qt.TexturePattern</a>, independently of previous style settings. Also, calling <a href="qbrush.html#setColor">setColor</a>() will not make a difference if the style is a gradient. The same is the case if the style is <a href="qt.html#BrushStyle-enum">Qt.TexturePattern</a> style unless the current texture is a <a href="qbitmap.html">QBitmap</a>.</p>
<p>The <a href="qbrush.html#isOpaque">isOpaque</a>() function returns true if the brush is fully opaque otherwise false. A brush is considered opaque if:</p>
<ul>
<li>The alpha component of the <a href="qbrush.html#color">color</a>() is 255.</li>
<li>Its <a href="qbrush.html#texture">texture</a>() does not an alpha channel and is not a <a href="qbitmap.html">QBitmap</a>.</li>
<li>The colors in the <a href="qbrush.html#gradient">gradient</a>() all have an alpha component that is 255.</li>
</ul>
<table align="center" border="0" cellpadding="2" cellspacing="1" width="100%">
<tr bgcolor="#F0F0F0" valign="top">
<td><img alt="Outlines" src="images/brush-outline.png" /></td>
<td>To specify the style and color of lines and outlines, use the <a href="qpainter.html">QPainter</a>'s <a href="qpen.html">pen</a> combined with <a href="qt.html#PenStyle-enum">Qt.PenStyle</a> and <a href="qt.html#GlobalColor-enum">Qt.GlobalColor</a>:
<pre>
QPainter painter(this);
painter.setBrush(Qt.cyan);
painter.setPen(Qt.darkCyan);
painter.drawRect(0, 0, 100,100);
painter.setBrush(Qt.NoBrush);
painter.setPen(Qt.darkGreen);
painter.drawRect(40, 40, 100, 100);
</pre>
<p>Note that, by default, <a href="qpainter.html">QPainter</a> renders the outline (using the currently set pen) when drawing shapes. Use <a href="qt.html#PenStyle-enum"><tt>painter.setPen(Qt.NoPen)</tt></a> to disable this behavior.</p>
</td>
</tr>
</table>
<br />
<br />
<p>For more information about painting in general, see {The Paint System} documentation.</p>
<p>See also <a href="qt.html#BrushStyle-enum">Qt.BrushStyle</a>, <a href="qpainter.html">QPainter</a>, and <a href="qcolor.html">QColor</a>.</p>
<hr /><h2>Method Documentation</h2><h3 class="fn"><a name="QBrush" />QBrush.__init__ (<i>self</i>)</h3><p>Constructs a default black brush with the style <a href="qt.html#BrushStyle-enum">Qt.NoBrush</a> (i.e. this brush will not fill shapes).</p>
<h3 class="fn"><a name="QBrush-2" />QBrush.__init__ (<i>self</i>, <a href="qt.html#BrushStyle-enum">Qt.BrushStyle</a> <i>bs</i>)</h3><p>Constructs a black brush with the given <i>style</i>.</p>
<p>See also <a href="qbrush.html#setStyle">setStyle</a>().</p>
<h3 class="fn"><a name="QBrush-3" />QBrush.__init__ (<i>self</i>, <a href="qcolor.html">QColor</a> <i>color</i>, <a href="qt.html#BrushStyle-enum">Qt.BrushStyle</a> <i>bs</i> = Qt.SolidPattern)</h3><p>Constructs a brush with the given <i>color</i> and <i>style</i>.</p>
<p>See also <a href="qbrush.html#setColor">setColor</a>() and <a href="qbrush.html#setStyle">setStyle</a>().</p>
<h3 class="fn"><a name="QBrush-4" />QBrush.__init__ (<i>self</i>, <a href="qt.html#GlobalColor-enum">Qt.GlobalColor</a> <i>color</i>, <a href="qt.html#BrushStyle-enum">Qt.BrushStyle</a> <i>bs</i> = Qt.SolidPattern)</h3><p>Constructs a brush with the given <i>color</i> and <i>style</i>.</p>
<p>See also <a href="qbrush.html#setColor">setColor</a>() and <a href="qbrush.html#setStyle">setStyle</a>().</p>
<h3 class="fn"><a name="QBrush-5" />QBrush.__init__ (<i>self</i>, <a href="qcolor.html">QColor</a> <i>color</i>, <a href="qpixmap.html">QPixmap</a> <i>pixmap</i>)</h3><p>Constructs a brush with the given <i>color</i> and the custom pattern stored in <i>pixmap</i>.</p>
<p>The style is set to <a href="qt.html#BrushStyle-enum">Qt.TexturePattern</a>. The color will only have an effect for QBitmaps.</p>
<p>See also <a href="qbrush.html#setColor">setColor</a>() and <a href="qbrush-qt3.html#setPixmap">setPixmap</a>().</p>
<h3 class="fn"><a name="QBrush-6" />QBrush.__init__ (<i>self</i>, <a href="qt.html#GlobalColor-enum">Qt.GlobalColor</a> <i>color</i>, <a href="qpixmap.html">QPixmap</a> <i>pixmap</i>)</h3><p>Constructs a brush with the given <i>color</i> and the custom pattern stored in <i>pixmap</i>.</p>
<p>The style is set to <a href="qt.html#BrushStyle-enum">Qt.TexturePattern</a>. The color will only have an effect for QBitmaps.</p>
<p>See also <a href="qbrush.html#setColor">setColor</a>() and <a href="qbrush-qt3.html#setPixmap">setPixmap</a>().</p>
<h3 class="fn"><a name="QBrush-7" />QBrush.__init__ (<i>self</i>, <a href="qpixmap.html">QPixmap</a> <i>pixmap</i>)</h3><p>Constructs a brush with a black color and a texture set to the given <i>pixmap</i>. The style is set to <a href="qt.html#BrushStyle-enum">Qt.TexturePattern</a>.</p>
<p>See also <a href="qbrush.html#setTexture">setTexture</a>().</p>
<h3 class="fn"><a name="QBrush-8" />QBrush.__init__ (<i>self</i>, <a href="qgradient.html">QGradient</a> <i>gradient</i>)</h3><p>Constructs a copy of <i>other</i>.</p>
<h3 class="fn"><a name="QBrush-9" />QBrush.__init__ (<i>self</i>, <a href="qvariant.html">QVariant</a>)</h3><p>Constructs a brush based on the given <i>gradient</i>.</p>
<p>The brush style is set to the corresponding gradient style (either <a href="qt.html#BrushStyle-enum">Qt.LinearGradientPattern</a>, <a href="qt.html#BrushStyle-enum">Qt.RadialGradientPattern</a> or <a href="qt.html#BrushStyle-enum">Qt.ConicalGradientPattern</a>).</p>
<h3 class="fn"><a name="QBrush-10" />QBrush.__init__ (<i>self</i>, <a href="qbrush.html">QBrush</a> <i>brush</i>)</h3><h3 class="fn"><a name="color" /><a href="qcolor.html">QColor</a> QBrush.color (<i>self</i>)</h3><p>Returns the brush color.</p>
<p>See also <a href="qbrush.html#setColor">setColor</a>().</p>
<h3 class="fn"><a name="gradient" /><a href="qgradient.html">QGradient</a> QBrush.gradient (<i>self</i>)</h3><p>Returns the gradient describing this brush.</p>
<h3 class="fn"><a name="isOpaque" />bool QBrush.isOpaque (<i>self</i>)</h3><p>Returns true if the brush is fully opaque otherwise false. A brush is considered opaque if:</p>
<ul>
<li>The alpha component of the <a href="qbrush.html#color">color</a>() is 255.</li>
<li>Its <a href="qbrush.html#texture">texture</a>() does not an alpha channel and is not a <a href="qbitmap.html">QBitmap</a>.</li>
<li>The colors in the <a href="qbrush.html#gradient">gradient</a>() all have an alpha component that is 255.</li>
</ul>
<h3 class="fn"><a name="setColor" />QBrush.setColor (<i>self</i>, <a href="qcolor.html">QColor</a> <i>color</i>)</h3><p>Sets the brush color to the given <i>color</i>.</p>
<p>Note that calling setColor() will not make a difference if the style is a gradient. The same is the case if the style is <a href="qt.html#BrushStyle-enum">Qt.TexturePattern</a> style unless the current texture is a <a href="qbitmap.html">QBitmap</a>.</p>
<p>See also <a href="qbrush.html#color">color</a>().</p>
<h3 class="fn"><a name="setColor-2" />QBrush.setColor (<i>self</i>, <a href="qt.html#GlobalColor-enum">Qt.GlobalColor</a> <i>acolor</i>)</h3><p>This is an overloaded member function, provided for convenience.</p>
<p>Sets the brush color to the given <i>color</i>.</p>
<h3 class="fn"><a name="setStyle" />QBrush.setStyle (<i>self</i>, <a href="qt.html#BrushStyle-enum">Qt.BrushStyle</a>)</h3><p>Sets the brush style to <i>style</i>.</p>
<p>See also <a href="qbrush.html#style">style</a>().</p>
<h3 class="fn"><a name="setTexture" />QBrush.setTexture (<i>self</i>, <a href="qpixmap.html">QPixmap</a> <i>pixmap</i>)</h3><p>Sets the brush pixmap to <i>pixmap</i>. The style is set to <a href="qt.html#BrushStyle-enum">Qt.TexturePattern</a>.</p>
<p>The current brush color will only have an effect for monochrome pixmaps, i.e. for <a href="qpixmap.html#depth">QPixmap.depth</a>() == 1 (<a href="qbitmap.html">QBitmaps</a>).</p>
<p>See also <a href="qbrush.html#texture">texture</a>().</p>
<h3 class="fn"><a name="style" /><a href="qt.html#BrushStyle-enum">Qt.BrushStyle</a> QBrush.style (<i>self</i>)</h3><p>Returns the brush style.</p>
<p>See also <a href="qbrush.html#setStyle">setStyle</a>().</p>
<h3 class="fn"><a name="texture" /><a href="qpixmap.html">QPixmap</a> QBrush.texture (<i>self</i>)</h3><p>Returns the custom brush pattern, or a null pixmap if no custom brush pattern has been set.</p>
<p>See also <a href="qbrush.html#setTexture">setTexture</a>().</p>
<h3 class="fn"><a name="__eq__" />bool QBrush.__eq__ (<i>self</i>, <a href="qbrush.html">QBrush</a> <i>b</i>)</h3><h3 class="fn"><a name="__ne__" />bool QBrush.__ne__ (<i>self</i>, <a href="qbrush.html">QBrush</a> <i>b</i>)</h3><address><hr /><div align="center"><table border="0" cellspacing="0" width="100%"><tr class="address"><td width="25%">PyQt 4.0.1 for X11</td><td align="center" width="50%">Copyright © <a href="http://www.riverbankcomputing.com">Riverbank Computing Ltd</a> and <a href="http://www.trolltech.com">Trolltech AS</a> 2006</td><td align="right" width="25%">Qt 4.1.4</td></tr></table></div></address></body></html>
|
