Fluent-Qt

프로젝트 업데이트

릴리스 및 마이그레이션

버전별로 정리된 UILib 및 Gallery 업데이트와 마이그레이션 안내입니다.

1.12.1

최신 버전

UILib 컴포넌트 라이브러리

PropertyPanel은 행이 화면에 가까워지면 편집기를 만듭니다. AreaChart는 포인터를 움직일 때 이미 그린 채움 영역을 재사용합니다.

Gallery 예제 앱

What’s new 대화 상자를 스크롤해도 구분선 너머로 배경이 비치지 않습니다. 사진 예제는 필요할 때 이미지를 불러옵니다.

프로젝트 노트

웹사이트, 컴포넌트 API 문서, 대화형 속성 편집기를 9개 언어로 이용할 수 있습니다.

1.12.0

UILib 컴포넌트 라이브러리

버튼 아이콘과 레이블을 위아래로 배치하고, 트리 열 머리글을 표시하며, 최대화된 창을 의도한 모니터에 복원합니다.

  • Button::IconAbove 또는 Button::IconBelow를 사용하여 아이콘을 레이블 위나 아래에 배치할 수 있습니다.
  • TreeView가 표시된 열 머리글을 위한 공간을 확보합니다. 캡션과 열 머리글이 모두 숨겨진 경우 headerlessTopInset으로 첫 번째 행의 상단 간격을 조정할 수 있습니다.
  • Windows에서 최대화된 Window를 복원할 때 대상 모니터의 작업 영역을 사용합니다.

Gallery 예제 앱

오프라인으로 릴리스 노트를 읽고 트리 열 머리글 예제를 사용해 볼 수 있습니다.

  • 제목 표시줄에서 What’s new를 열 수 있습니다. 좁은 너비에서는 확성기 아이콘을 눌러 Gallery에 포함된 업데이트 내역을 확인하세요.
  • TreeView 예제에서 모델 머리글이 첫 번째 행 위에 표시되는 방식을 확인할 수 있습니다.

프로젝트 노트

99개 컴포넌트 문서 페이지에서 라이브 Qt 예제를 편집하고 결과 C++ 또는 PySide6 코드를 복사할 수 있습니다.

1.11.4

UILib 컴포넌트 라이브러리

진단 보고서, Windows 11 Snap Layouts 및 공통 텍스트 필드 프레임 설정을 추가합니다.

  • DiagnosticSession이 최근 UI 이벤트와 위젯 스냅샷을 메모리 내 ZIP 아카이브로 기록합니다.
  • 크기 조절이 가능한 Window의 최대화 버튼에 마우스 오버하면 Windows 11 Snap Layouts를 사용할 수 있습니다.
  • 텍스트 입력 필드가 LineEdit 프레임 설정을 공유합니다. 포커스가 없을 때의 밑줄 기본 너비는 0이며, 너비가 0인 테두리는 더 이상 가는 선을 그리지 않습니다.
  • Toast의 액션 위젯 소유권과 좁은 창에서의 레이아웃을 수정했습니다.

Gallery 예제 앱

최근 진단 정보가 담긴 ZIP 파일로 Gallery 문제를 보고할 수 있습니다.

  • Settings 옆의 Report a problem을 선택하면 일치하는 로컬 충돌 보고서를 포함한 진단 ZIP이 클립보드에 복사됩니다. 알림에서 Open GitHub issue를 선택한 뒤 파일을 붙여넣으세요.
  • 웹 Gallery에서는 진단 ZIP이 다운로드되므로 보고서에 첨부할 수 있습니다.

프로젝트 노트

웹사이트 릴리스 내역에서 UILib와 Gallery 업데이트를 분리하고, 범위 필터와 고정 버전 및 마이그레이션 링크를 제공합니다.

1.11.3

UILib 컴포넌트 라이브러리

