状态与信息

ProgressBar 进度条

显示任务完成了多少。

示例

用法

设置进度

setRange() 和 setValue() 设置进度，progressText() 返回百分比文字。

#include <FluentQt/StatusInfo.h>
using namespace fluent::status_info;

auto* progressBar = new ProgressBar(this);
progressBar->setRange(0, 100);
progressBar->setBarWidth(320);

auto* progressBox = new NumberBox(this);
progressBox->setHeader("Progress");
progressBox->setRange(0, 100);
progressBox->setSmallChange(1);
progressBox->setLargeChange(10);
progressBox->setDisplayPrecision(0);
progressBox->setSpinButtonPlacementMode(NumberBox::SpinButtonPlacementMode::Inline);

auto* status = new Label("Progress: 44%", this);
status->setFixedWidth(124);

connect(progressBox, &NumberBox::valueChanged, progressBar, [progressBar, status](double value) {
    progressBar->setValue(std::isfinite(value) ? value : 0.0);
    status->setText(QStringLiteral("Progress: %1%").arg(progressBar->progressText()));
});
progressBox->setValue(44);

import fluentqt

import math

progress_bar = fluentqt.ProgressBar()
progress_bar.setRange(0, 100)
progress_bar.setBarWidth(320)

progress_box = fluentqt.NumberBox()
progress_box.setHeader("Progress")
progress_box.setRange(0, 100)
progress_box.setSmallChange(1)
progress_box.setLargeChange(10)
progress_box.setDisplayPrecision(0)
progress_box.setSpinButtonPlacementMode(
    fluentqt.NumberBox.SpinButtonPlacementMode.Inline
)

status = fluentqt.Label("Progress: 44%")
status.setFixedWidth(124)

def update_progress(value):
    progress_bar.setValue(value if math.isfinite(value) else 0.0)
    status.setText(f"Progress: {progress_bar.progressText()}%")

progress_box.valueChanged.connect(update_progress)
progress_box.setValue(44)

API

查看声明

`fluent::status_info::ProgressBar`

继承自 QWidget · FluentElement · QMLPlus

用于确定和不确定进度的 Fluent 线性进度指示器。

构造函数

explicit ProgressBar(QWidget* parent = nullptr)

属性

bool isIndeterminate: 进度指示器是否使用不确定动画。
读取 isIndeterminate()设置 setIsIndeterminate()通知 isIndeterminateChanged()
double minimum: 计算确定进度时使用的下边界。
读取 minimum()设置 setMinimum()通知 minimumChanged()
double maximum: 计算确定进度时使用的上边界。
读取 maximum()设置 setMaximum()通知 maximumChanged()
double value: minimum 与 maximum 之间的当前确定进度值。
读取 value()设置 setValue()通知 valueChanged()
bool showPaused: 是否显示暂停状态视觉。
读取 showPaused()设置 setShowPaused()通知 showPausedChanged()
bool showError: 是否显示错误状态视觉。
读取 showError()设置 setShowError()通知 showErrorChanged()
int barWidth: 进度条片段的绘制宽度。
读取 barWidth()设置 setBarWidth()通知 barWidthChanged()
qreal trackThickness: 进度轨道厚度。
读取 trackThickness()设置 setTrackThickness()通知 trackThicknessChanged()
bool railVisible: 是否绘制进度背景轨道。
读取 railVisible()设置 setRailVisible()通知 railVisibleChanged()