日期与时间

TimePicker 时间选择器

分别滚动选择小时和分钟。

示例

用法

选择时间

setTime() 设置初始时间，setMinuteIncrement(5) 让分钟按 5 分钟递增。

#include <FluentQt/DateTime.h>
using namespace fluent::date_time;

auto* picker = new TimePicker(this);
picker->setPlaceholderText(TimePicker::TimeField::Hour, "hour");
picker->setPlaceholderText(TimePicker::TimeField::Minute, "minute");
picker->setPlaceholderText(TimePicker::TimeField::Period, "AM/PM");
picker->setConfirmButtonAccessibleName("Accept time");
picker->setCancelButtonAccessibleName("Cancel time");
picker->setTime(QTime(9, 30));
picker->setMinuteIncrement(5);

import fluentqt

from PySide6.QtCore import QTime

picker = fluentqt.TimePicker()
picker.setPlaceholderText(fluentqt.TimePicker.TimeField.Hour, "hour")
picker.setPlaceholderText(fluentqt.TimePicker.TimeField.Minute, "minute")
picker.setPlaceholderText(fluentqt.TimePicker.TimeField.Period, "AM/PM")
picker.setConfirmButtonAccessibleName("Accept time")
picker.setCancelButtonAccessibleName("Cancel time")
picker.setTime(QTime(9, 30))
picker.setMinuteIncrement(5)

API

查看声明

`fluent::date_time::TimePicker`

继承自 fluent::basicinput::Button

支持可空选中时间语义的按钮式时间选择器。

构造函数

explicit TimePicker(QWidget* parent = nullptr)

属性

QTime time: picker 当前显示的时间值。
读取 time()设置 setTime()通知 timeChanged()
QTime selectedTime: 选中时间；无效时间表示未选择。
读取 selectedTime()设置 setSelectedTime()重置 clearSelectedTime()通知 selectedTimeChanged()
int minuteIncrement: 时间选择器使用的分钟步长。
读取 minuteIncrement()设置 setMinuteIncrement()通知 minuteIncrementChanged()
ClockIdentifier clockIdentifier: 时间显示和编辑使用的时钟模式。
读取 clockIdentifier()设置 setClockIdentifier()通知 clockIdentifierChanged()
bool dropDownOpen: picker 下拉面板是否打开。
读取 isDropDownOpen()通知 dropDownOpenChanged()
QLocale locale: 用于上午/下午时段文案的区域设置。
读取 locale()设置 setLocale()通知 localeChanged()
QString confirmButtonAccessibleName: 由应用为确认按钮提供的无障碍名称。
读取 confirmButtonAccessibleName()设置 setConfirmButtonAccessibleName()通知 confirmButtonAccessibleNameChanged()
QString cancelButtonAccessibleName: 由应用为取消按钮提供的无障碍名称。
读取 cancelButtonAccessibleName()设置 setCancelButtonAccessibleName()通知 cancelButtonAccessibleNameChanged()

方法

QTime time() const: picker 当前显示的时间值。
QTime selectedTime() const: 选中时间；无效时间表示未选择。
int minuteIncrement() const: 时间选择器使用的分钟步长。
ClockIdentifier clockIdentifier() const: 时间显示和编辑使用的时钟模式。
QLocale locale() const: 用于上午/下午时段文案的区域设置。
bool isDropDownOpen() const: picker 下拉面板是否打开。
bool isOpen() const
QString fieldDisplayText(TimeField field) const
QString placeholderText(TimeField field) const
QString confirmButtonAccessibleName() const: 由应用为确认按钮提供的无障碍名称。
QString cancelButtonAccessibleName() const: 由应用为取消按钮提供的无障碍名称。
Qt::Alignment fieldTextAlignment(TimeField field) const
QSize sizeHint() const override
QSize minimumSizeHint() const override
void setTime(const QTime& time): picker 当前显示的时间值。
void setSelectedTime(const QTime& time): 选中时间；无效时间表示未选择。
void clearSelectedTime(): 选中时间；无效时间表示未选择。
void setMinuteIncrement(int increment): 时间选择器使用的分钟步长。
void setClockIdentifier(ClockIdentifier identifier): 时间显示和编辑使用的时钟模式。
void setLocale(const QLocale& locale): 用于上午/下午时段文案的区域设置。
void setPlaceholderText(TimeField field, const QString& text): 为一个时间字段设置由应用拥有的占位文本。
void setConfirmButtonAccessibleName(const QString& name): 由应用为确认按钮提供的无障碍名称。
void setCancelButtonAccessibleName(const QString& name): 由应用为取消按钮提供的无障碍名称。
void setFieldTextAlignment(TimeField field, Qt::Alignment alignment)
void openPicker()
void closePicker()

