Sur cette page

QStyleHintReturn Class

La classe QStyleHintReturn fournit des indications de style qui renvoient plus que des types de données de base. Plus d'informations...

En-tête : #include <QStyleHintReturn>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets
Héritée de :

QStyleHintReturnMask et QStyleHintReturnVariant

Types publics

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

Fonctions publiques

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

Variables publiques

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

Description détaillée

QStyleHintReturn et ses sous-classes sont utilisées pour transmettre des informations d'un style au widget de requête. Ceci est particulièrement utile lorsque la valeur de retour de QStyle::styleHint() ne fournit pas suffisamment de détails ; par exemple, lorsqu'un masque doit être renvoyé.

Documentation sur les types de membres

enum QStyleHintReturn::HintReturnType

ConstanteValeurDescription
QStyleHintReturn::SH_Default0xf000QStyleHintReturn
QStyleHintReturn::SH_Mask0xf001QStyle::SH_RubberBand_Mask QStyle::SH_FocusFrame_Mask
QStyleHintReturn::SH_Variant0xf002QStyle::SH_TextControl_FocusIndicatorTextCharFormat

enum QStyleHintReturn::StyleOptionType

Cette énumération est utilisée pour contenir des informations sur le type de l'option de style et est définie pour chaque sous-classe de QStyleHintReturn.

ConstanteValeurDescription
QStyleHintReturn::TypeSH_DefaultType d'option de style fournie (SH_Default pour cette classe).

Le type est utilisé en interne par QStyleHintReturn, ses sous-classes et qstyleoption_cast() pour déterminer le type de l'option de style. En général, vous n'avez pas besoin de vous en préoccuper, sauf si vous souhaitez créer votre propre sous-classe QStyleHintReturn et vos propres styles.

Voir aussi StyleOptionVersion.

enum QStyleHintReturn::StyleOptionVersion

Cette énumération est utilisée pour contenir des informations sur la version de l'option de style et est définie pour chaque sous-classe de QStyleHintReturn.

ConstanteValeurDescription de l'option
QStyleHintReturn::Version11

La version est utilisée par les sous-classes de QStyleHintReturn pour implémenter des extensions sans rompre la compatibilité. Si vous utilisez qstyleoption_cast(), vous n'avez normalement pas besoin de la vérifier.

Voir aussi StyleOptionType.

Documentation des fonctions membres

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

Construit un QStyleHintReturn avec la version version et le type type.

La version n'a pas de signification particulière pour QStyleHintReturn ; elle peut être utilisée par les sous-classes pour distinguer les différentes versions d'un même type d'indice.

Voir également QStyleOption::version et QStyleOption::type.

Documentation des variables membres

int QStyleHintReturn::type

Cette variable contient le type du conteneur d'indices de style

Voir aussi HintReturnType.

int QStyleHintReturn::version

Cette variable contient la version du conteneur de retour des indications de style

Cette valeur peut être utilisée par les sous-classes pour mettre en œuvre des extensions sans rompre la compatibilité. Si vous utilisez qstyleoption_cast<T>(), vous n'avez normalement pas besoin de la vérifier.

Non-membres apparentés

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

Renvoie un T ou nullptr en fonction de type et version de hint.

Exemple :

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

Voir aussi QStyleHintReturn::type et QStyleHintReturn::version.

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

Renvoie un T ou nullptr selon le type de hint.

Il s'agit d'une fonction surchargée.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.