Fluent-Qt

專案更新

版本紀錄與遷移

依元件庫(UILib)與 Gallery 分類檢視各版本更新內容與升級說明。

1.12.1

最新版本

元件庫 UILib

PropertyPanel 會在資料列即將進入畫面時建立編輯器。游標在 AreaChart 上移動時會重用已繪製的填色區域。

Gallery 範例應用

捲動 What’s new 對話框時,分隔線不再透出底層內容。相片範例會按需載入圖片。

專案說明

官網、元件 API 文件和互動範例的屬性編輯器現已支援九種語言。

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 貼齊版面配置與共用的文字欄位框線設定。

  • DiagnosticSession 會將近期的 UI 事件與控制項快照記錄至記憶體內的 ZIP 壓縮檔。
  • 將滑鼠懸停於可調整大小的 Window 最大化按鈕上,即可使用 Windows 11 貼齊版面配置。
  • 文字欄位共用 LineEdit 邊框設定。未聚焦時底線預設為零寬度,邊框寬度為零時也不再繪製細線。
  • 修正 Toast 動作控制項的所有權與窄視窗版面配置。

Gallery 範例應用

透過近期診斷資訊的 ZIP 壓縮檔回報 Gallery 問題。

  • 選擇「設定」旁的「回報問題」可複製診斷 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.1

元件庫 UILib

新增 RangeSlider 與 ImageViewer,並修正文字對齊、覆疊層與非整數倍率繪製問題。

  • RangeSlider 支援上下限雙滑塊選取、最小間距、鍵盤步長、數值提示與無障礙支援。
  • ImageViewer 支援以指標為中心縮放、平移、適應檢視區模式、雙指縮放與鍵盤導覽以及縮圖快取,亦可嵌入 FlipView 中。
  • 透過局部區域重繪修正非整數及低於 100% 縮放比例下的畫面殘影,並在純 GPU 影格中避免觸發整個視窗的控制項重繪。
  • 修正精簡控制項文字對齊、功能表圖示內距、SelectorBar 溢位項目焦點,以及彈出視窗背景擷取問題。

Gallery 範例應用

需要遷移

支援儲存 50%–200% 介面縮放,元件與範例搜尋改為分頁載入。原始碼建置需要對應的 Qt 私有標頭檔。

1.11.0

元件庫 UILib

需要遷移

將粒子特效拆分為可選模組 FluentQt::Particles,FontIcon 支援自訂圖示字型,Python wheel 改用穩定 ABI。

  • FontIcon 新增 fontFamily() 與 setFontFamily() 以支援自訂圖示字型。請直接傳入字形的 Unicode 字元,或將字型家族留空以使用內建 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,接著更新標頭檔引入、命名空間與匯入路徑。

舊寫法
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。請將 FluentQt 與 FluentQt-Gallery 一併升級至 1.9.1,以取得 3D Gallery。

1.9.0

元件庫 UILib

新增選用的 Spatial 模組。SpatialView 可將一般控制項置於具備透視效果的 3D 表面上,且原有的輸入處理與訊號皆正常運作。

Gallery 範例應用

桌面版與瀏覽器版 Gallery 新增 3D 模式。

1.8.5

元件庫 UILib

新增圖表模組(折線圖、面積圖、長條圖、圓餅圖、環圈圖、散佈圖與走勢圖),以 Qt Widgets 繪製且不依賴 Qt Charts;另新增 FileDropZone 與 FileListView。Toast 採用全新卡片樣式並提供選用關閉按鈕。

1.8.3

元件庫 UILib

新增 ParticleBackdrop(以 CPU 繪製的粒子背景)與可重複使用的 SplashScreen,並修正鍵盤選取與文字編輯問題。

Gallery 範例應用

範例原始碼更方便閱讀與複製。

1.8.2

元件庫 UILib

UserTheme::applyOverrides() 可全域修改整個應用程式的色彩、圓角半徑與字型,setThemeOverrides() 則針對單一元件執行相同設定。ComboBox 下拉式清單現已支援自訂字型,並修正了支援之 Qt 版本上的回呼、導覽與滑桿錯誤。

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,以及 fluentqt doctor、create 與 trial 指令,可檢查本機 Qt 環境並建立 C++ 或 PySide6 入門專案;同時修正跨平台選擇器與清單的多項問題。

1.7.0

元件庫 UILib

需要遷移

移除 Material 與 Cupertino 設計語言,僅保留 Fluent。新增 Field 與 DataGrid,並說明所有浮層的開啟、關閉與模態行為。

已移除設計語言與樣式主題 API

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()

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

元件庫 UILib

新增 CommandBar、CommandBarFlyout,以及統一處理復原、複製、貼上等操作的 EditingCommandRouter。Toast 新增動作按鈕、懸停暫停與原地更新功能。

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 範例應用

將 spdlog 保留於 Gallery 中,並從其安裝套件移除未使用的 Qt 模組。

1.3.0

未記錄發布日期

元件庫 UILib

新增 x64 與 ARM64 架構的 Linux 支援(涵蓋 X11 與 Wayland),並提供 Debian 安裝套件。Window::setBackdropEffect() 在所有平台上提供統一的 Mica/Acrylic API。