信号

void timeChanged(const QTime& time): picker 当前显示的时间值。
void selectedTimeChanged(const QTime& time): 选中时间；无效时间表示未选择。
void minuteIncrementChanged(int increment): 时间选择器使用的分钟步长。
void clockIdentifierChanged(TimePicker::ClockIdentifier identifier): 时间显示和编辑使用的时钟模式。
void localeChanged(const QLocale& locale): 用于上午/下午时段文案的区域设置。
void placeholderTextChanged(TimePicker::TimeField field, const QString& text)
void confirmButtonAccessibleNameChanged(const QString& name): 由应用为确认按钮提供的无障碍名称。
void cancelButtonAccessibleNameChanged(const QString& name): 由应用为取消按钮提供的无障碍名称。
void dropDownOpenChanged(bool open): picker 下拉面板是否打开。

枚举

enum class TimeField: Hour
Minute
Period
enum class ClockIdentifier: TwelveHourClock
TwentyFourHourClock

析构函数

~TimePicker() override

子类扩展接口

方法

void paintEvent(QPaintEvent* event) override
void resizeEvent(QResizeEvent* event) override
void keyPressEvent(QKeyEvent* event) override
void changeEvent(QEvent* event) override
void onThemeUpdated() override

继承自 fluent::basicinput::Button

属性

ButtonStyle fluentStyle: 按钮视觉风格：Standard(标准)、Accent(强调色)、Subtle(透明)。
读取 fluentStyle()设置 setFluentStyle()通知 fluentStyleChanged()
ButtonSize fluentSize: 按钮密度 token，仅控制高度与内边距；字体由 fontRole 或 setFont() 管理。
读取 fluentSize()设置 setFluentSize()通知 fluentSizeChanged()
Typography::FontRole fontRole: 按钮跟随主题字体时使用的 Fluent 排版角色。
读取 fontRole()设置 setFontRole()通知 fontRoleChanged()
TextColorRole textColorRole: 非填充、未选中按钮的语义前景色；填充和禁用状态仍使用对应对比色。
读取 textColorRole()设置 setTextColorRole()通知 textColorRoleChanged()
ButtonLayout fluentLayout: 文本与图标的内容排列方式。
读取 fluentLayout()设置 setFluentLayout()通知 fluentLayoutChanged()
bool focusVisual: 控制是否绘制焦点视觉框。
读取 hasFocusVisual()设置 setFocusVisual()通知 focusVisualChanged()
InteractionState interactionState: 强制交互状态，主要用于引导、演示或 VisualCheck。
读取 interactionState()设置 setInteractionState()通知 interactionStateChanged()
bool criticalOnHover: Hover/Pressed 状态使用 Critical 语义色，适合关闭、删除等危险操作。
读取 criticalOnHover()设置 setCriticalOnHover()通知 criticalOnHoverChanged()
QMargins cornerRadii: 四角圆角；left/top/right/bottom 分别对应左上、右上、右下、左下。
读取 cornerRadii()设置 setCornerRadii()重置 resetCornerRadii()通知 cornerRadiiChanged()
QPoint iconOffset: iconfont 绘制偏移量，正值表示向右/向下移动，用于精细视觉对齐。
读取 iconOffset()设置 setIconOffset()
qreal iconRotation: 应用于自绘图标的顺时针旋转角度（度）。
读取 iconRotation()设置 setIconRotation()
qreal iconScale: 作用于自绘 iconfont 字形的等比缩放（1.0 为不缩放），用于实现 WinUI 风格的按下反馈（短暂缩小），且不改变几何布局。
读取 iconScale()设置 setIconScale()
qreal contentOpacity: 作用于整个按钮表面的画笔级不透明度（1.0 为完全不透明）。轻量淡入淡出，避免 QGraphicsOpacityEffect 的离屏合成。
读取 contentOpacity()设置 setContentOpacity()

方法