Transfer, LineEdit 및 ComboBox의 단위 접미사와 후행 위젯, TextEdit 캐럿 위치 정보를 추가하고 편집 가능한 필드 레이아웃을 수정합니다.

  • LineEdit와 ComboBox에서 편집된 텍스트와 분리된 px 등의 단위 접미사를 표시하거나 사용자 지정 후행 위젯을 배치할 수 있습니다.
  • Transfer가 안정적인 키를 사용해 검색 가능한 두 목록 사이에서 항목을 이동하며 비활성화된 항목은 건너뜁니다.
  • TextEdit가 인라인 자동 완성 팝업을 배치할 수 있도록 캐럿 사각형 영역과 변경 시그널을 노출합니다.
  • 선택 또는 모델 업데이트 후 편집 가능한 ComboBox 텍스트 경계와 다양한 디스플레이 배율에서의 NumberBox 드래그 아이콘 중앙 정렬 문제를 수정합니다.

Gallery 예제 앱

인라인 @ 멤버 자동 완성 예제를 추가하고 이전 Qt 버전에서의 리디렉션 클리핑을 수정합니다.

  • TextEdit 멤버 자동 완성 예제에서 @를 입력해 보세요. 방향키로 이름을 선택하면 에디터를 벗어나지 않고 바로 삽입할 수 있습니다.

1.11.2

UILib 컴포넌트 라이브러리

가상 offscreen 및 minimal 창 ID에서는 네이티브 Win32 스타일링과 배경 호출을 건너뜁니다.

Gallery 예제 앱

C++ 및 PySide6 CheckBox 예제에 비활성화 상태를 추가합니다.

1.11.1

UILib 컴포넌트 라이브러리

RangeSlider와 ImageViewer를 추가하고 텍스트 정렬, 오버레이, 소수점 배율 렌더링 문제를 수정합니다.

  • RangeSlider는 최소 간격, 키보드 단계, 값 툴팁 및 접근성을 갖춘 이중 썸으로 하한값과 상한값을 선택합니다.
  • ImageViewer에 포인터 중심 확대/축소, 패닝, 맞춤 모드, 핀치 및 키보드 탐색, 캐시된 썸네일 기능이 추가되었으며 FlipView 내부에서도 동작합니다.
  • 부분 영역 다시 그리기로 소수점 및 100% 미만 배율 아티팩트를 수정하고, GPU 전용 프레임에서 전체 창 위젯 다시 그리기를 방지합니다.
  • 컴팩트 컨트롤 텍스트 정렬, 메뉴 아이콘 여백, SelectorBar 오버플로 포커스, 팝업 배경 캡처 문제를 수정합니다.

Gallery 예제 앱

마이그레이션 필요

50%–200% 인터페이스 배율을 저장하고 컴포넌트 및 예제 검색 결과를 페이지 단위로 불러옵니다. 소스 빌드에는 일치하는 Qt 비공개 헤더가 필요합니다.

1.11.0

UILib 컴포넌트 라이브러리

마이그레이션 필요

파티클 효과를 선택 모듈인 FluentQt::Particles로 분리하고, FontIcon에 사용자 지정 아이콘 폰트를 추가했으며, 안정 ABI 기반 Python wheel을 제공합니다.

  • FontIcon에 사용자 지정 아이콘 폰트를 위한 fontFamily()와 setFontFamily()가 추가되었습니다. 글리프의 유니코드 문자를 직접 전달하거나 폰트 패밀리를 비워 두어 기본 Fluent 아이콘을 사용할 수 있습니다.
  • 파티클 효과가 코어 라이브러리에서 선택적 FluentQt::Particles 타깃 (Python에서는 fluentqt.particles)으로 이동합니다.
  • 데스크톱 Debug 빌드는 기본적으로 Release Qt 런타임을 링크합니다. Debug Qt 라이브러리를 링크하려면 FLUENT_QT_DEBUG_RELEASE_RUNTIME=OFF를 설정하세요.
  • 열린 오버레이가 호스트 표면의 이동을 추적하고, 스크롤바 썸이 히트 테스트 영역과 정렬되며, Python wheel이 CPython 안정 ABI (abi3)를 사용합니다.

