開發中
1.12.1 發布後尚無未發布的公開變更。
專案更新
依元件庫(UILib)與 Gallery 分類檢視各版本更新內容與升級說明。
沒有符合條件的記錄。請嘗試其他關鍵字,或清除篩選。
1.12.1 發布後尚無未發布的公開變更。
PropertyPanel 會在資料列即將進入畫面時建立編輯器。游標在 AreaChart 上移動時會重用已繪製的填色區域。
捲動 What’s new 對話框時,分隔線不再透出底層內容。相片範例會按需載入圖片。
官網、元件 API 文件和互動範例的屬性編輯器現已支援九種語言。
按鈕支援上下堆疊圖示與標籤,顯示樹狀檢視欄標頭,並於目標顯示器上還原最大化視窗。
Button::IconAbove 或 Button::IconBelow 將圖示放在標籤上方或下方。TreeView 會為可見的欄標頭預留空間。當標題與欄標頭皆隱藏時,可使用 headerlessTopInset 調整首列上方的間距。Window 時,會依目標顯示器的工作區定位內容。可離線閱讀版本資訊,也可在樹狀檢視範例中試用欄標頭。
TreeView 範例展示了模型欄標頭顯示在首列上方的效果。可在 99 個元件文件頁面中即時編輯 Qt 範例,並複製產生的 C++ 或 PySide6 程式碼。
新增診斷報告、Windows 11 貼齊版面配置與共用的文字欄位框線設定。
DiagnosticSession 會將近期的 UI 事件與控制項快照記錄至記憶體內的 ZIP 壓縮檔。Window 最大化按鈕上,即可使用 Windows 11 貼齊版面配置。LineEdit 邊框設定。未聚焦時底線預設為零寬度,邊框寬度為零時也不再繪製細線。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 支援自訂圖示字型,Python wheel 改用穩定 ABI。
FontIcon 新增 fontFamily() 與 setFontFamily() 以支援自訂圖示字型。請直接傳入字形的 Unicode 字元,或將字型家族留空以使用內建 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,接著更新標頭檔引入、命名空間與匯入路徑。
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,以取得 3D Gallery。新增選用的 Spatial 模組。SpatialView 可將一般控制項置於具備透視效果的 3D 表面上,且原有的輸入處理與訊號皆正常運作。
桌面版與瀏覽器版 Gallery 新增 3D 模式。
新增圖表模組(折線圖、面積圖、長條圖、圓餅圖、環圈圖、散佈圖與走勢圖),以 Qt Widgets 繪製且不依賴 Qt Charts;另新增 FileDropZone 與 FileListView。Toast 採用全新卡片樣式並提供選用關閉按鈕。
SplashScreen 在顯示動畫期間的重繪次數減少。
更新應用程式圖示、安裝程式圖片與官網螢幕擷取畫面。
新增 ParticleBackdrop(以 CPU 繪製的粒子背景)與可重複使用的 SplashScreen,並修正鍵盤選取與文字編輯問題。
範例原始碼更方便閱讀與複製。
UserTheme::applyOverrides() 可全域修改整個應用程式的色彩、圓角半徑與字型,setThemeOverrides() 則針對單一元件執行相同設定。ComboBox 下拉式清單現已支援自訂字型,並修正了支援之 Qt 版本上的回呼、導覽與滑桿錯誤。
新增 ToggleSwitch::visualScale。修正集合檢視的輸入訊號、移除列後 FlowView 的版面配置,以及 NumberBox 回呼中刪除控制項導致的問題。
新增 HighContrast 主題與應用程式全域 MotionPolicy 模式(Full、Reduced、Disabled)。TextEdit 取得焦點時,自動高度變化會呈現動畫效果。
C++、PySide6 與瀏覽器版 Gallery 新增高對比與動態效果設定。
MultiSelectComboBox 改用 、 連接已選取標籤,不再使用翻譯後的「and」連接詞;僅含圖示的 TabView 按鈕亦提供無障礙名稱。
按鈕、切換開關與日期/時間選擇器共用 fontRole 規則,明確呼叫 setFont() 仍具有最高優先權。build-fluentqt-gui Skill 涵蓋從專案分析到獨立審查的完整流程。
統一 C++、PySide6 與 WebAssembly 範例的行為。
功能表動畫播放期間,存取鍵仍可正常使用。
原生預覽支援在擷圖前回放滑鼠與鍵盤操作,並輸出控制項幾何資訊與 Inspector 檢查結果。
CalendarView 選取外框改為圓角,選擇器浮出視窗與欄位對齊,TeachingTip 陰影均勻擴散。
Live Scene 會保持 PySide6 預覽視窗開啟,並於存檔時自動重新整理。
新增 MultiSelectComboBox,以及 fluentqt doctor、create 與 trial 指令,可檢查本機 Qt 環境並建立 C++ 或 PySide6 入門專案;同時修正跨平台選擇器與清單的多項問題。
新增獨立的中英文首頁,並於 GitHub Discussions 加入提問與提案表單。
移除 Material 與 Cupertino 設計語言,僅保留 Fluent。新增 Field 與 DataGrid,並說明所有浮層的開啟、關閉與模態行為。
DesignLanguage、StyleTheme 與 StyleThemeCatalog 已移除且不保留別名。僅使用 Fluent 淺色與深色主題的應用程式不受影響。
使用 Theme 選擇外觀並透過 UserTheme 自訂 token。在 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::WidgetOwnership修正 AnchorLayout 右側與底部錨點、QMLPlus 狀態轉換,以及在 QApplication 建立前存取內建資源的問題。TextEdit 能正確轉移焦點,並在重新設定文字時保留復原紀錄。
控制項在最高 300% 的非整數顯示縮放比例下依然保持銳利。Dialog 與 CoachMark 改於所屬視窗內以覆疊層開啟,而非獨立的原生視窗,藉此修正 macOS 上輸入凍結的問題。
內建字型與 Fluent System Icons,移除對系統安裝 Segoe 的依賴。
新增排版、色彩、圖示與間距頁面,並跟隨系統顯示縮放比例。
安裝套件僅公開明確列出的公開標頭檔清單。
元件頁面顯示標頭檔、C++ 型別與 CMake 目標,且頁面切換速度更快。
程式庫僅依賴 Qt Widgets,發行版提供僅含程式庫的原始碼壓縮檔。
將 spdlog 保留於 Gallery 中,並從其安裝套件移除未使用的 Qt 模組。
新增 x64 與 ARM64 架構的 Linux 支援(涵蓋 X11 與 Wayland),並提供 Debian 安裝套件。Window::setBackdropEffect() 在所有平台上提供統一的 Mica/Acrylic API。