기초 가이드
시작하기
C++ 또는 PySide6에서 FluentQt를 초기화하고 앱에 필요한 모듈만 선택하세요.
Qt Widgets 기반 아키텍처
FluentQt 컨트롤은 표준 Qt Widgets입니다. Button은 QPushButton을, LineEdit은 QLineEdit을 상속합니다(SpatialItem 같은 일부 헬퍼는 QObject 또는 QGraphicsObject를 상속). 대부분의 위젯은 테마를 위한 FluentElement와 바인딩·앵커·상태 관리를 위한 QMLPlus도 함께 상속합니다.
애플리케이션 초기화
QApplication을 생성하기 전에 prepareHighDpiApplication()을 호출하고, 생성 직후 initializeResources()를 호출해 내장 글꼴과 아이콘을 불러옵니다.
#include <FluentQt/FluentQt.h>
#include <QApplication>
int main(int argc, char* argv[]) {
fluent::prepareHighDpiApplication();
QApplication app(argc, argv);
fluent::initializeResources();
fluent::windowing::Window window;
window.show();
return app.exec();
}import sys
import fluentqt
from PySide6.QtWidgets import QApplication
fluentqt.prepare_high_dpi_application()
app = QApplication(sys.argv)
fluentqt.initialize_resources()
window = fluentqt.Window()
window.show()
sys.exit(app.exec())선택적 모듈
FluentQt::FluentQt에는 핵심 위젯, 차트, 디자인 상수가 포함됩니다. 필요할 때만 선택 대상을 연결하세요: FluentQt::Plugins, FluentQt::Particles(애니메이션 배경), FluentQt::Spatial(3D 원근 뷰), FluentQt::QmlBridge(임베디드 QML).