<class name="QPaintEngineState" doc="/** <p>The <a href="QPaintEngineState.html#QPaintEngineState()"><tt>QPaintEngineState</tt></a> class provides information about the active paint engine's current state.</p> <p><a href="QPaintEngineState.html#QPaintEngineState()"><tt>QPaintEngineState</tt></a> records which properties that have changed since the last time the paint engine was updated, as well as their current value.</p> <p>Which properties that have changed can at any time be retrieved using the <a href="QPaintEngineState.html#state()"><tt>state</tt></a> function. This function returns an instance of the QPaintEngine::DirtyFlags type which stores an OR combination of QPaintEngine::DirtyFlag values. The QPaintEngine::DirtyFlag enum defines whether a property has changed since the last update or not.</p> <p>If a property is marked with a dirty flag, its current value can be retrieved using the corresponding get function:</p> <a name="getfunction"></a><p><table align="center" cellpadding="2" cellspacing="1" border="0"> <thead><tr valign="top" class="qt-style"><th>Property Flag</th><th>Current Property Value</th></tr></thead> <tr valign="top" class="odd"><td>QPaintEngine::DirtyBackground</td><td><a href="QPaintEngineState.html#backgroundBrush()"><tt>backgroundBrush</tt></a></td></tr> <tr valign="top" class="even"><td>QPaintEngine::DirtyBackgroundMode</td><td><a href="QPaintEngineState.html#backgroundMode()"><tt>backgroundMode</tt></a></td></tr> <tr valign="top" class="odd"><td>QPaintEngine::DirtyBrush</td><td><a href="QPaintEngineState.html#brush()"><tt>brush</tt></a></td></tr> <tr valign="top" class="even"><td>QPaintEngine::DirtyBrushOrigin</td><td><a href="QPaintEngineState.html#brushOrigin()"><tt>brushOrigin</tt></a></td></tr> <tr valign="top" class="odd"><td>QPaintEngine::DirtyClipRegion <i>or</i> QPaintEngine::DirtyClipPath</td><td><a href="QPaintEngineState.html#clipOperation()"><tt>clipOperation</tt></a></td></tr> <tr valign="top" class="even"><td>QPaintEngine::DirtyClipPath</td><td><a href="QPaintEngineState.html#clipPath()"><tt>clipPath</tt></a></td></tr> <tr valign="top" class="odd"><td>QPaintEngine::DirtyClipRegion</td><td><a href="QPaintEngineState.html#clipRegion()"><tt>clipRegion</tt></a></td></tr> <tr valign="top" class="even"><td>QPaintEngine::DirtyCompositionMode</td><td><a href="QPaintEngineState.html#compositionMode()"><tt>compositionMode</tt></a></td></tr> <tr valign="top" class="odd"><td>QPaintEngine::DirtyFont</td><td><a href="QPaintEngineState.html#font()"><tt>font</tt></a></td></tr> <tr valign="top" class="even"><td>QPaintEngine::DirtyTransform</td><td><a href="QPaintEngineState.html#matrix()"><tt>matrix</tt></a></td></tr> <tr valign="top" class="odd"><td>QPaintEngine::DirtyClipEnabled</td><td><a href="QPaintEngineState.html#isClipEnabled()"><tt>isClipEnabled</tt></a></td></tr> <tr valign="top" class="even"><td>QPaintEngine::DirtyPen</td><td><a href="QPaintEngineState.html#pen()"><tt>pen</tt></a></td></tr> <tr valign="top" class="odd"><td>QPaintEngine::DirtyHints</td><td><a href="QPaintEngineState.html#renderHints()"><tt>renderHints</tt></a></td></tr> </table></p> <p>The <a href="QPaintEngineState.html#QPaintEngineState()"><tt>QPaintEngineState</tt></a> class also provide the <a href="QPaintEngineState.html#painter()"><tt>painter</tt></a> function which returns a pointer to the painter that is currently updating the paint engine.</p> <p>An instance of this class, representing the current state of the active paint engine, is passed as argument to the QPaintEngine::updateState() function. The only situation in which you will have to use this class directly is when implementing your own paint engine.</p> @see <a href="QPaintEngine.html"><tt>QPaintEngine</tt></a> */"> <method name="public QPaintEngineState()"/> <method name="public final com.trolltech.qt.gui.QBrush backgroundBrush()" doc="/** <p>Returns the background brush in the current paint engine state.</p> <p>This variable should only be used when the <a href="QPaintEngineState.html#state()"><tt>state</tt></a> returns a combination which includes the QPaintEngine::DirtyBackground flag.</p> @see <a href="QPaintEngineState.html#state()"><tt>state</tt></a> @see <tt>QPaintEngine::updateState</tt> */"/> <method name="public final com.trolltech.qt.core.Qt.BGMode backgroundMode()" doc="/** <p>Returns the background mode in the current paint engine state.</p> <p>This variable should only be used when the <a href="QPaintEngineState.html#state()"><tt>state</tt></a> returns a combination which includes the QPaintEngine::DirtyBackgroundMode flag.</p> @see <a href="QPaintEngineState.html#state()"><tt>state</tt></a> @see <tt>QPaintEngine::updateState</tt> */"/> <method name="public final com.trolltech.qt.gui.QBrush brush()" doc="/** <p>Returns the brush in the current paint engine state.</p> <p>This variable should only be used when the <a href="QPaintEngineState.html#state()"><tt>state</tt></a> returns a combination which includes the QPaintEngine::DirtyBrush flag.</p> @see <a href="QPaintEngineState.html#state()"><tt>state</tt></a> @see <tt>QPaintEngine::updateState</tt> */"/> <method name="public final boolean brushNeedsResolving()" doc="/** <p>Returns whether the coordinate of the fill have been specified as bounded by the current rendering operation and have to be resolved (about the currently rendered primitive).</p> */"/> <method name="public final com.trolltech.qt.core.QPointF brushOrigin()" doc="/** <p>Returns the brush origin in the current paint engine state.</p> <p>This variable should only be used when the <a href="QPaintEngineState.html#state()"><tt>state</tt></a> returns a combination which includes the QPaintEngine::DirtyBrushOrigin flag.</p> @see <a href="QPaintEngineState.html#state()"><tt>state</tt></a> @see <tt>QPaintEngine::updateState</tt> */"/> <method name="public final com.trolltech.qt.core.Qt.ClipOperation clipOperation()" doc="/** <p>Returns the clip operation in the current paint engine state.</p> <p>This variable should only be used when the <a href="QPaintEngineState.html#state()"><tt>state</tt></a> returns a combination which includes either the QPaintEngine::DirtyClipPath or the QPaintEngine::DirtyClipRegion flag.</p> @see <a href="QPaintEngineState.html#state()"><tt>state</tt></a> @see <tt>QPaintEngine::updateState</tt> */"/> <method name="public final com.trolltech.qt.gui.QPainterPath clipPath()" doc="/** <p>Returns the clip path in the current paint engine state.</p> <p>This variable should only be used when the <a href="QPaintEngineState.html#state()"><tt>state</tt></a> returns a combination which includes the QPaintEngine::DirtyClipPath flag.</p> @see <a href="QPaintEngineState.html#state()"><tt>state</tt></a> @see <tt>QPaintEngine::updateState</tt> */"/> <method name="public final com.trolltech.qt.gui.QRegion clipRegion()" doc="/** <p>Returns the clip region in the current paint engine state.</p> <p>This variable should only be used when the <a href="QPaintEngineState.html#state()"><tt>state</tt></a> returns a combination which includes the QPaintEngine::DirtyClipRegion flag.</p> @see <a href="QPaintEngineState.html#state()"><tt>state</tt></a> @see <tt>QPaintEngine::updateState</tt> */"/> <method name="public final com.trolltech.qt.gui.QPainter.CompositionMode compositionMode()" doc="/** <p>Returns the composition mode in the current paint engine state.</p> <p>This variable should only be used when the <a href="QPaintEngineState.html#state()"><tt>state</tt></a> returns a combination which includes the QPaintEngine::DirtyCompositionMode flag.</p> @see <a href="QPaintEngineState.html#state()"><tt>state</tt></a> @see <tt>QPaintEngine::updateState</tt> */"/> <method name="public final com.trolltech.qt.gui.QFont font()" doc="/** <p>Returns the font in the current paint engine state.</p> <p>This variable should only be used when the <a href="QPaintEngineState.html#state()"><tt>state</tt></a> returns a combination which includes the QPaintEngine::DirtyFont flag.</p> @see <a href="QPaintEngineState.html#state()"><tt>state</tt></a> @see <tt>QPaintEngine::updateState</tt> */"/> <method name="public final boolean isClipEnabled()" doc="/** <p>Returns wether clipping is enabled or not in the current paint engine state.</p> <p>This variable should only be used when the <a href="QPaintEngineState.html#state()"><tt>state</tt></a> returns a combination which includes the QPaintEngine::DirtyClipEnabled flag.</p> @see <a href="QPaintEngineState.html#state()"><tt>state</tt></a> @see <tt>QPaintEngine::updateState</tt> */"/> <method name="public final com.trolltech.qt.gui.QMatrix matrix()" doc="/** <p>Returns the matrix in the current paint engine state.</p> <p>This variable should only be used when the <a href="QPaintEngineState.html#state()"><tt>state</tt></a> returns a combination which includes the QPaintEngine::DirtyTransform flag.</p> @see <a href="QPaintEngineState.html#state()"><tt>state</tt></a> @see <tt>QPaintEngine::updateState</tt> */"/> <method name="public final double opacity()" doc="/** <p>Returns the opacity in the current paint engine state.</p> */"/> <method name="public final com.trolltech.qt.gui.QPainter painter()" doc="/** <p>Returns a pointer to the painter currently updating the paint engine.</p> */"/> <method name="public final com.trolltech.qt.gui.QPen pen()" doc="/** <p>Returns the pen in the current paint engine state.</p> <p>This variable should only be used when the <a href="QPaintEngineState.html#state()"><tt>state</tt></a> returns a combination which includes the QPaintEngine::DirtyPen flag.</p> @see <a href="QPaintEngineState.html#state()"><tt>state</tt></a> @see <tt>QPaintEngine::updateState</tt> */"/> <method name="public final boolean penNeedsResolving()" doc="/** <p>Returns whether the coordinate of the stroke have been specified as bounded by the current rendering operation and have to be resolved (about the currently rendered primitive).</p> */"/> <method name="public final com.trolltech.qt.gui.QPainter.RenderHints renderHints()" doc="/** <p>Returns the render hints in the current paint engine state.</p> <p>This variable should only be used when the <a href="QPaintEngineState.html#state()"><tt>state</tt></a> returns a combination which includes the QPaintEngine::DirtyHints flag.</p> @see <a href="QPaintEngineState.html#state()"><tt>state</tt></a> @see <tt>QPaintEngine::updateState</tt> */"/> <method name="public final com.trolltech.qt.gui.QPaintEngine.DirtyFlags state()" doc="/** <p>Returns a combination of flags identifying the set of properties that need to be updated when updating the paint engine's state (i.e&#x2e; during a call to the QPaintEngine::updateState() function).</p> @see <tt>QPaintEngine::updateState</tt> */"/> <method name="public final com.trolltech.qt.gui.QTransform transform()" doc="/** <p>Returns the matrix in the current paint engine state.</p> <p>This variable should only be used when the <a href="QPaintEngineState.html#state()"><tt>state</tt></a> returns a combination which includes the QPaintEngine::DirtyTransform flag.</p> @see <a href="QPaintEngineState.html#state()"><tt>state</tt></a> @see <tt>QPaintEngine::updateState</tt> */"/> <method name="protected final com.trolltech.qt.gui.QPaintEngine.DirtyFlags dirtyFlags()"/> <method name="protected final void setDirtyFlags(com.trolltech.qt.gui.QPaintEngine.DirtyFlags dirtyFlags)"/> </class>