QStyleHintReturn 类

QStyleHintReturn 类提供返回比基本数据类型更多的样式提示。 更多...

头: #include <QStyleHintReturn>
CMake: find_package(Qt6 COMPONENTS Widgets REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
继承者: QStyleHintReturnMask and QStyleHintReturnVariant

公共类型

enum HintReturnType { SH_Default, SH_Mask, SH_Variant }
enum StyleOptionType { Type }
enum StyleOptionVersion { Version }

公共函数

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

公共变量

int type
int version
T qstyleoption_cast (const QStyleHintReturn * hint )
T qstyleoption_cast (QStyleHintReturn * hint )

详细描述

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.

成员类型文档编制

enum QStyleHintReturn:: HintReturnType

常量 描述
QStyleHintReturn::SH_Default 0xf000 QStyleHintReturn
QStyleHintReturn::SH_Mask 0xf001 QStyle::SH_RubberBand_Mask QStyle::SH_FocusFrame_Mask
QStyleHintReturn::SH_Variant 0xf002 QStyle::SH_TextControl_FocusIndicatorTextCharFormat

enum QStyleHintReturn:: StyleOptionType

This enum is used to hold information about the type of the style option, and is defined for each QStyleHintReturn 子类。

常量 描述
QStyleHintReturn::Type SH_Default 提供样式选项的类型 ( SH_Default 对于此类)。

类型内部使用通过 QStyleHintReturn ,其子类,和 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 QStyleHintReturn subclass and your own styles.

另请参阅 StyleOptionVersion .

enum QStyleHintReturn:: StyleOptionVersion

This enum is used to hold information about the version of the style option, and is defined for each QStyleHintReturn 子类。

常量 描述
QStyleHintReturn::Version 1 1

版本的使用通过 QStyleHintReturn 子类以实现扩展在不破坏兼容性的情况下。若使用 qstyleoption_cast (),通常不需要校验它。

另请参阅 StyleOptionType .

成员函数文档编制

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.

另请参阅 QStyleOption::version and QStyleOption::type .

成员变量文档编制

int QStyleHintReturn:: type

This variable holds the type of the style hint container

另请参阅 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 do not need to check it.

相关非成员

template <typename T> T qstyleoption_cast (const QStyleHintReturn * hint )

返回 T 或 nullptr 从属 type and version of hint .

范例:

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) {
            ...
        }
    }
    ...
}
					

另请参阅 QStyleHintReturn::type and QStyleHintReturn::version .

template <typename T> T qstyleoption_cast ( QStyleHintReturn * hint )

这是重载函数。

返回 T 或 nullptr depending on the type of hint .