<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<!-- /tmp/qt-4.2.1-harald-1161357942206/qt-x11-opensource-src-4.2.1/src/gui/styles/qstyleoption.cpp -->
<head>
<title>Qt 4.2: QStyleOptionFrameV2 Class Reference</title>
<link href="classic.css" rel="stylesheet" type="text/css" />
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td align="left" valign="top" width="32"><a href="http://www.trolltech.com/products/qt"><img src="images/qt-logo.png" align="left" width="32" height="32" border="0" /></a></td>
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="mainclasses.html"><font color="#004faf">Main Classes</font></a> · <a href="groups.html"><font color="#004faf">Grouped Classes</font></a> · <a href="modules.html"><font color="#004faf">Modules</font></a> · <a href="functions.html"><font color="#004faf">Functions</font></a></td>
<td align="right" valign="top" width="230"><a href="http://www.trolltech.com"><img src="images/trolltech-logo.png" align="right" width="203" height="32" border="0" /></a></td></tr></table><h1 align="center">QStyleOptionFrameV2 Class Reference<br /><sup><sup>[<a href="qtgui.html">QtGui</a> module]</sup></sup></h1>
<p>The QStyleOptionFrameV2 class is used to describe the parameters necessary for drawing a frame in Qt 4.1 or above. <a href="#details">More...</a></p>
<pre> #include <QStyleOptionFrameV2></pre><p>Inherits <a href="qstyleoptionframe.html">QStyleOptionFrame</a>.</p>
<p>This class was introduced in Qt 4.1.</p>
<ul>
<li><a href="qstyleoptionframev2-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-types"></a>
<h3>Public Types</h3>
<ul>
<li><div class="fn"/>enum <b><a href="qstyleoptionframev2.html#FrameFeature-enum">FrameFeature</a></b> { None, Flat }</li>
<li><div class="fn"/>flags <b><a href="qstyleoptionframev2.html#FrameFeature-enum">FrameFeatures</a></b></li>
<li><div class="fn"/>enum <b><a href="qstyleoptionframev2.html#StyleOptionVersion-enum">StyleOptionVersion</a></b> { Version }</li>
</ul>
<a name="public-functions"></a>
<h3>Public Functions</h3>
<ul>
<li><div class="fn"/><b><a href="qstyleoptionframev2.html#QStyleOptionFrameV2">QStyleOptionFrameV2</a></b> ()</li>
<li><div class="fn"/><b><a href="qstyleoptionframev2.html#QStyleOptionFrameV2-2">QStyleOptionFrameV2</a></b> ( const QStyleOptionFrameV2 & <i>other</i> )</li>
<li><div class="fn"/><b><a href="qstyleoptionframev2.html#QStyleOptionFrameV2-3">QStyleOptionFrameV2</a></b> ( const QStyleOptionFrame & <i>other</i> )</li>
<li><div class="fn"/>QStyleOptionFrameV2 & <b><a href="qstyleoptionframev2.html#operator-eq">operator=</a></b> ( const QStyleOptionFrame & <i>other</i> )</li>
</ul>
<ul>
<li><div class="fn"/>2 public functions inherited from <a href="qstyleoption.html#public-functions">QStyleOption</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li><div class="fn"/>2 public variables inherited from <a href="qstyleoptionframe.html#public-variables">QStyleOptionFrame</a></li>
<li><div class="fn"/>7 public variables inherited from <a href="qstyleoption.html#public-variables">QStyleOption</a></li>
</ul>
<a name="details"></a>
<hr />
<h2>Detailed Description</h2>
<p>The QStyleOptionFrameV2 class is used to describe the parameters necessary for drawing a frame in Qt 4.1 or above.</p>
<p>QStyleOptionFrameV2 inherits <a href="qstyleoptionframe.html">QStyleOptionFrame</a> which is used for drawing several built-in Qt widgets, including <a href="qframe.html">QFrame</a>, <a href="qgroupbox.html">QGroupBox</a>, <a href="qlineedit.html">QLineEdit</a>, and <a href="qmenu.html">QMenu</a>.</p>
<p>An instance of the QStyleOptionFrameV2 class has <a href="qstyleoption.html#type-varx">type</a> <a href="qstyleoption.html#OptionType-enum">SO_Frame</a> and <a href="qstyleoption.html#version-var">version</a> 2. The type is used internally by <a href="qstyleoption.html">QStyleOption</a>, its subclasses, and <a href="qstyleoption.html#qstyleoption_cast">qstyleoption_cast</a>() to determine the type of style option. In general you do not need to worry about this unless you want to create your own <a href="qstyleoption.html">QStyleOption</a> subclass and your own styles. The version is used by <a href="qstyleoption.html">QStyleOption</a> subclasses to implement extensions without breaking compatibility. If you use <a href="qstyleoption.html#qstyleoption_cast">qstyleoption_cast</a>(), you normally don't need to check it.</p>
<p>If you create your own <a href="qstyle.html">QStyle</a> subclass, you should handle both <a href="qstyleoptionframe.html">QStyleOptionFrame</a> and QStyleOptionFrameV2. One way to achieve this is to use the QStyleOptionFrameV2 copy constructor. For example:</p>
<pre> QStyleOptionFrame *option;
if (const QStyleOptionFrame *frameOption =
qstyleoption_cast<const QStyleOptionFrame *>(option)) {
QStyleOptionFrameV2 frameOptionV2(*frameOption);
<span class="comment">// draw the frame using frameOptionV2</span>
}</pre>
<p>In the example above: If the <tt>frameOption</tt>'s version is 1, <a href="qstyleoptionframev2.html#FrameFeature-enum">FrameFeature</a> is set to <a href="qstyleoptionframev2.html#FrameFeature-enum">None</a> for <tt>frameOptionV2</tt>. If <tt>frameOption</tt>'s version is 2, the constructor will simply copy the <tt>frameOption</tt>'s <a href="qstyleoptionframev2.html#FrameFeature-enum">FrameFeature</a> value.</p>
<p>For an example demonstrating how style options can be used, see the <a href="widgets-styles.html">Styles</a> example.</p>
<p>See also <a href="qstyleoptionframe.html">QStyleOptionFrame</a> and <a href="qstyleoption.html">QStyleOption</a>.</p>
<hr />
<h2>Member Type Documentation</h2>
<h3 class="flags"><a name="FrameFeature-enum"></a>enum QStyleOptionFrameV2::FrameFeature<br />flags QStyleOptionFrameV2::FrameFeatures</h3>
<p>This enum describles the different types of features a frame can have.</p>
<p><table border="1" cellpadding="2" cellspacing="1" width="100%">
<tr><th width="25%">Constant</th><th width="15%">Value</th><th width="60%">Description</th></tr>
<tr><td valign="top"><tt>QStyleOptionFrameV2::None</tt></td><td align="center" valign="top"><tt>0x00</tt></td><td valign="top">Indicates a normal frame.</td></tr>
<tr><td valign="top"><tt>QStyleOptionFrameV2::Flat</tt></td><td align="center" valign="top"><tt>0x01</tt></td><td valign="top">Indicates a flat frame.</td></tr>
</table></p>
<p>The FrameFeatures type is a typedef for <a href="qflags.html">QFlags</a><FrameFeature>. It stores an OR combination of FrameFeature values.</p>
<h3 class="fn"><a name="StyleOptionVersion-enum"></a>enum QStyleOptionFrameV2::StyleOptionVersion</h3>
<p>This enum is used to hold information about the version of the style option, and is defined for each <a href="qstyleoption.html">QStyleOption</a> subclass.</p>
<p><table border="1" cellpadding="2" cellspacing="1" width="100%">
<tr><th width="25%">Constant</th><th width="15%">Value</th><th width="60%">Description</th></tr>
<tr><td valign="top"><tt>QStyleOptionFrameV2::Version</tt></td><td align="center" valign="top"><tt>2</tt></td><td valign="top">2</td></tr>
</table></p>
<p>The version is used by <a href="qstyleoption.html">QStyleOption</a> subclasses to implement extensions without breaking compatibility. If you use <a href="qstyleoption.html#qstyleoption_cast">qstyleoption_cast</a>(), you normally don't need to check it.</p>
<p>See also <a href="qstyleoptionframe.html#StyleOptionType-enum">StyleOptionType</a>.</p>
<hr />
<h2>Member Function Documentation</h2>
<h3 class="fn"><a name="QStyleOptionFrameV2"></a>QStyleOptionFrameV2::QStyleOptionFrameV2 ()</h3>
<p>Constructs a <a href="qstyleoptionframev2.html">QStyleOptionFrameV2</a> object.</p>
<h3 class="fn"><a name="QStyleOptionFrameV2-2"></a>QStyleOptionFrameV2::QStyleOptionFrameV2 ( const QStyleOptionFrameV2 & <i>other</i> )</h3>
<p>Constructs a <a href="qstyleoptionframev2.html">QStyleOptionFrameV2</a> copy of the <i>other</i> style option.</p>
<h3 class="fn"><a name="QStyleOptionFrameV2-3"></a>QStyleOptionFrameV2::QStyleOptionFrameV2 ( const <a href="qstyleoptionframe.html">QStyleOptionFrame</a> & <i>other</i> )</h3>
<p>Constructs a <a href="qstyleoptionframev2.html">QStyleOptionFrameV2</a> copy of the <i>other</i> style option which can be either of the <a href="qstyleoptionframev2.html">QStyleOptionFrameV2</a> or <a href="qstyleoptionframe.html">QStyleOptionFrame</a> types.</p>
<p>If the <i>other</i> style option's version is 1, the new style option's <a href="qstyleoptionframev2.html#FrameFeature-enum">FrameFeature</a> value is set to <a href="qstyleoptionframev2.html#FrameFeature-enum">QStyleOptionFrameV2::None</a>. If its version is 2, its <a href="qstyleoptionframev2.html#FrameFeature-enum">FrameFeature</a> value is simply copied to the new style option.</p>
<p>See also <a href="qstyleoption.html#version-var">version</a>.</p>
<h3 class="fn"><a name="operator-eq"></a>QStyleOptionFrameV2 & QStyleOptionFrameV2::operator= ( const <a href="qstyleoptionframe.html">QStyleOptionFrame</a> & <i>other</i> )</h3>
<p>Assigns the <i>other</i> style option to this style option. The <i>other</i> style option can be either of the <a href="qstyleoptionframev2.html">QStyleOptionFrameV2</a> or <a href="qstyleoptionframe.html">QStyleOptionFrame</a> types.</p>
<p>If the <i>other</i> style option's version is 1, this style option's <a href="qstyleoptionframev2.html#FrameFeature-enum">FrameFeature</a> value is set to <a href="qstyleoptionframev2.html#FrameFeature-enum">QStyleOptionFrameV2::None</a>. If its version is 2, its <a href="qstyleoptionframev2.html#FrameFeature-enum">FrameFeature</a> value is simply copied to this style option.</p>
<p /><address><hr /><div align="center">
<table width="100%" cellspacing="0" border="0"><tr class="address">
<td width="30%">Copyright © 2006 <a href="trolltech.html">Trolltech</a></td>
<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>
<td width="30%" align="right"><div align="right">Qt 4.2.1</div></td>
</tr></table></div></address></body>
</html>
