Fluent-Qt

Базовый ввод

SplitButton Разделённая кнопка

Двухчастная кнопка: основное действие и стрелка для открытия меню.

Пример

SplitButton Разделённая кнопка: Основное действие и меню

Использование

Основное действие и меню

Левая часть генерирует clicked; правая стрелка открывает FluentMenu, заданное через setMenu() (обрабатывайте выбор через сигнал меню triggered). Параметры значка аналогичны Button.

#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;

auto* button = new SplitButton("Choose color", this);
auto* menu = new FluentMenu("Colors", button);
menu->addAction("Red");
menu->addAction("Green");
menu->addAction("Blue");
button->setMenu(menu);
connect(button, &SplitButton::clicked, button, [button] {
    Toast::showOrUpdateToast(button, "gallery.action-feedback",
        "Primary action selected", Toast::Informational, 2200,
        Toast::Top, QMargins(16, 50, 16, 16));
});
connect(menu, &QMenu::triggered, button, [button](QAction* action) {
    Toast::showOrUpdateToast(button, "gallery.action-feedback",
        action->text() + " selected", Toast::Informational, 2200,
        Toast::Top, QMargins(16, 50, 16, 16));
});

fluent::basicinput::SplitButton

Наследует Button

Кнопка, разделённая на область основного действия и триггер выпадающего меню.

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

Деструкторы

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

enum SplitPart
  • None
  • Primary
  • Secondary

Методы

QMenu* menu() const

Меню, открываемое дополнительной областью составной кнопки.

void setMenu(QMenu* menu)

Меню, открываемое дополнительной областью составной кнопки.

bool isOpen() const

Видимо ли в данный момент прикреплённое меню.

int secondaryWidth() const

Ширина дополнительной области действия составной кнопки.

void setSecondaryWidth(int width)

Ширина дополнительной области действия составной кнопки.

Свойства

QMenu* menu

Меню, открываемое дополнительной областью составной кнопки.

Чтение menu()Запись setMenu()Уведомление menuChanged()
bool isOpen

Видимо ли в данный момент прикреплённое меню.

Чтение isOpen()Уведомление openChanged()
int secondaryWidth

Ширина дополнительной области действия составной кнопки.

Чтение secondaryWidth()Запись setSecondaryWidth()Уведомление secondaryWidthChanged()

Сигналы

void menuChanged()

Меню, открываемое дополнительной областью составной кнопки.

void openChanged()

Видимо ли в данный момент прикреплённое меню.

void secondaryWidthChanged()

Ширина дополнительной области действия составной кнопки.

Защищённые члены

Поля

Методы

Унаследовано от 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