ParticleBackdrop이 Particles 모듈로 이동

fluent::layout::ParticleBackdrop과 fluentqt.layout.ParticleBackdrop이 제거되었습니다. FluentQt::FluentQt만 링크하면 더 이상 파티클 효과가 포함되지 않습니다.

소스 빌드에서는 FLUENT_QT_BUILD_PARTICLES를 활성화하거나 COMPONENTS Particles를 요청해 FluentQt::Particles를 링크한 다음 include, 네임스페이스, import를 업데이트하세요.

변경 전
FluentQt::FluentQt
#include <FluentQt/Layout.h>
fluent::layout::ParticleBackdrop
from fluentqt.layout import ParticleBackdrop
변경 후
find_package(FluentQt CONFIG REQUIRED COMPONENTS Particles)
target_link_libraries(app PRIVATE FluentQt::Particles)
#include <FluentQt/Particles.h>
fluent::particles::ParticleBackdrop
from fluentqt.particles import ParticleBackdrop

도입 시점 b674c94

Gallery 예제 앱

3D Gallery는 변경된 텍스처 행만 업로드하고, 움직임이 멈추면 선명한 렌더링을 복원하며, 텍스처 캐시 메모리를 제한하고 프레임 저하가 지속되면 2D로 폴백합니다.

1.10.3

UILib 컴포넌트 라이브러리

숫자 및 속성 편집, 차트 내보내기, 새로운 선택 컨트롤을 추가합니다.

  • NumberBox 값을 직접 입력하는 것뿐만 아니라 드래그로 조절하고 드래그를 취소할 수 있습니다. PropertyPanel은 필드를 그룹화하고 이름으로 찾으며 기본값으로 재설정할 수 있습니다.
  • 차트를 PNG로 저장하거나 표시된 범위 또는 전체 데이터의 원본 행을 CSV로 내보냅니다.
  • AutoSuggestBox가 비동기 제안을 수락하고 오래된 결과는 폐기합니다. 안정적인 ID를 사용하는 태그용 TagInput과 트리 모델에서 선택할 수 있는 TreeSelect가 추가되었습니다.
  • DataGrid에서 열을 고정할 수 있으며 DataGridToolBar에 검색, 필터 및 열 컨트롤이 추가되었습니다.

프로젝트 노트

웹사이트의 각 컴포넌트 페이지는 라이브 예제, C++ 및 PySide6 코드, 공개 API를 영어와 중국어로 제공합니다.

1.10.2

UILib 컴포넌트 라이브러리

CommandPalette, FormController, CodeBlock을 추가합니다. Popup, Dialog, DrawerView는 동일한 배경 블러 및 어둡게 옵션을 공유하며, 모달 표면은 뒤쪽의 클릭과 단축키를 차단합니다.

1.10.1

UILib 컴포넌트 라이브러리

CommandBar와 CommandBarFlyout이 중첩된 FluentMenu 하위 메뉴가 있는 액션을 지원합니다. TextEdit::appendPlainText()는 선택 영역이나 실행 취소 기록을 잃지 않고 로그 줄을 추가합니다. 선택 해제된 체크박스와 라디오 버튼의 윤곽선이 더 선명해졌습니다.

1.10.0

UILib 컴포넌트 라이브러리

DateTimeRangePicker, Widgets 창에 QML 페이지를 호스팅하는 QmlBridge, 확장 종속성·활성화·정리를 담당하는 선택적 Plugins 모듈을 추가합니다.

Gallery 예제 앱

Python Live Scene이 동일한 창에서 미리보기를 다시 로드합니다.

1.9.3

UILib 컴포넌트 라이브러리