ButtonStyle fluentStyle() const: Fluent 属性访问接口。
void setFluentStyle(ButtonStyle style): 按钮视觉风格：Standard(标准)、Accent(强调色)、Subtle(透明)。
ButtonSize fluentSize() const: 按钮密度 token，仅控制高度与内边距；字体由 fontRole 或 setFont() 管理。
void setFluentSize(ButtonSize size): 按钮密度 token，仅控制高度与内边距；字体由 fontRole 或 setFont() 管理。
Typography::FontRole fontRole() const: 按钮跟随主题字体时使用的 Fluent 排版角色。
void setFontRole(Typography::FontRole role): 按钮跟随主题字体时使用的 Fluent 排版角色。
TextColorRole textColorRole() const: 非填充、未选中按钮的语义前景色；填充和禁用状态仍使用对应对比色。
void setTextColorRole(TextColorRole role): 非填充、未选中按钮的语义前景色；填充和禁用状态仍使用对应对比色。
void setFont(const QFont& font): 设置显式字体；后续主题刷新不会覆盖该字体。
ButtonLayout fluentLayout() const: 文本与图标的内容排列方式。
void setFluentLayout(ButtonLayout layout): 文本与图标的内容排列方式。
bool hasFocusVisual() const: 控制是否绘制焦点视觉框。
void setFocusVisual(bool focus): 控制是否绘制焦点视觉框。
InteractionState interactionState() const: 强制交互状态，主要用于引导、演示或 VisualCheck。
void setInteractionState(InteractionState state): 强制交互状态，主要用于引导、演示或 VisualCheck。
bool criticalOnHover() const: Hover/Pressed 状态使用 Critical 语义色，适合关闭、删除等危险操作。
void setCriticalOnHover(bool enabled): Hover/Pressed 状态使用 Critical 语义色，适合关闭、删除等危险操作。
QMargins cornerRadii() const: 四角圆角；left/top/right/bottom 分别对应左上、右上、右下、左下。
void setCornerRadii(const QMargins& radii): 四角圆角；left/top/right/bottom 分别对应左上、右上、右下、左下。
void resetCornerRadii(): 四角圆角；left/top/right/bottom 分别对应左上、右上、右下、左下。
QPoint iconOffset() const: iconfont 绘制偏移量，正值表示向右/向下移动，用于精细视觉对齐。
void setIconOffset(const QPoint& offset): iconfont 绘制偏移量，正值表示向右/向下移动，用于精细视觉对齐。
qreal iconRotation() const: 应用于自绘图标的顺时针旋转角度（度）。
void setIconRotation(qreal rotation): 应用于自绘图标的顺时针旋转角度（度）。
qreal iconScale() const: 作用于自绘 iconfont 字形的等比缩放（1.0 为不缩放），用于实现 WinUI 风格的按下反馈（短暂缩小），且不改变几何布局。
void setIconScale(qreal scale): 作用于自绘 iconfont 字形的等比缩放（1.0 为不缩放），用于实现 WinUI 风格的按下反馈（短暂缩小），且不改变几何布局。
qreal contentOpacity() const: 作用于整个按钮表面的画笔级不透明度（1.0 为完全不透明）。轻量淡入淡出，避免 QGraphicsOpacityEffect 的离屏合成。
void setContentOpacity(qreal opacity): 作用于整个按钮表面的画笔级不透明度（1.0 为完全不透明）。轻量淡入淡出，避免 QGraphicsOpacityEffect 的离屏合成。
void onThemeUpdated() override
QSize sizeHint() const override: 尺寸提示会综合 Fluent 内边距、文本和 iconfont 内容。
QSize minimumSizeHint() const override
void setIconGlyph(const QString& glyph, int pixelSize = Typography::IconSize::Standard, const QString& family = Typography::FontFamily::FluentIcons): 设置在 paintEvent() 中直接绘制的 iconfont 图标字符。
void setIconGlyph(QChar glyph, int pixelSize = Typography::IconSize::Standard, const QString& family = Typography::FontFamily::FluentIcons)

信号

void fluentStyleChanged(): 按钮视觉风格：Standard(标准)、Accent(强调色)、Subtle(透明)。
void fluentSizeChanged(): 按钮密度 token，仅控制高度与内边距；字体由 fontRole 或 setFont() 管理。
void fontRoleChanged(): 按钮跟随主题字体时使用的 Fluent 排版角色。
void textColorRoleChanged(): 非填充、未选中按钮的语义前景色；填充和禁用状态仍使用对应对比色。
void fluentLayoutChanged(): 文本与图标的内容排列方式。
void focusVisualChanged(): 控制是否绘制焦点视觉框。
void interactionStateChanged(): 强制交互状态，主要用于引导、演示或 VisualCheck。
void criticalOnHoverChanged(): Hover/Pressed 状态使用 Critical 语义色，适合关闭、删除等危险操作。
void cornerRadiiChanged(): 四角圆角；left/top/right/bottom 分别对应左上、右上、右下、左下。

