Fluent-Qt

基礎指南

動畫

在全域或單一控制項層級啟用、縮短或停用控制項動畫。

全域動畫模式

MotionPolicy 控制 FluentQt 控制項的動畫行為:Full 依正常時長播放,Reduced 將過場動畫上限設為 50 ms 並停止循環動畫,Disabled 則直接跳至最終狀態。單一控制項的本地開關仍可獨立關閉動畫。

#include <FluentQt/Foundation.h>

fluent::MotionPolicy::instance().setMode(fluent::MotionPolicy::Mode::Reduced);

個別控制項開關

具動畫效果的控制項(如 Dialog、Popup 與 ProgressRing)提供 animationEnabled 屬性,StackView 則提供 setTransitionAnimationEnabled(false)。僅重繪懸停或按下配色的控制項(如 Button)不單獨提供動畫開關。

自訂動畫

撰寫自訂動畫時,請檢查 MotionPolicy::instance().shouldAnimate() 與 resolvedDuration()(循環動畫請傳入 MotionPolicy::Kind::Continuous),並連接 modeChanged 以便在使用者變更設定時即時回應。

API 參考