Дата и время
TimePicker Выбор времени
Элемент выбора времени суток с прокручиваемыми столбцами.
Пример
Не удалось загрузить предпросмотр свойств. Выберите предпросмотр свойств ещё раз для повтора.

Использование
Выбор времени с прокручиваемыми столбцами
setTime() задаёт начальную позицию прокрутки при открытии без выбора значения; для установки выбранного времени вызовите setSelectedTime(). setMinuteIncrement(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
ОбъявлениеНет подходящих элементов API.
fluent::date_time::TimePicker
Наследует fluent::basicinput::Button
Средство выбора времени в виде кнопки с поддержкой очистки выбора.
Конструкторы
Деструкторы
Перечисления
enum class TimeFieldHourMinutePeriod
enum class ClockIdentifierTwelveHourClockTwentyFourHourClock
Методы
QTime time() constВыбранное время, если оно корректно; иначе время по умолчанию для инициализации колеса.
QTime selectedTime() constВыбранное время; некорректное время означает отсутствие выбора.
int minuteIncrement() constШаг минут в средстве выбора времени.
ClockIdentifier clockIdentifier() constРежим часов для отображения и редактирования времени.
QLocale locale() constЛокаль, используемая для текста периода AM/PM.
bool isDropDownOpen() constОткрыта ли выпадающая панель выбора.
QString confirmButtonAccessibleName() constПользовательское имя доступности для кнопки подтверждения.
QString cancelButtonAccessibleName() constПользовательское имя доступности для кнопки отмены.
void setTime(const QTime& time)Задаёт время по умолчанию/ожидания без изменения selectedTime; некорректные значения времени игнорируются.
void setSelectedTime(const QTime& time)Фиксирует выбранное время; недопустимое время сбрасывает выбор.
void clearSelectedTime()Выбранное время; некорректное время означает отсутствие выбора.
void setMinuteIncrement(int increment)Шаг минут в средстве выбора времени.
void setClockIdentifier(ClockIdentifier identifier)Режим часов для отображения и редактирования времени.
void setLocale(const QLocale& locale)Локаль, используемая для текста периода AM/PM.
void setPlaceholderText(TimeField field, const QString& text)Задаёт пользовательский текст-заполнитель для одного поля времени.
void setConfirmButtonAccessibleName(const QString& name)Пользовательское имя доступности для кнопки подтверждения.
void setCancelButtonAccessibleName(const QString& name)Пользовательское имя доступности для кнопки отмены.
Свойства
QTime timeВыбранное время, если оно корректно; иначе время по умолчанию для инициализации колеса.
Чтениеtime()ЗаписьsetTime()УведомлениеtimeChanged()QTime selectedTimeВыбранное время; некорректное время означает отсутствие выбора.
ЧтениеselectedTime()ЗаписьsetSelectedTime()СбросclearSelectedTime()УведомлениеselectedTimeChanged()int minuteIncrementШаг минут в средстве выбора времени.
ЧтениеminuteIncrement()ЗаписьsetMinuteIncrement()УведомлениеminuteIncrementChanged()ClockIdentifier clockIdentifierРежим часов для отображения и редактирования времени.
ЧтениеclockIdentifier()ЗаписьsetClockIdentifier()УведомлениеclockIdentifierChanged()bool dropDownOpenОткрыта ли выпадающая панель выбора.
ЧтениеisDropDownOpen()УведомлениеdropDownOpenChanged()QLocale localeЛокаль, используемая для текста периода AM/PM.
Чтениеlocale()ЗаписьsetLocale()УведомлениеlocaleChanged()QString confirmButtonAccessibleNameПользовательское имя доступности для кнопки подтверждения.
ЧтениеconfirmButtonAccessibleName()ЗаписьsetConfirmButtonAccessibleName()УведомлениеconfirmButtonAccessibleNameChanged()QString cancelButtonAccessibleNameПользовательское имя доступности для кнопки отмены.
ЧтениеcancelButtonAccessibleName()ЗаписьsetCancelButtonAccessibleName()УведомлениеcancelButtonAccessibleNameChanged()
Сигналы
void timeChanged(const QTime& time)Выбранное время, если оно корректно; иначе время по умолчанию для инициализации колеса.
void selectedTimeChanged(const QTime& time)Выбранное время; некорректное время означает отсутствие выбора.
void minuteIncrementChanged(int increment)Шаг минут в средстве выбора времени.
void clockIdentifierChanged(TimePicker::ClockIdentifier identifier)Режим часов для отображения и редактирования времени.
void localeChanged(const QLocale& locale)Локаль, используемая для текста периода AM/PM.
void confirmButtonAccessibleNameChanged(const QString& name)Пользовательское имя доступности для кнопки подтверждения.
void cancelButtonAccessibleNameChanged(const QString& name)Пользовательское имя доступности для кнопки отмены.
void dropDownOpenChanged(bool open)Открыта ли выпадающая панель выбора.
Защищённые члены
Методы
Унаследовано от fluent::basicinput::Button
Перечисления
enum ButtonStyleВизуальный стиль кнопки, определяемый по токенам дизайна Fluent.
StandardAccentSubtle
enum ButtonSizeПресеты плотности кнопок для внутренних отступов и предпочтительной высоты.
SmallStandardSizeLarge
enum ButtonLayoutРежим компоновки текста и значка, включая центрированные значки над или под подписью.
TextOnlyIconBeforeIconOnlyIconAfterIconAboveIconBelow
enum class TextColorRoleУровень акцента цвета текста и значков.
PrimarySecondaryAccent
enum InteractionStateПереопределение состояния отрисовки; значение Rest использует фактическое состояние наведения или нажатия.
RestHoverPressedDisabled
Методы
ButtonStyle fluentStyle() constВизуальный стиль: Standard, Accent или Subtle.
void setFluentStyle(ButtonStyle style)Визуальный стиль: Standard, Accent или Subtle.
ButtonSize fluentSize() constПредустановка размера, управляющая высотой и внутренними отступами, но не шрифтом.
void setFluentSize(ButtonSize size)Предустановка размера, управляющая высотой и внутренними отступами, но не шрифтом.
Typography::FontRole fontRole() constПресет Fluent Typography, используемый при следовании шрифтам темы.
void setFontRole(Typography::FontRole role)Пресет Fluent Typography, используемый при следовании шрифтам темы.
TextColorRole textColorRole() constАкцент переднего плана для незалитых и неотмеченных кнопок; залитые и отключённые сохраняют контрастные цвета.
void setTextColorRole(TextColorRole role)Акцент переднего плана для незалитых и неотмеченных кнопок; залитые и отключённые сохраняют контрастные цвета.
void setFont(const QFont& font)Задаёт явный шрифт, который не меняется при последующих обновлениях темы.
ButtonLayout fluentLayout() constКомпоновка содержимого для размещения текста и иконки.
void setFluentLayout(ButtonLayout layout)Выбирает явную компоновку, включая TextOnly до назначения значка.
void setIcon(const QIcon& icon)Задаёт иконку Qt; первая иконка использует IconBefore, если макет не выбран явно.
QIcon icon() constЗначок Qt с тем же продвижением макета по умолчанию, что и у глифов значков.
bool hasFocusVisual() constОпределяет, отрисовывается ли визуальная рамка фокуса.
void setFocusVisual(bool focus)Определяет, отрисовывается ли визуальная рамка фокуса.
InteractionState interactionState() constПереопределяет состояние взаимодействия для интерактивных демонстраций или визуальных проверок.
void setInteractionState(InteractionState state)Переопределяет состояние взаимодействия для интерактивных демонстраций или визуальных проверок.
bool criticalOnHover() constИспользует цвет критической ошибки при наведении или нажатии.
void setCriticalOnHover(bool enabled)Использует цвет критической ошибки при наведении или нажатии.
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 — без масштабирования). Приложения могут анимировать это свойство для отклика на нажатие; сам Button не запускает анимацию масштабирования.
void setIconScale(qreal scale)Равномерный масштаб для отрисовываемого глифа iconfont (1.0 — без масштабирования). Приложения могут анимировать это свойство для отклика на нажатие; сам Button не запускает анимацию масштабирования.
qreal contentOpacity() constНепрозрачность уровня отрисовщика для всей кнопки (1.0 — полная непрозрачность). Лёгкое затухание, позволяющее избежать накладных расходов внеэкранного композитинга QGraphicsOpacityEffect.
void setContentOpacity(qreal opacity)Непрозрачность уровня отрисовщика для всей кнопки (1.0 — полная непрозрачность). Лёгкое затухание, позволяющее избежать накладных расходов внеэкранного композитинга QGraphicsOpacityEffect.
QSize sizeHint() const overrideВычисляет предпочтительный размер с учётом внутренних отступов Fluent, текста и содержимого iconfont.
void setIconGlyph(const QString& glyph, int pixelSize = Typography::IconSize::Standard, const QString& family = Typography::FontFamily::FluentIcons)Задаёт глиф iconfont, отрисовываемый напрямую в paintEvent(). Первый непустой глиф переключает макет на IconBefore, если не вызывался setFluentLayout().
Свойства
ButtonStyle fluentStyleВизуальный стиль: Standard, Accent или Subtle.
ЧтениеfluentStyle()ЗаписьsetFluentStyle()УведомлениеfluentStyleChanged()ButtonSize fluentSizeПредустановка размера, управляющая высотой и внутренними отступами, но не шрифтом.
ЧтениеfluentSize()ЗаписьsetFluentSize()УведомлениеfluentSizeChanged()Typography::FontRole fontRoleПресет Fluent Typography, используемый при следовании шрифтам темы.
ЧтениеfontRole()ЗаписьsetFontRole()УведомлениеfontRoleChanged()TextColorRole textColorRoleАкцент переднего плана для незалитых и неотмеченных кнопок; залитые и отключённые сохраняют контрастные цвета.
ЧтениеtextColorRole()ЗаписьsetTextColorRole()УведомлениеtextColorRoleChanged()ButtonLayout fluentLayoutКомпоновка содержимого для размещения текста и иконки.
ЧтениеfluentLayout()ЗаписьsetFluentLayout()УведомлениеfluentLayoutChanged()QIcon iconЗначок Qt с тем же продвижением макета по умолчанию, что и у глифов значков.
Чтениеicon()ЗаписьsetIcon()УведомлениеiconChanged()bool focusVisualОпределяет, отрисовывается ли визуальная рамка фокуса.
ЧтениеhasFocusVisual()ЗаписьsetFocusVisual()УведомлениеfocusVisualChanged()InteractionState interactionStateПереопределяет состояние взаимодействия для интерактивных демонстраций или визуальных проверок.
ЧтениеinteractionState()ЗаписьsetInteractionState()УведомлениеinteractionStateChanged()bool criticalOnHoverИспользует цвет критической ошибки при наведении или нажатии.
Чтение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 — без масштабирования). Приложения могут анимировать это свойство для отклика на нажатие; сам Button не запускает анимацию масштабирования.
ЧтениеiconScale()ЗаписьsetIconScale()qreal contentOpacityНепрозрачность уровня отрисовщика для всей кнопки (1.0 — полная непрозрачность). Лёгкое затухание, позволяющее избежать накладных расходов внеэкранного композитинга QGraphicsOpacityEffect.
ЧтениеcontentOpacity()ЗаписьsetContentOpacity()
Сигналы
void fluentStyleChanged()Визуальный стиль: Standard, Accent или Subtle.
void fluentSizeChanged()Предустановка размера, управляющая высотой и внутренними отступами, но не шрифтом.
void fontRoleChanged()Пресет Fluent Typography, используемый при следовании шрифтам темы.
void textColorRoleChanged()Акцент переднего плана для незалитых и неотмеченных кнопок; залитые и отключённые сохраняют контрастные цвета.
void fluentLayoutChanged()Компоновка содержимого для размещения текста и иконки.
void iconChanged()Значок Qt с тем же продвижением макета по умолчанию, что и у глифов значков.
void focusVisualChanged()Определяет, отрисовывается ли визуальная рамка фокуса.
void interactionStateChanged()Переопределяет состояние взаимодействия для интерактивных демонстраций или визуальных проверок.
void criticalOnHoverChanged()Использует цвет критической ошибки при наведении или нажатии.
void cornerRadiiChanged()Радиусы для каждого угла; left/top/right/bottom соответствуют верхнему левому, верхнему правому, нижнему правому и нижнему левому углам.
Унаследовано от fluent::FluentElement
Перечисления
enum ThemeГлобальная визуальная тема, используемая при разрешении дизайн-токенов.
Light = 0Dark = 1HighContrast = 2
Методы
static void setTheme(Theme theme)Обновляет глобальную тему и уведомляет активные экземпляры FluentElement.
static void setThemeDeferred(Theme theme)Планирует пакетное обновление темы с приоритетом видимых элементов без блокировки текущего взаимодействия.
static Theme currentTheme()Возвращает текущую активную глобальную тему.
static bool themeUsesDarkAppearance(Theme theme)Возвращает, использует ли тема токены тёмного оформления и материалов.
static void refreshTheme()Повторно рассылает текущую тему для перерисовки после изменения дизайн-токенов.
static int themeGeneration()Монотонный счётчик, увеличиваемый при каждом изменении темы для проверки актуальности.
Theme effectiveTheme() constОпределяет тему, используемую этим элементом, с учётом унаследованного переопределения QWidget.
bool effectiveThemeUsesDarkAppearance() constВозвращает, использует ли действующая тема этого элемента тёмную основу оформления.
bool setThemeOverrides(const QJsonObject& overrides)Заменяет разреженные переопределения токенов цвета, скругления и шрифта этого элемента.
QJsonObject themeOverrides() constВозвращает заданные переопределения этого элемента.
void clearThemeOverrides()Восстанавливает для всех полей токенов значения глобальной темы по умолчанию.
const Colors& themeColorsRef() constДоступ без копирования к активному набору цветов для горячих путей отрисовки.
Material::AcrylicToken themeAcrylic() constТокены материалов, возвышения и адаптивной компоновки.
QColor themeBackdrop(bool active) constЦвет фона рамки окна для заданного состояния активации.
virtual void onThemeUpdated()Вызывается после изменения глобальной темы.
Типы и псевдонимы
struct ColorsСнимки дизайн-токенов, возвращаемые компонентам.
Унаследовано от fluent::QMLPlus
Методы
AnchorLayout::Anchors* anchors()Возвращает изменяемые привязки для хоста QWidget.
void setState(const QString& name)Применяет зарегистрированное состояние по имени или восстанавливает состояние по умолчанию, если @p name пусто. Неизвестные имена игнорируются, а при выходе из состояния возобновляются прежние привязки.
void addState(const QMLState& state)Регистрирует или заменяет именованное определение состояния; замена активного состояния применяется немедленно.
void evaluateStates()Повторно вычисляет условия состояний в порядке регистрации и активирует первое совпадение или состояние по умолчанию, если совпадений нет. Также выполняется автоматически при уведомлениях свойств-зависимостей; производные состояния с extend наследуют изменения предков, если нет циклов или пропусков.
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)Связывает @p sourceProp объекта @p source со свойством @p targetProp этого хоста QWidget через PropertyBinder::bind().
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 = {})Устанавливает C++-выражение с явными зависимостями на этом хосте QWidget.
void addTransition(const StateTransition& transition)Регистрирует переход состояния в порядке приоритета.
void setBehavior(const char* propertyName, const PropertyAnimation& animation)Задаёт анимацию по умолчанию при записи @p propertyName через writeProperty() или привязку. Явные правила StateTransition имеют приоритет; прямые вызовы C++ сеттеров не анимируются.
void clearBehavior(const char* propertyName)Удаляет анимацию по умолчанию для последующих управляемых записей.
bool writeProperty(const char* propertyName, const QVariant& value)Записывает свойство хоста через Behavior без удаления его привязки.
Документация базового класса Qt: QPushButton