미출시
1.12.1 이후 아직 출시되지 않은 공개 변경 사항이 없습니다.
프로젝트 업데이트
버전별로 정리된 UILib 및 Gallery 업데이트와 마이그레이션 안내입니다.
일치하는 항목이 없습니다. 다른 키워드를 입력하거나 필터를 초기화하세요.
1.12.1 이후 아직 출시되지 않은 공개 변경 사항이 없습니다.
PropertyPanel은 행이 화면에 가까워지면 편집기를 만듭니다. AreaChart는 포인터를 움직일 때 이미 그린 채움 영역을 재사용합니다.
What’s new 대화 상자를 스크롤해도 구분선 너머로 배경이 비치지 않습니다. 사진 예제는 필요할 때 이미지를 불러옵니다.
웹사이트, 컴포넌트 API 문서, 대화형 속성 편집기를 9개 언어로 이용할 수 있습니다.
버튼 아이콘과 레이블을 위아래로 배치하고, 트리 열 머리글을 표시하며, 최대화된 창을 의도한 모니터에 복원합니다.
Button::IconAbove 또는 Button::IconBelow를 사용하여 아이콘을 레이블 위나 아래에 배치할 수 있습니다.TreeView가 표시된 열 머리글을 위한 공간을 확보합니다. 캡션과 열 머리글이 모두 숨겨진 경우 headerlessTopInset으로 첫 번째 행의 상단 간격을 조정할 수 있습니다.Window를 복원할 때 대상 모니터의 작업 영역을 사용합니다.오프라인으로 릴리스 노트를 읽고 트리 열 머리글 예제를 사용해 볼 수 있습니다.
TreeView 예제에서 모델 머리글이 첫 번째 행 위에 표시되는 방식을 확인할 수 있습니다.99개 컴포넌트 문서 페이지에서 라이브 Qt 예제를 편집하고 결과 C++ 또는 PySide6 코드를 복사할 수 있습니다.
진단 보고서, Windows 11 Snap Layouts 및 공통 텍스트 필드 프레임 설정을 추가합니다.
DiagnosticSession이 최근 UI 이벤트와 위젯 스냅샷을 메모리 내 ZIP 아카이브로 기록합니다.Window의 최대화 버튼에 마우스 오버하면 Windows 11 Snap Layouts를 사용할 수 있습니다.LineEdit 프레임 설정을 공유합니다. 포커스가 없을 때의 밑줄 기본 너비는 0이며, 너비가 0인 테두리는 더 이상 가는 선을 그리지 않습니다.Toast의 액션 위젯 소유권과 좁은 창에서의 레이아웃을 수정했습니다.최근 진단 정보가 담긴 ZIP 파일로 Gallery 문제를 보고할 수 있습니다.
웹사이트 릴리스 내역에서 UILib와 Gallery 업데이트를 분리하고, 범위 필터와 고정 버전 및 마이그레이션 링크를 제공합니다.
Transfer, LineEdit 및 ComboBox의 단위 접미사와 후행 위젯, TextEdit 캐럿 위치 정보를 추가하고 편집 가능한 필드 레이아웃을 수정합니다.
LineEdit와 ComboBox에서 편집된 텍스트와 분리된 px 등의 단위 접미사를 표시하거나 사용자 지정 후행 위젯을 배치할 수 있습니다.Transfer가 안정적인 키를 사용해 검색 가능한 두 목록 사이에서 항목을 이동하며 비활성화된 항목은 건너뜁니다.TextEdit가 인라인 자동 완성 팝업을 배치할 수 있도록 캐럿 사각형 영역과 변경 시그널을 노출합니다.ComboBox 텍스트 경계와 다양한 디스플레이 배율에서의 NumberBox 드래그 아이콘 중앙 정렬 문제를 수정합니다.인라인 @ 멤버 자동 완성 예제를 추가하고 이전 Qt 버전에서의 리디렉션 클리핑을 수정합니다.
TextEdit 멤버 자동 완성 예제에서 @를 입력해 보세요. 방향키로 이름을 선택하면 에디터를 벗어나지 않고 바로 삽입할 수 있습니다.가상 offscreen 및 minimal 창 ID에서는 네이티브 Win32 스타일링과 배경 호출을 건너뜁니다.
C++ 및 PySide6 CheckBox 예제에 비활성화 상태를 추가합니다.
RangeSlider와 ImageViewer를 추가하고 텍스트 정렬, 오버레이, 소수점 배율 렌더링 문제를 수정합니다.
RangeSlider는 최소 간격, 키보드 단계, 값 툴팁 및 접근성을 갖춘 이중 썸으로 하한값과 상한값을 선택합니다.ImageViewer에 포인터 중심 확대/축소, 패닝, 맞춤 모드, 핀치 및 키보드 탐색, 캐시된 썸네일 기능이 추가되었으며 FlipView 내부에서도 동작합니다.SelectorBar 오버플로 포커스, 팝업 배경 캡처 문제를 수정합니다.50%–200% 인터페이스 배율을 저장하고 컴포넌트 및 예제 검색 결과를 페이지 단위로 불러옵니다. 소스 빌드에는 일치하는 Qt 비공개 헤더가 필요합니다.
소스에서 C++ 또는 PySide6 데스크톱 Gallery를 빌드할 때 일치하는 Qt 프라이빗 헤더가 없으면 CMake 구성 단계에서 실패합니다. FluentQt 라이브러리만 사용하는 프로젝트는 영향을 받지 않습니다.
사용 중인 Qt 키트에 맞는 qtbase5-private-dev 또는 qt6-base-private-dev를 설치하거나, 라이브러리 전용 빌드에서는 두 Gallery 빌드 옵션을 모두 비활성화하세요.
Desktop Gallery with public Qt development headers only# Debian / Ubuntu, matching the selected Qt version:
sudo apt install qtbase5-private-dev
# or:
sudo apt install qt6-base-private-dev
# Library-only alternative:
-DFLUENT_QT_BUILD_GALLERY=OFF -DFLUENT_QT_BUILD_PYSIDE6_GALLERY=OFF파티클 효과를 선택 모듈인 FluentQt::Particles로 분리하고, FontIcon에 사용자 지정 아이콘 폰트를 추가했으며, 안정 ABI 기반 Python wheel을 제공합니다.
FontIcon에 사용자 지정 아이콘 폰트를 위한 fontFamily()와 setFontFamily()가 추가되었습니다. 글리프의 유니코드 문자를 직접 전달하거나 폰트 패밀리를 비워 두어 기본 Fluent 아이콘을 사용할 수 있습니다.FluentQt::Particles 타깃 (Python에서는 fluentqt.particles)으로 이동합니다.FLUENT_QT_DEBUG_RELEASE_RUNTIME=OFF를 설정하세요.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 ParticleBackdropfind_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
3D Gallery는 변경된 텍스처 행만 업로드하고, 움직임이 멈추면 선명한 렌더링을 복원하며, 텍스처 캐시 메모리를 제한하고 프레임 저하가 지속되면 2D로 폴백합니다.
숫자 및 속성 편집, 차트 내보내기, 새로운 선택 컨트롤을 추가합니다.
NumberBox 값을 직접 입력하는 것뿐만 아니라 드래그로 조절하고 드래그를 취소할 수 있습니다. PropertyPanel은 필드를 그룹화하고 이름으로 찾으며 기본값으로 재설정할 수 있습니다.AutoSuggestBox가 비동기 제안을 수락하고 오래된 결과는 폐기합니다. 안정적인 ID를 사용하는 태그용 TagInput과 트리 모델에서 선택할 수 있는 TreeSelect가 추가되었습니다.DataGrid에서 열을 고정할 수 있으며 DataGridToolBar에 검색, 필터 및 열 컨트롤이 추가되었습니다.웹사이트의 각 컴포넌트 페이지는 라이브 예제, C++ 및 PySide6 코드, 공개 API를 영어와 중국어로 제공합니다.
CommandPalette, FormController, CodeBlock을 추가합니다. Popup, Dialog, DrawerView는 동일한 배경 블러 및 어둡게 옵션을 공유하며, 모달 표면은 뒤쪽의 클릭과 단축키를 차단합니다.
CommandBar와 CommandBarFlyout이 중첩된 FluentMenu 하위 메뉴가 있는 액션을 지원합니다. TextEdit::appendPlainText()는 선택 영역이나 실행 취소 기록을 잃지 않고 로그 줄을 추가합니다. 선택 해제된 체크박스와 라디오 버튼의 윤곽선이 더 선명해졌습니다.
DateTimeRangePicker, Widgets 창에 QML 페이지를 호스팅하는 QmlBridge, 확장 종속성·활성화·정리를 담당하는 선택적 Plugins 모듈을 추가합니다.
Python Live Scene이 동일한 창에서 미리보기를 다시 로드합니다.
시작 시와 재질 변경 중의 창 배경 문제를 수정합니다. 다크 모드에서 새 창이 더 이상 흰색으로 깜빡이지 않으며, Mica 또는 Acrylic에서 전환할 때 새 배경이 그려질 때까지 기존 재질을 유지합니다.
Timeline과 Stepper를 추가합니다.
100% 이외의 디스플레이 배율에서 이미지와 텍스트가 더 선명하게 표시됩니다.
Python wheel에 1.9.0에서 누락되었던 선택적 Spatial 모듈이 포함됩니다.
패키징된 3D Gallery는 Windows ARM64에서 Direct3D 11을 사용하며 하드웨어 가속을 사용할 수 없으면 2D로 폴백합니다.
FluentQt와 FluentQt-Gallery를 모두 1.9.1로 업그레이드하세요.선택적 Spatial 모듈을 추가합니다. SpatialView는 일반 위젯을 원근감이 적용된 3D 표면에 배치하며 기존 입력 처리와 시그널이 그대로 동작합니다.
데스크톱 및 브라우저 Gallery에 3D 모드를 추가합니다.
Qt Charts 종속성 없이 Qt Widgets로 그린 Charts 모듈 (꺾은선, 영역, 막대, 원형, 도넛, 분산형, 스파크라인)과 FileDropZone, FileListView를 추가합니다. Toast에 새 카드 스타일과 선택적 닫기 버튼이 적용됩니다.
SplashScreen이 표시 애니메이션 동안 다시 그리는 횟수를 줄였습니다.
앱 아이콘, 설치 프로그램 아트워크 및 웹사이트 스크린샷을 업데이트합니다.
CPU로 그리는 파티클 배경인 ParticleBackdrop과 재사용 가능한 SplashScreen을 추가합니다. 키보드 선택 및 텍스트 편집 문제를 수정합니다.
예제 소스를 더 쉽게 읽고 복사할 수 있도록 개선합니다.
UserTheme::applyOverrides()는 앱 전체의 색상, 모서리 반경 및 폰트를 변경하며, setThemeOverrides()는 단일 컴포넌트에 동일하게 적용됩니다. ComboBox 드롭다운에서도 이제 사용자 지정 폰트를 사용합니다. 또한 지원되는 Qt 버전에서 콜백, 탐색 및 슬라이더 버그를 수정했습니다.
ToggleSwitch::visualScale을 추가합니다. 컬렉션 뷰의 입력 시그널, 행 제거 후 FlowView 레이아웃, 위젯을 삭제하는 NumberBox 콜백 문제를 수정합니다.
HighContrast 테마와 앱 전체 MotionPolicy 모드 (Full, Reduced, Disabled)를 추가합니다. 포커스를 받은 TextEdit는 자동 높이 변경 시 애니메이션을 적용합니다.
C++, PySide6 및 브라우저 Gallery에 고대비 테마와 모션 설정을 추가합니다.
MultiSelectComboBox가 선택된 레이블을 번역된 접속사 대신 、로 연결하며, 아이콘 전용 TabView 버튼에 접근성 이름이 노출됩니다.
버튼, 토글 스위치, 날짜/시간 선택기가 fontRole 규칙을 공유하며 명시적 setFont() 호출이 우선 적용됩니다. build-fluentqt-gui Skill은 프로젝트 분석부터 독립 리뷰까지 다룹니다.
C++, PySide6 및 WebAssembly 전반의 샘플 동작을 통일합니다.
메뉴 애니메이션 중에도 메뉴 액세스 키가 계속 동작합니다.
네이티브 미리보기가 캡처 전에 포인터 및 키보드 동작을 재생하고 위젯 지오메트리와 Inspector 검사 결과를 보고합니다.
CalendarView 선택 윤곽선이 둥글게 변경되고, 선택기 플라이아웃이 입력 필드에 맞춰 정렬되며, TeachingTip 그림자가 고르게 퍼집니다.
Live Scene은 PySide6 미리보기 창을 열어 두고 저장 시 자동으로 새로 고칩니다.
MultiSelectComboBox와 로컬 Qt 설정을 확인하고 C++ 또는 PySide6 시작 프로젝트를 생성하는 fluentqt doctor, create, trial 명령을 추가합니다. 여러 플랫폼의 선택기 및 목록 문제도 수정합니다.
영문 및 중문 홈페이지를 분리하고 GitHub Discussions 질문 및 제안 양식을 추가합니다.
Material 및 Cupertino 디자인 언어를 제거하고 Fluent만 유지합니다. Field와 DataGrid를 추가하고 모든 오버레이의 열기, 닫기 및 모달 동작을 문서화했습니다.
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()TextEdit가 사용자 지정 콘텐츠 여백을 준수합니다. build-fluentqt-gui Skill이 앱 규모에 맞춰 검사 항목을 조정합니다.
브라우저 코드 샘플에서 C++와 PySide6 간에 전환할 수 있습니다.
코딩 에이전트용 build-fluentqt-gui Skill과 C++ 및 PySide6 API를 Gallery 샘플에 매핑하는 컴포넌트 카탈로그를 제공합니다. ListView에 기본 델리게이트가 추가되었으며 설치된 패키지에 더 이상 빌드 머신의 SDK 경로가 포함되지 않습니다.
FLUENT_QT_BUILD_WEBASSEMBLY_SUPPORT를 통한 선택적 WebAssembly 지원을 추가합니다.
브라우저에서 사용할 수 있도록 웹사이트에 C++ Gallery를 임베드합니다.
FluentQt PyPI 페이지에 전체 패키지 문서와 프로젝트 링크를 추가합니다.
FluentQt-Gallery PyPI 페이지에 전체 패키지 문서와 프로젝트 링크를 추가합니다.
FluentQt wheel에 PySide6 바인딩을 도입합니다.
별도로 설치할 수 있는 FluentQt-Gallery Python 패키지를 제공합니다.
버튼을 눌렀을 때 하단 테두리가 가려지지 않습니다. macOS에서 Qt가 트랙패드 이벤트를 놓칠 경우 사용자 지정 제목 표시줄이 네이티브 창 드래그로 폴백합니다.
실행 취소, 복사, 붙여넣기 등 관련 작업을 처리하는 CommandBar, CommandBarFlyout, EditingCommandRouter를 추가합니다. Toast에는 작업 버튼, 마우스 오버 시 일시 정지, 제자리 업데이트가 추가됩니다.
Card, Divider, Expander, Accordion, FontIcon, CompoundButton, Avatar 및 Toast를 공개하여 애플리케이션에서도 Gallery와 동일한 컨트롤을 사용할 수 있습니다.
<FluentQt/BasicInput.h> 같은 카테고리별 헤더, 강타입 글꼴 역할과 선택 모드, 호스팅된 위젯의 명시적 소유권을 추가합니다. 이제 선택기와 스위치의 현지화된 텍스트는 애플리케이션에서 직접 제공합니다.
글꼴 역할을 문자열로 전달하거나, 뷰별 선택 열거형을 사용하거나, 구현 헤더를 포함하거나, 호스팅된 위젯의 암시적 소유권에 의존하는 코드는 수정해야 합니다.
공개 헤더만 포함하고 API가 요구하는 곳에 WidgetOwnership을 전달하세요. 선택기 텍스트, ToggleSwitch 레이블, 접근성 이름은 애플리케이션에서 현지화해 제공해야 합니다.
"Body"
FlowSelectionMode / GridSelectionMode
ListSelectionMode / TreeSelectionModeTypography::FontRole::Body
fluent::collections::SelectionMode
fluent::WidgetOwnershipAnchorLayout의 오른쪽 및 아래쪽 앵커, QMLPlus 상태 전환, QApplication 생성 전 내장 리소스 접근 문제를 수정합니다. TextEdit는 포커스를 올바르게 전달하고 텍스트를 다시 설정해도 실행 취소 기록을 유지합니다.
최대 300%의 소수점 디스플레이 배율에서도 컨트롤이 선명하게 유지됩니다. Dialog와 CoachMark가 별도의 네이티브 창 대신 소유 창 내부의 오버레이로 열려 macOS에서 입력이 멈추는 문제를 수정합니다.
글꼴과 Fluent System Icons를 내장하여 시스템의 Segoe 설치 종속성을 제거합니다.
타이포그래피, 색상, 아이콘, 간격 페이지를 추가하고 시스템 디스플레이 배율을 따릅니다.
설치된 패키지는 명시적으로 나열된 공개 헤더 목록만 노출합니다.
컴포넌트 페이지에 헤더, C++ 타입, CMake 타깃이 표시되며 페이지 전환 속도가 빨라졌습니다.
라이브러리는 Qt Widgets에만 의존합니다. 릴리스에는 라이브러리 전용 소스 아카이브가 포함됩니다.
Gallery에 spdlog를 유지하고 패키지에서 사용하지 않는 Qt 모듈을 제거합니다.
x64 및 ARM64 아키텍처의 X11과 Wayland용 Linux 지원 및 Debian 패키지를 추가합니다. Window::setBackdropEffect()는 모든 플랫폼에서 단일 Mica/Acrylic API를 제공합니다.