Fluent-Qt

基礎指南

繫結、錨點與狀態

無需載入 QML 引擎即可為 QWidget 提供屬性繫結、相對錨點與狀態切換。

繫結屬性

bind() 可在來源屬性變化時自動同步目標屬性。若之後需要暫停、恢復或清除繫結,請使用 QMLPlus::bindManaged()(C++)或 fluentqt.bind_managed()(Python)並保存傳回的控制代號。兩個控制項必須位於同一執行緒。

#include <FluentQt/BasicInput.h>
#include <FluentQt/StatusInfo.h>

auto* slider = new fluent::basicinput::Slider(Qt::Horizontal, this);
slider->setRange(0, 100);
auto* bar = new fluent::status_info::ProgressBar(this);
bar->setRange(0, 100);
auto binding = bar->bindManaged("value", slider, "value");

錨點定位與狀態

在 C++ 中,anchors() 可將邊緣或中心對齊至父控制項或兄弟控制項,addState()、setState() 與 addTransition() 則可搭配動畫切換屬性狀態。在 Python 中,可將 fluentqt.anchors() 傳給 AnchorLayout 並以 StateGroup 管理狀態。

#include <FluentQt/Foundation.h>

// badge is a child of card
using Edge = fluent::AnchorLayout::Edge;
badge->anchors()->top = {card, Edge::Top, 12};
badge->anchors()->right = {card, Edge::Right, -12};

API 參考