시작 시와 재질 변경 중의 창 배경 문제를 수정합니다. 다크 모드에서 새 창이 더 이상 흰색으로 깜빡이지 않으며, Mica 또는 Acrylic에서 전환할 때 새 배경이 그려질 때까지 기존 재질을 유지합니다.

1.9.1

UILib 컴포넌트 라이브러리

Python wheel에 1.9.0에서 누락되었던 선택적 Spatial 모듈이 포함됩니다.

Gallery 예제 앱

패키징된 3D Gallery는 Windows ARM64에서 Direct3D 11을 사용하며 하드웨어 가속을 사용할 수 없으면 2D로 폴백합니다.

  • 1.9.0 wheel에는 Spatial이 제외되어 있었습니다. 3D Gallery를 사용하려면 FluentQt와 FluentQt-Gallery를 모두 1.9.1로 업그레이드하세요.

1.9.0

UILib 컴포넌트 라이브러리

선택적 Spatial 모듈을 추가합니다. SpatialView는 일반 위젯을 원근감이 적용된 3D 표면에 배치하며 기존 입력 처리와 시그널이 그대로 동작합니다.

Gallery 예제 앱

데스크톱 및 브라우저 Gallery에 3D 모드를 추가합니다.

1.8.5

UILib 컴포넌트 라이브러리

Qt Charts 종속성 없이 Qt Widgets로 그린 Charts 모듈 (꺾은선, 영역, 막대, 원형, 도넛, 분산형, 스파크라인)과 FileDropZone, FileListView를 추가합니다. Toast에 새 카드 스타일과 선택적 닫기 버튼이 적용됩니다.

1.8.4

UILib 컴포넌트 라이브러리

SplashScreen이 표시 애니메이션 동안 다시 그리는 횟수를 줄였습니다.

Gallery 예제 앱

앱 아이콘, 설치 프로그램 아트워크 및 웹사이트 스크린샷을 업데이트합니다.

1.8.3

UILib 컴포넌트 라이브러리

CPU로 그리는 파티클 배경인 ParticleBackdrop과 재사용 가능한 SplashScreen을 추가합니다. 키보드 선택 및 텍스트 편집 문제를 수정합니다.

Gallery 예제 앱

예제 소스를 더 쉽게 읽고 복사할 수 있도록 개선합니다.

1.8.2

UILib 컴포넌트 라이브러리

UserTheme::applyOverrides()는 앱 전체의 색상, 모서리 반경 및 폰트를 변경하며, setThemeOverrides()는 단일 컴포넌트에 동일하게 적용됩니다. ComboBox 드롭다운에서도 이제 사용자 지정 폰트를 사용합니다. 또한 지원되는 Qt 버전에서 콜백, 탐색 및 슬라이더 버그를 수정했습니다.

1.8.1

UILib 컴포넌트 라이브러리

ToggleSwitch::visualScale을 추가합니다. 컬렉션 뷰의 입력 시그널, 행 제거 후 FlowView 레이아웃, 위젯을 삭제하는 NumberBox 콜백 문제를 수정합니다.

1.8.0

UILib 컴포넌트 라이브러리

HighContrast 테마와 앱 전체 MotionPolicy 모드 (Full, Reduced, Disabled)를 추가합니다. 포커스를 받은 TextEdit는 자동 높이 변경 시 애니메이션을 적용합니다.

Gallery 예제 앱

C++, PySide6 및 브라우저 Gallery에 고대비 테마와 모션 설정을 추가합니다.

1.7.5

UILib 컴포넌트 라이브러리

버튼, 토글 스위치, 날짜/시간 선택기가 fontRole 규칙을 공유하며 명시적 setFont() 호출이 우선 적용됩니다. build-fluentqt-gui Skill은 프로젝트 분석부터 독립 리뷰까지 다룹니다.

Gallery 예제 앱

C++, PySide6 및 WebAssembly 전반의 샘플 동작을 통일합니다.

1.7.4

