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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
|
<?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)</li><li><div class="fn" /><b><a href="qbrush.html#QBrush-3">__init__</a></b> (<i>self</i>, QColor, Qt.BrushStyle <i>style</i> = Qt.SolidPattern)</li><li><div class="fn" /><b><a href="qbrush.html#QBrush-4">__init__</a></b> (<i>self</i>, Qt.GlobalColor, Qt.BrushStyle <i>style</i> = Qt.SolidPattern)</li><li><div class="fn" /><b><a href="qbrush.html#QBrush-5">__init__</a></b> (<i>self</i>, QColor, QPixmap)</li><li><div class="fn" /><b><a href="qbrush.html#QBrush-6">__init__</a></b> (<i>self</i>, Qt.GlobalColor, QPixmap)</li><li><div class="fn" /><b><a href="qbrush.html#QBrush-7">__init__</a></b> (<i>self</i>, QPixmap)</li><li><div class="fn" /><b><a href="qbrush.html#QBrush-8">__init__</a></b> (<i>self</i>, QImage)</li><li><div class="fn" /><b><a href="qbrush.html#QBrush-9">__init__</a></b> (<i>self</i>, QGradient)</li><li><div class="fn" /><b><a href="qbrush.html#QBrush-10">__init__</a></b> (<i>self</i>, QBrush)</li><li><div class="fn" /><b><a href="qbrush.html#QBrush-11">__init__</a></b> (<i>self</i>, QVariant <i>variant</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" />QMatrix <b><a href="qbrush.html#matrix">matrix</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qbrush.html#setColor">setColor</a></b> (<i>self</i>, QColor)</li><li><div class="fn" /><b><a href="qbrush.html#setColor-2">setColor</a></b> (<i>self</i>, Qt.GlobalColor)</li><li><div class="fn" /><b><a href="qbrush.html#setMatrix">setMatrix</a></b> (<i>self</i>, QMatrix)</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)</li><li><div class="fn" /><b><a href="qbrush.html#setTextureImage">setTextureImage</a></b> (<i>self</i>, QImage)</li><li><div class="fn" /><b><a href="qbrush.html#setTransform">setTransform</a></b> (<i>self</i>, QTransform)</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><li><div class="fn" />QImage <b><a href="qbrush.html#textureImage">textureImage</a></b> (<i>self</i>)</li><li><div class="fn" />QTransform <b><a href="qbrush.html#transform">transform</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)</li><li><div class="fn" />bool <b><a href="qbrush.html#__ne__">__ne__</a></b> (<i>self</i>, QBrush)</li></ul><a name="details" /><hr /><h2>Detailed Description</h2><p>A
<a href="qcolor.html">QColor</a>
or a
<a href="qgradient.html">QGradient</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 appropriate 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>. Gradient brushes are created by giving a <a href="qgradient.html">QGradient</a> as a constructor argument when creating the QBrush. Qt provides three different gradients: <a href="qlineargradient.html">QLinearGradient</a>, <a href="qconicalgradient.html">QConicalGradient</a>, and <a href="qradialgradient.html">QRadialGradient</a> - all of which inherit <a href="qgradient.html">QGradient</a>.</p>
<pre> QRadialGradient gradient(50, 50, 50, 50, 50);
gradient.setColorAt(0, QColor.fromRgbF(0, 1, 0, 1));
gradient.setColorAt(1, QColor.fromRgbF(0, 0, 0, 0));
QBrush brush(gradient);</pre>
<p>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>. You can create a brush with a texture by providing the pixmap when the brush is created or by using <a href="qbrush.html#setTexture">setTexture</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>, regardless 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 have 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>
<p><table align="center" border="0" cellpadding="2" cellspacing="1" class="generic" width="100%">
<tr class="odd" 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></p>
<p>For more information about painting in general, see <a href="paintsystem.html">The Paint System</a> 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>)</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>, <a href="qt.html#BrushStyle-enum">Qt.BrushStyle</a> <i>style</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>, <a href="qt.html#BrushStyle-enum">Qt.BrushStyle</a> <i>style</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>, <a href="qpixmap.html">QPixmap</a>)</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 class="compat" 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>, <a href="qpixmap.html">QPixmap</a>)</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 class="compat" 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>)</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="qimage.html">QImage</a>)</h3><p>Constructs a brush with a black color and a texture set to the given <i>image</i>. The style is set to <a href="qt.html#BrushStyle-enum">Qt.TexturePattern</a>.</p>
<p>See also <a href="qbrush.html#setTextureImage">setTextureImage</a>().</p>
<h3 class="fn"><a name="QBrush-9" />QBrush.__init__ (<i>self</i>, <a href="qgradient.html">QGradient</a>)</h3><p>Constructs a copy of <i>other</i>.</p>
<h3 class="fn"><a name="QBrush-10" />QBrush.__init__ (<i>self</i>, <a href="qbrush.html">QBrush</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>
<a name="//apple_ref/cpp/instm/QBrush/~QBrush" />
<h3 class="fn"><a name="QBrush-11" />QBrush.__init__ (<i>self</i>, QVariant <i>variant</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>
<a name="//apple_ref/cpp/instm/QBrush/gradient" />
<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>
<a name="//apple_ref/cpp/instm/QBrush/isOpaque" />
<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 have 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>
<a name="//apple_ref/cpp/instm/QBrush/matrix" />
<h3 class="fn"><a name="matrix" /><a href="qmatrix.html">QMatrix</a> QBrush.matrix (<i>self</i>)</h3><p>Returns the current transformation matrix for the brush.</p>
<p>This function was introduced in Qt 4.2.</p>
<p>See also <a href="qbrush.html#setMatrix">setMatrix</a>().</p>
<a name="//apple_ref/cpp/instm/QBrush/setColor" />
<h3 class="fn"><a name="setColor" />QBrush.setColor (<i>self</i>, <a href="qcolor.html">QColor</a>)</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>)</h3><p>This is an overloaded function.</p>
<p>Sets the brush color to the given <i>color</i>.</p>
<a name="//apple_ref/cpp/instm/QBrush/setMatrix" />
<h3 class="fn"><a name="setMatrix" />QBrush.setMatrix (<i>self</i>, <a href="qmatrix.html">QMatrix</a>)</h3><p>Sets <i>matrix</i> as an explicit transformation matrix on the current brush. The brush transformation matrix is merged with <a href="qpainter.html">QPainter</a> transformation matrix to produce the final result.</p>
<p>This function was introduced in Qt 4.2.</p>
<p>See also <a href="qbrush.html#matrix">matrix</a>().</p>
<a name="//apple_ref/cpp/instm/QBrush/setStyle" />
<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>
<a name="//apple_ref/cpp/instm/QBrush/setTexture" />
<h3 class="fn"><a name="setTexture" />QBrush.setTexture (<i>self</i>, <a href="qpixmap.html">QPixmap</a>)</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>
<a name="//apple_ref/cpp/instm/QBrush/setTextureImage" />
<h3 class="fn"><a name="setTextureImage" />QBrush.setTextureImage (<i>self</i>, <a href="qimage.html">QImage</a>)</h3><p>Sets the brush image to <i>image</i>. The style is set to <a href="qt.html#BrushStyle-enum">Qt.TexturePattern</a>.</p>
<p>Note the current brush color will <i>not</i> have any affect on monochrome images, as opposed to calling <a href="qbrush.html#setTexture">setTexture</a>() with a <a href="qbitmap.html">QBitmap</a>. If you want to change the color of monochrome image brushes, either convert the image to <a href="qbitmap.html">QBitmap</a> with <tt>QBitmap.fromImage()</tt> and set the resulting <a href="qbitmap.html">QBitmap</a> as a texture, or change the entries in the color table for the image.</p>
<p>This function was introduced in Qt 4.2.</p>
<p>See also <a href="qbrush.html#textureImage">textureImage</a>() and <a href="qbrush.html#setTexture">setTexture</a>().</p>
<a name="//apple_ref/cpp/instm/QBrush/setTransform" />
<h3 class="fn"><a name="setTransform" />QBrush.setTransform (<i>self</i>, <a href="qtransform.html">QTransform</a>)</h3><p>Sets <i>matrix</i> as an explicit transformation matrix on the current brush. The brush transformation matrix is merged with <a href="qpainter.html">QPainter</a> transformation matrix to produce the final result.</p>
<p>This function was introduced in Qt 4.3.</p>
<p>See also <a href="qbrush.html#transform">transform</a>().</p>
<a name="//apple_ref/cpp/instm/QBrush/style" />
<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>
<a name="//apple_ref/cpp/instm/QBrush/texture" />
<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>
<a name="//apple_ref/cpp/instm/QBrush/textureImage" />
<h3 class="fn"><a name="textureImage" /><a href="qimage.html">QImage</a> QBrush.textureImage (<i>self</i>)</h3><p>Returns the custom brush pattern, or a null image if no custom brush pattern has been set.</p>
<p>If the texture was set as a <a href="qpixmap.html">QPixmap</a> it will be converted to a <a href="qimage.html">QImage</a>.</p>
<p>This function was introduced in Qt 4.2.</p>
<p>See also <a href="qbrush.html#setTextureImage">setTextureImage</a>().</p>
<a name="//apple_ref/cpp/instm/QBrush/transform" />
<h3 class="fn"><a name="transform" /><a href="qtransform.html">QTransform</a> QBrush.transform (<i>self</i>)</h3><p>Returns the current transformation matrix for the brush.</p>
<p>This function was introduced in Qt 4.3.</p>
<p>See also <a href="qbrush.html#setTransform">setTransform</a>().</p>
<a name="//apple_ref/cpp/instm/QBrush/operator QVariant" />
<h3 class="fn"><a name="__eq__" />bool QBrush.__eq__ (<i>self</i>, <a href="qbrush.html">QBrush</a>)</h3><h3 class="fn"><a name="__ne__" />bool QBrush.__ne__ (<i>self</i>, <a href="qbrush.html">QBrush</a>)</h3><address><hr /><div align="center"><table border="0" cellspacing="0" width="100%"><tr class="address"><td align="left" width="25%">PyQt 4.7.3 for X11</td><td align="center" width="50%">Copyright © <a href="http://www.riverbankcomputing.com">Riverbank Computing Ltd</a> and <a href="http://www.qtsoftware.com">Nokia</a> 2010</td><td align="right" width="25%">Qt 4.6.2</td></tr></table></div></address></body></html>
|
