이 페이지에서

QStyleHintReturn Class

QStyleHintReturn 클래스는 기본 데이터 유형 이상의 값을 반환하는 스타일 힌트를 제공합니다. 더 보기...

헤더: #include <QStyleHintReturn>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
상속된 항목:

QStyleHintReturnMask 그리고 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 및 그 하위 클래스는 스타일에서 쿼리를 보낸 위젯으로 정보를 전달하는 데 사용됩니다. 이는 QStyle::styleHint()의 반환 값이 충분한 세부 정보를 제공하지 않을 때, 예를 들어 마스크가 반환되어야 할 때 가장 유용합니다.

멤버 유형 설명

enum QStyleHintReturn::HintReturnType

상수값설명
QStyleHintReturn::SH_Default0xf000QStyleHintReturn
QStyleHintReturn::SH_Mask0xf001QStyle::SH_RubberBand_Mask QStyle::SH_FocusFrame_Mask
QStyleHintReturn::SH_Variant0xf002QStyle::SH_TextControl_FocusIndicatorTextCharFormat

enum QStyleHintReturn::StyleOptionType

이 열거형은 스타일 옵션의 유형에 대한 정보를 담기 위해 사용되며, 각 ` QStyleHintReturn ` 하위 클래스에 대해 정의됩니다.

상수상수명설명
QStyleHintReturn::TypeSH_Default제공된 스타일 옵션의 유형(이 클래스의 경우SH_Default ).

이 유형은 QStyleHintReturn, 그 하위 클래스 및 qstyleoption_cast()에서 스타일 옵션의 유형을 결정하기 위해 내부적으로 사용됩니다. 일반적으로 사용자 정의 QStyleHintReturn 하위 클래스와 사용자 정의 스타일을 만들려는 경우가 아니라면 이 부분에 대해 걱정할 필요가 없습니다.

StyleOptionVersion도 참조하십시오 .

enum QStyleHintReturn::StyleOptionVersion

이 열거형은 스타일 옵션의 버전에 대한 정보를 담기 위해 사용되며, 각 QStyleHintReturn 하위 클래스에 대해 정의됩니다.

상수상수상수값
QStyleHintReturn::Version11

이 버전은 QStyleHintReturn 의 하위 클래스에서 호환성을 해치지 않고 확장을 구현하는 데 사용됩니다. qstyleoption_cast()를 사용하는 경우, 일반적으로 이 값을 확인할 필요가 없습니다.

StyleOptionType도 참조하십시오 .

멤버 함수 문서

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

버전 version 및 유형 type 을 갖는 QStyleHintReturn 객체를 생성합니다.

버전은 QStyleHintReturn에 있어 특별한 의미를 가지지 않으며, 하위 클래스에서 동일한 힌트 유형의 서로 다른 버전을 구별하는 데 사용할 수 있습니다.

QStyleOption::version 및 QStyleOption::type도 참조하십시오 .

멤버 변수 문서

int QStyleHintReturn::type

이 변수는 스타일 힌트 컨테이너의 유형을 저장합니다

HintReturnType도 참조하십시오 .

int QStyleHintReturn::version

이 변수는 스타일 힌트 반환 컨테이너의 버전을 저장합니다.

이 값은 하위 클래스에서 호환성을 깨지 않고 확장 기능을 구현하는 데 사용할 수 있습니다. qstyleoption_cast<T>()를 사용하는 경우, 일반적으로 이 값을 확인할 필요가 없습니다.

관련 비멤버

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

hint 의 type 및 version 값에 따라 T 또는 nullptr 를 반환합니다.

예시:

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 및 QStyleHintReturn::version도 참조하십시오 .

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

hint 의 유형에 따라 T 또는 nullptr 를 반환합니다.

이 함수는 오버로드된 함수입니다.

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