UILib 컴포넌트 라이브러리

메뉴 애니메이션 중에도 메뉴 액세스 키가 계속 동작합니다.

Gallery 예제 앱

네이티브 미리보기가 캡처 전에 포인터 및 키보드 동작을 재생하고 위젯 지오메트리와 Inspector 검사 결과를 보고합니다.

1.7.3

UILib 컴포넌트 라이브러리

CalendarView 선택 윤곽선이 둥글게 변경되고, 선택기 플라이아웃이 입력 필드에 맞춰 정렬되며, TeachingTip 그림자가 고르게 퍼집니다.

Gallery 예제 앱

Live Scene은 PySide6 미리보기 창을 열어 두고 저장 시 자동으로 새로 고칩니다.

1.7.2

UILib 컴포넌트 라이브러리

MultiSelectComboBox와 로컬 Qt 설정을 확인하고 C++ 또는 PySide6 시작 프로젝트를 생성하는 fluentqt doctor, create, trial 명령을 추가합니다. 여러 플랫폼의 선택기 및 목록 문제도 수정합니다.

1.7.0

UILib 컴포넌트 라이브러리

마이그레이션 필요

Material 및 Cupertino 디자인 언어를 제거하고 Fluent만 유지합니다. Field와 DataGrid를 추가하고 모든 오버레이의 열기, 닫기 및 모달 동작을 문서화했습니다.

디자인 언어 및 스타일 테마 API 제거

DesignLanguage, StyleTheme 및 StyleThemeCatalog가 별칭 없이 완전히 제거되었습니다. Fluent 라이트 및 다크 테마만 사용한 앱은 영향을 받지 않습니다.

Theme으로 테마 모양을 선택하고 UserTheme으로 토큰을 사용자 지정합니다. Python에서는 current_theme(), apply_user_theme(), set_accent_color(), reset_theme_tokens()를 사용합니다. Gallery는 이전 styleTheme 설정을 무시합니다.

변경 전
FluentElement::DesignLanguage
StyleTheme / StyleThemeCatalog
current_design_language()
apply_style_theme()
변경 후
FluentElement::Theme
fluent::UserTheme
current_theme()
apply_user_theme()

1.6.4

UILib 컴포넌트 라이브러리

TextEdit가 사용자 지정 콘텐츠 여백을 준수합니다. build-fluentqt-gui Skill이 앱 규모에 맞춰 검사 항목을 조정합니다.

Gallery 예제 앱

브라우저 코드 샘플에서 C++와 PySide6 간에 전환할 수 있습니다.

1.6.3

UILib 컴포넌트 라이브러리

코딩 에이전트용 build-fluentqt-gui Skill과 C++ 및 PySide6 API를 Gallery 샘플에 매핑하는 컴포넌트 카탈로그를 제공합니다. ListView에 기본 델리게이트가 추가되었으며 설치된 패키지에 더 이상 빌드 머신의 SDK 경로가 포함되지 않습니다.

1.6.2

UILib 컴포넌트 라이브러리

FLUENT_QT_BUILD_WEBASSEMBLY_SUPPORT를 통한 선택적 WebAssembly 지원을 추가합니다.

Gallery 예제 앱

브라우저에서 사용할 수 있도록 웹사이트에 C++ Gallery를 임베드합니다.

1.6.1

UILib 컴포넌트 라이브러리

FluentQt PyPI 페이지에 전체 패키지 문서와 프로젝트 링크를 추가합니다.

Gallery 예제 앱

FluentQt-Gallery PyPI 페이지에 전체 패키지 문서와 프로젝트 링크를 추가합니다.

1.5.3

UILib 컴포넌트 라이브러리

버튼을 눌렀을 때 하단 테두리가 가려지지 않습니다. macOS에서 Qt가 트랙패드 이벤트를 놓칠 경우 사용자 지정 제목 표시줄이 네이티브 창 드래그로 폴백합니다.

1.5.2

