Базовый ввод
Button Кнопка
Запускает действие, например сохранение или отправку формы.
Пример
Не удалось загрузить предпросмотр свойств. Выберите предпросмотр свойств ещё раз для повтора.


Использование
Выбор стиля
Задайте стиль с помощью setFluentStyle(): Accent для основного действия, Standard для прочих действий и Subtle для второстепенных.
#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;
auto* standard = new Button("Standard", this);
standard->setFluentStyle(Button::Standard);
auto* accent = new Button("Accent", this);
accent->setFluentStyle(Button::Accent);
auto* subtle = new Button("Subtle", this);
subtle->setFluentStyle(Button::Subtle);import fluentqt
standard = fluentqt.Button('Standard')
standard.setFluentStyle(fluentqt.Button.ButtonStyle.Standard)
accent = fluentqt.Button('Accent')
accent.setFluentStyle(fluentqt.Button.ButtonStyle.Accent)
subtle = fluentqt.Button('Subtle')
subtle.setFluentStyle(fluentqt.Button.ButtonStyle.Subtle)Состояния взаимодействия
Button напрямую отрисовывает состояния покоя, наведения, нажатия и отключения. Вызовите setFocusVisual(true), чтобы показывать рамку фокуса при навигации с клавиатуры.
#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;
auto* rest = new Button("Rest", this);
auto* hover = new Button("Hover", this);
hover->setInteractionState(Button::Hover);
auto* pressed = new Button("Pressed", this);
pressed->setInteractionState(Button::Pressed);
auto* focused = new Button("Focus", this);
focused->setFocusVisual(true);
auto* disabled = new Button("Disabled", this);
disabled->setInteractionState(Button::Disabled);import fluentqt
rest = fluentqt.Button("Rest")
hover = fluentqt.Button("Hover")
hover.setInteractionState(fluentqt.Button.InteractionState.Hover)
pressed = fluentqt.Button("Pressed")
pressed.setInteractionState(fluentqt.Button.InteractionState.Pressed)
focused = fluentqt.Button("Focus")
focused.setFocusVisual(True)
disabled = fluentqt.Button("Disabled")
disabled.setInteractionState(fluentqt.Button.InteractionState.Disabled)API
ОбъявлениеНет подходящих элементов API.
fluent::basicinput::Button
Наследует QPushButton · FluentElement · QMLPlus
Кнопка Fluent с отрисовкой на основе токенов и опциональным содержимым иконочного шрифта. Сохраняет поведение взаимодействия QPushButton, выполняя пользовательскую отрисовку в paintEvent().
Конструкторы
Перечисления
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 соответствуют верхнему левому, верхнему правому, нижнему правому и нижнему левому углам.
Защищённые члены
Методы
void paintEvent(QPaintEvent* event) overrideПользовательская отрисовка кнопки вместо делегирования QStyle.
void paintButton(InteractionState state)Отрисовывает визуальное состояние без изменения свойства состояния взаимодействия.
void paintButtonState(InteractionState state, bool focused)Отрисовывает явное состояние фокуса без перемещения фокуса; focusVisual и отключённое состояние по-прежнему применяются.
virtual QRectF contentPaintRect(const QRectF& surfaceRect) constВозвращает прямоугольник, используемый для компоновки отрисовываемых значка и текста.
virtual QSize stackedContentSize() constИзмеряет расположенные вертикально значок и подпись без внешних отступов.
QRectF paintStackedContent(QPainter& painter, const QRectF& bounds) constОтрисовывает центрированное вертикально расположенное содержимое в заданных границах и возвращает прямоугольник подписи.
QString iconGlyph() constПредоставляет параметры iconfont подклассам кнопки.
Унаследовано от 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