|  | Home · Overviews · Examples |

# QStyleOptionFrameV2 Class Reference
[com.trolltech.qt.gui module]

The `QStyleOptionFrameV2` class is used to describe the parameters necessary for drawing a frame in Qt 4.1 or above. More...

Inherits `QStyleOptionFrame`.

## Detailed Description

The `QStyleOptionFrameV2` class is used to describe the parameters necessary for drawing a frame in Qt 4.1 or above.

`QStyleOptionFrameV2` inherits `QStyleOptionFrame` which is used for drawing several built-in Qt widgets, including `QFrame`, `QGroupBox`, `QLineEdit`, and `QMenu`.

An instance of the `QStyleOptionFrameV2` class has type `SO_Frame` and version 2. The type is used internally by `QStyleOption`, its subclasses, and qstyleoption_cast() to determine the type of style option. In general you do not need to worry about this unless you want to create your own `QStyleOption` subclass and your own styles. The version is used by `QStyleOption` subclasses to implement extensions without breaking compatibility. If you use qstyleoption_cast(), you normally don't need to check it.

If you create your own `QStyle` subclass, you should handle both `QStyleOptionFrame` and `QStyleOptionFrameV2`. One way to achieve this is to use the `QStyleOptionFrameV2` copy constructor. For example:

            QStyleOptionFrame *option;

            if (const QStyleOptionFrame *frameOption =
                   qstyleoption_cast<const QStyleOptionFrame *>(option)) {
                QStyleOptionFrameV2 frameOptionV2(*frameOption);

                // draw the frame using frameOptionV2
            }

In the example above: If the `frameOption`'s version is 1, `FrameFeature` is set to None for `frameOptionV2`. If `frameOption`'s version is 2, the constructor will simply copy the `frameOption`'s `FrameFeature` value.

For an example demonstrating how style options can be used, see the Styles example.

See also `QStyleOptionFrame` and `QStyleOption`.