UILib 컴포넌트 라이브러리

실행 취소, 복사, 붙여넣기 등 관련 작업을 처리하는 CommandBar, CommandBarFlyout, EditingCommandRouter를 추가합니다. Toast에는 작업 버튼, 마우스 오버 시 일시 정지, 제자리 업데이트가 추가됩니다.

1.5.1

UILib 컴포넌트 라이브러리

Card, Divider, Expander, Accordion, FontIcon, CompoundButton, Avatar 및 Toast를 공개하여 애플리케이션에서도 Gallery와 동일한 컨트롤을 사용할 수 있습니다.

1.5.0

UILib 컴포넌트 라이브러리

마이그레이션 필요

<FluentQt/BasicInput.h> 같은 카테고리별 헤더, 강타입 글꼴 역할과 선택 모드, 호스팅된 위젯의 명시적 소유권을 추가합니다. 이제 선택기와 스위치의 현지화된 텍스트는 애플리케이션에서 직접 제공합니다.

타입이 지정된 폰트 역할, 공통 선택 모드 및 명시적 소유권

글꼴 역할을 문자열로 전달하거나, 뷰별 선택 열거형을 사용하거나, 구현 헤더를 포함하거나, 호스팅된 위젯의 암시적 소유권에 의존하는 코드는 수정해야 합니다.

공개 헤더만 포함하고 API가 요구하는 곳에 WidgetOwnership을 전달하세요. 선택기 텍스트, ToggleSwitch 레이블, 접근성 이름은 애플리케이션에서 현지화해 제공해야 합니다.

변경 전
"Body"
FlowSelectionMode / GridSelectionMode
ListSelectionMode / TreeSelectionMode
변경 후
Typography::FontRole::Body
fluent::collections::SelectionMode
fluent::WidgetOwnership

1.4.2

UILib 컴포넌트 라이브러리

AnchorLayout의 오른쪽 및 아래쪽 앵커, QMLPlus 상태 전환, QApplication 생성 전 내장 리소스 접근 문제를 수정합니다. TextEdit는 포커스를 올바르게 전달하고 텍스트를 다시 설정해도 실행 취소 기록을 유지합니다.

1.4.1

UILib 컴포넌트 라이브러리

최대 300%의 소수점 디스플레이 배율에서도 컨트롤이 선명하게 유지됩니다. Dialog와 CoachMark가 별도의 네이티브 창 대신 소유 창 내부의 오버레이로 열려 macOS에서 입력이 멈추는 문제를 수정합니다.

1.4.0

UILib 컴포넌트 라이브러리

글꼴과 Fluent System Icons를 내장하여 시스템의 Segoe 설치 종속성을 제거합니다.

Gallery 예제 앱

타이포그래피, 색상, 아이콘, 간격 페이지를 추가하고 시스템 디스플레이 배율을 따릅니다.

1.3.2

날짜 기록 없음

UILib 컴포넌트 라이브러리

설치된 패키지는 명시적으로 나열된 공개 헤더 목록만 노출합니다.

Gallery 예제 앱

컴포넌트 페이지에 헤더, C++ 타입, CMake 타깃이 표시되며 페이지 전환 속도가 빨라졌습니다.

1.3.1

날짜 기록 없음

UILib 컴포넌트 라이브러리

라이브러리는 Qt Widgets에만 의존합니다. 릴리스에는 라이브러리 전용 소스 아카이브가 포함됩니다.

Gallery 예제 앱

Gallery에 spdlog를 유지하고 패키지에서 사용하지 않는 Qt 모듈을 제거합니다.

1.3.0

날짜 기록 없음

UILib 컴포넌트 라이브러리

x64 및 ARM64 아키텍처의 X11과 Wayland용 Linux 지원 및 Debian 패키지를 추가합니다. Window::setBackdropEffect()는 모든 플랫폼에서 단일 Mica/Acrylic API를 제공합니다.