Back to Qt.io
Contact Us Blog Download Qt
이 페이지에서

QQuickStyle Class

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

헤더: #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은 지원되지 않습니다.

사용자 정의 스타일을 만들려면 사용자 정의 스타일 만들기를 참조하십시오. 사용자 정의 스타일은 모든 컨트롤을 구현할 필요는 없습니다. 기본적으로 스타일링 시스템은 사용자 정의 스타일이 제공하지 않는 컨트롤에 대해 ‘Basic’ 스타일을 대체 스타일로 사용합니다. 내장 스타일 중 하나를 사용자 정의하거나 확장하기 위해 다른 대체 스타일을 지정할 수 있습니다.

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 의 ‘스타일 사용’항목도 참조하십시오 .

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