Fluent-Qt

Дата и время

TimePicker Выбор времени

Элемент выбора времени суток с прокручиваемыми столбцами.

Пример

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);

fluent::date_time::TimePicker

Наследует fluent::basicinput::Button

Средство выбора времени в виде кнопки с поддержкой очистки выбора.

Конструкторы

Деструкторы

Перечисления

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

Методы

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.

  • Standard
  • Accent
  • Subtle
enum ButtonSize

Пресеты плотности кнопок для внутренних отступов и предпочтительной высоты.

  • Small
  • StandardSize
  • Large
enum ButtonLayout

Режим компоновки текста и значка, включая центрированные значки над или под подписью.

  • TextOnly
  • IconBefore
  • IconOnly
  • IconAfter
  • IconAbove
  • IconBelow
enum class TextColorRole

Уровень акцента цвета текста и значков.

  • Primary
  • Secondary
  • Accent
enum InteractionState

Переопределение состояния отрисовки; значение Rest использует фактическое состояние наведения или нажатия.

  • Rest
  • Hover
  • Pressed
  • Disabled

Методы

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 = 0
  • Dark = 1
  • HighContrast = 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 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