QStyleHintReturn Class Reference
^{[QtGui module]}

Detailed Description

The QStyleHintReturn class provides style hints that return more than basic data types.

QStyleHintReturn and its subclasses are used to pass information from a style back to the querying widget. This is most useful when the return value from QStyle::styleHint() does not provide enough detail; for example, when a mask is to be returned.

Member Type Documentation

enum QStyleHintReturn::HintReturnType

Member Function Documentation

QStyleHintReturn::QStyleHintReturn ( int version = QStyleOption::Version, int type = SH_Default )

Constructs a QStyleHintReturn with version version and type type.

The version has no special meaning for QStyleHintReturn; it can be used by subclasses to distinguish between different version of the same hint type.

See also QStyleOption::version and QStyleOption::type.

Member Variable Documentation

const int QStyleHintReturn::Type

Equals SH_Default.

const int QStyleHintReturn::Version

Equals 1.

int QStyleHintReturn::type

This variable holds the type of the style hint container.

See also HintReturnType.

int QStyleHintReturn::version

This variable holds the version of the style hint return container.

This value can be used by subclasses to implement extensions without breaking compatibility. If you use qstyleoption_cast<T>(), you normally don't need to check it.

Related Non-Members

T qstyleoption_cast ( const QStyleHintReturn * hint )

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Returns a T or 0 depending on the type and version of hint.

Example:

    int MyStyle::styleHint(StyleHint stylehint, const QStyleOption *opt,
                           const QWidget *widget, QStyleHintReturn* returnData) const;
    {
        if (stylehint == SH_RubberBand_Mask) {
            const QStyleHintReturnMask *maskReturn =
                    qstyleoption_cast<const QStyleHintReturnMask *>(hint);
            if (maskReturn) {
                ...
            }
        }
        ...
    }

See also QStyleHintReturn::type and QStyleHintReturn::version.

T qstyleoption_cast ( QStyleHintReturn * hint )

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Returns a T or 0 depending on the type of hint.