En esta página

QStyleHintReturn Class

La clase QStyleHintReturn proporciona sugerencias de estilo que devuelven más que tipos de datos básicos. Más información...

Encabezado: #include <QStyleHintReturn>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado por:

QStyleHintReturnMask y QStyleHintReturnVariant

Tipos públicos

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

Funciones públicas

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

Variables públicas

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

Descripción detallada

QStyleHintReturn y sus subclases se utilizan para devolver información desde un estilo al widget solicitante. Esto resulta especialmente útil cuando el valor de retorno de QStyle::styleHint() no proporciona suficientes detalles; por ejemplo, cuando se debe devolver una máscara.

Documentación sobre los tipos de miembros

enum QStyleHintReturn::HintReturnType

ConstanteValorDescripción
QStyleHintReturn::SH_Default0xf000QStyleHintReturn
QStyleHintReturn::SH_Mask0xf001QStyle::SH_RubberBand_Mask QStyle::SH_FocusFrame_Mask
QStyleHintReturn::SH_Variant0xf002QStyle::SH_TextControl_FocusIndicatorTextCharFormat

enum QStyleHintReturn::StyleOptionType

Esta enumeración se utiliza para almacenar información sobre el tipo de la opción de estilo y se define para cada subclase de ` QStyleHintReturn `.

ConstanteValorDescripción
QStyleHintReturn::TypeSH_DefaultEl tipo de opción de estilo proporcionada (SH_Default para esta clase).

El tipo lo utilizan internamente ` QStyleHintReturn`, sus subclases y ` qstyleoption_cast()` para determinar el tipo de opción de estilo. En general, no es necesario que te preocupes por esto, a menos que quieras crear tu propia subclase de ` QStyleHintReturn ` y tus propios estilos.

Véase también StyleOptionVersion.

enum QStyleHintReturn::StyleOptionVersion

Esta enumeración se utiliza para almacenar información sobre la versión de la opción de estilo y se define para cada subclase de ` QStyleHintReturn `.

ConstanteValorDescripción
QStyleHintReturn::Version11

Las subclases de ` QStyleHintReturn ` utilizan esta versión para implementar extensiones sin romper la compatibilidad. Si utilizas ` qstyleoption_cast()`, normalmente no es necesario comprobarla.

Véase también StyleOptionType.

Documentación de funciones miembro

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

Crea un objeto `QStyleHintReturn` con la versión version y el tipo type.

La versión no tiene ningún significado especial para QStyleHintReturn; las subclases pueden utilizarla para distinguir entre diferentes versiones del mismo tipo de sugerencia.

Véase también QStyleOption::version y QStyleOption::type.

Documentación de las variables miembro

int QStyleHintReturn::type

Esta variable contiene el tipo del contenedor de sugerencias de estilo

Véase también HintReturnType.

int QStyleHintReturn::version

Esta variable contiene la versión del contenedor de resultados de las sugerencias de estilo

Las subclases pueden utilizar este valor para implementar extensiones sin romper la compatibilidad. Si utilizas qstyleoption_cast<T>(), normalmente no es necesario comprobarlo.

Elementos no miembros relacionados

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

Devuelve un T o un « nullptr », dependiendo de los valores de « type » y « version » de « hint ».

Ejemplo:

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

Véanse también QStyleHintReturn::type y QStyleHintReturn::version.

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

Devuelve un T o un ` nullptr `, dependiendo del tipo de ` hint`.

Esta es una función sobrecargada.

© 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.