Sur cette page

QStyleHintReturn Class

La classe QStyleHintReturn fournit des indications de style qui renvoient plus que des types de données de base. En savoir plus...

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

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 renvoyer des informations d'un style vers le widget qui a émis la requête. Cela s'avère particulièrement utile lorsque la valeur renvoyée par 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 sert à contenir des informations sur le type de l'option de style et est définie pour chaque sous-classe de ` QStyleHintReturn `.

ConstanteValeurDescription
QStyleHintReturn::TypeSH_DefaultLe type de l'option de style fournie (SH_Default pour cette classe).

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

Voir également StyleOptionVersion.

enum QStyleHintReturn::StyleOptionVersion

Cette énumération sert à stocker des informations sur la version de l'option de style et est définie pour chaque sous-classe de ` QStyleHintReturn `.

ConstanteValeurDescription
QStyleHintReturn::Version11

Cette 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 généralement pas besoin de la vérifier.

Voir aussi StyleOptionType.

Documentation sur les fonctions membres

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

Construit un objet `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 différentes versions d'un même type d'indice.

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

Documentation sur les variables membres

int QStyleHintReturn::type

Cette variable contient le type du conteneur de conseils de style

Voir également HintReturnType.

int QStyleHintReturn::version

Cette variable contient la version du conteneur de retour de l'indication de style

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

Éléments non membres associés

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

Renvoie un T ou un nullptr selon les paramètres type et version de la fonction 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 également QStyleHintReturn::type et QStyleHintReturn::version.

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

Renvoie un T ou un ` 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.