枚举

enum ButtonStyle: 根据 Fluent 设计 token 解析的按钮视觉风格。
Standard
Accent
Subtle
enum ButtonSize: 控制内边距和推荐高度的按钮密度预设。
Small
StandardSize
Large
enum ButtonLayout: 文本与图标的组合模式。
TextOnly
IconBefore
IconOnly
IconAfter
enum class TextColorRole: 文字与图标的语义强调层级。
Primary
Secondary
Accent
enum InteractionState: 绘制状态覆盖值；为 Rest 时再回退到真实 hover/press 状态。
Rest
Hover
Pressed
Disabled

继承自 fluent::FluentElement

方法

static void setTheme(Theme theme): 更新全局主题，并通知所有活跃的 FluentElement 实例。
static void setThemeDeferred(Theme theme): 以可见元素优先的批次调度主题刷新，避免阻塞当前交互。
static Theme currentTheme(): 返回当前生效的全局主题。
static bool themeUsesDarkAppearance(Theme theme): 返回指定主题是否使用暗色底的 chrome 与材质 token。
static void refreshTheme(): 在设计 token 变化后重新广播当前主题以触发重绘。
static int themeGeneration(): 每次主题变化自增的单调计数器，用于过期判断。
Theme effectiveTheme() const: 解析此元素实际使用的主题，会优先读取 QWidget 父链上的局部主题覆盖。
bool effectiveThemeUsesDarkAppearance() const: 返回此元素的实际主题是否使用暗色底 chrome。
bool setThemeOverrides(const QJsonObject& overrides): 供组件侧访问的设计 token 接口。
QJsonObject themeOverrides() const: 返回当前元素的覆盖配置。
void clearThemeOverrides(): 恢复全部 token 跟随全局主题。
Colors themeColors() const
const Colors& themeColorsRef() const: 对当前色板的零拷贝访问（用于绘制热路径）。
FontStyle themeFont(Typography::FontRole role = Typography::FontRole::Body) const
Radius themeRadius() const
Spacing themeSpacing() const
Animation themeAnimation() const
Material::AcrylicToken themeAcrylic() const: 材质、阴影和自适应布局 token。
Material::MicaToken themeMica() const
Material::SmokeToken themeSmoke() const
Elevation::ShadowParams themeShadow(Elevation::Level level) const
int themeBreakpoint(Breakpoints::Breakpoint breakpoint = Breakpoints::Breakpoint::Medium) const
QColor themeBackdrop(bool active) const: 给定激活状态下的窗口 chrome 背景色。
virtual void onThemeUpdated(): 全局主题变化后调用。

枚举

enum Theme: 解析设计 token 时使用的全局视觉主题。
Light = 0
Dark = 1
HighContrast = 2

类型与别名

struct Colors: 返回给组件使用的设计 token 快照。
struct FontStyle
struct Radius
struct Spacing
struct Animation

继承自 fluent::QMLPlus

方法

AnchorLayout::Anchors* anchors(): 返回 QWidget 宿主的可变锚点配置。
void setState(const QString& name): 应用具名 state；名称为空时恢复默认状态。
QString state() const
void addState(const QMLState& state): 注册或替换一个具名 state 定义。
void evaluateStates(): 重新计算条件；按注册顺序选择首个成立的条件。
QMLPlusRuntime* runtime(): 返回按需创建、由宿主持有的状态观察对象。
void setAnchors(const AnchorLayout::Anchors& anchors): 替换宿主的全部锚点，并使父布局失效。
void resetAnchors(): 清除宿主全部锚点，并使父布局失效。
void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay): 将 source 属性绑定到 QWidget 宿主上的 target 属性。
BindingHandle bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {}): 在当前 QWidget 宿主上安装可管理的直接绑定。
BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {}): 在当前 QWidget 宿主上安装使用显式依赖的 C++ 表达式绑定。
void addTransition(const StateTransition& transition): 按优先顺序注册状态过渡。
void setBehavior(const char* propertyName, const PropertyAnimation& animation): 设置宿主受管理属性写入时使用的默认动画。
void clearBehavior(const char* propertyName): 移除后续受管理写入使用的默认动画。
bool writeProperty(const char* propertyName, const QVariant& value): 通过 Behavior 写入宿主属性，且不移除该属性的绑定。

Qt 基类完整成员：QPushButton