Back to Qt.io
Contact Us Blog Download Qt

QQuickStyle Class

QQuickStyle 클래스를 사용하면 애플리케이션 스타일을 구성할 수 있습니다. 더 보기...

Header: #include <QQuickStyle>
CMake: find_package(Qt6 REQUIRED COMPONENTS QuickControls2)
target_link_libraries(mytarget PRIVATE Qt6::QuickControls2)
qmake: QT += quickcontrols2

정적 공개 멤버

QString name()
void setFallbackStyle(const QString &style)
void setStyle(const QString &style)

상세 설명

QQuickStyle은 Qt Quick Controls 의 애플리케이션 스타일을 쿼리하고 구성하기 위한 API를 제공합니다.

#include <QGuiApplication>
#include <QQmlApplicationEngine>
#include <QQuickStyle>

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    QQuickStyle::setStyle("Material");

    QQmlApplicationEngine engine;
    engine.load(QUrl("qrc:/main.qml"));

    return app.exec();
}

참고: 스타일은 Qt Quick Controls 을 가져오는 QML을 로드하기 전에 구성해야 합니다. QML 유형을 등록한 후에는 스타일을 변경할 수 없습니다.

참고: 컴파일 시 스타일 선택을 사용할 때는 QQuickStyle이 지원되지 않습니다.

사용자 지정 스타일을 직접 만들려면 사용자 지정 스타일 만들기를 참조하세요. 사용자 지정 스타일은 모든 컨트롤을 구현할 필요는 없습니다. 기본적으로 스타일링 시스템은 사용자 지정 스타일이 제공하지 않는 컨트롤에 대한 폴백으로 기본 스타일을 사용합니다. 다른 대체 스타일을 지정하여 기본 제공 스타일 중 하나를 사용자 지정하거나 확장할 수 있습니다.

QQuickStyle::setStyle("MyStyle");
QQuickStyle::setFallbackStyle("Material");

스타일링 Qt Quick Controls 을참조하세요 .

멤버 함수 문서

[static] QString QQuickStyle::name()

애플리케이션 스타일의 이름을 반환합니다.

참고: 애플리케이션 스타일은 -style 명령줄 인수를 전달하여 지정할 수 있습니다. 따라서 QGuiApplication 을 구성하기 전에 name() 을 호출하면 완전히 확인된 값을 반환하지 않을 수 있습니다.

[static] void QQuickStyle::setFallbackStyle(const QString &style)

애플리케이션 폴백 스타일을 style 으로 설정합니다.

참고: 폴백 스타일은 기본 제공 Qt Quick Controls 스타일 중 하나의 이름(예: "Material")이어야 합니다.

참고: 스타일은 Qt Quick Controls 을 가져오는 QML을 로드하기 전에 구성해야 합니다. QML 유형이 등록된 후에는 스타일을 변경할 수 없습니다.

폴백 스타일은 QT_QUICK_CONTROLS_FALLBACK_STYLE 환경 변수를 설정하여 지정할 수도 있습니다.

setStyle() 및 Qt Quick Controls 에서 스타일 사용하기를참조하세요 .

[static] void QQuickStyle::setStyle(const QString &style)

애플리케이션 스타일을 style 로 설정합니다.

참고: 스타일은 Qt Quick Controls 을 가져오는 QML을 로드하기 전에 구성해야 합니다. QML 유형을 등록한 후에는 스타일을 변경할 수 없습니다.

setFallbackStyle() 및 Qt Quick Controls 에서 스타일 사용하기를참조하세요 .

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