Fluent-Qt

Меню и панели инструментов

MenuBar Строка меню

Горизонтальная панель меню верхнего уровня, каждое из которых содержит команды.

Пример

MenuBar Строка меню: Встроенная строка меню

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

Встроенная строка меню

Добавляйте меню через addMenu() и вызывайте setBackgroundVisible(false) для слияния с карточкой или заголовком окна. При нехватке места лишние пункты переносятся в кнопку «Ещё».

#include <FluentQt/MenusToolbars.h>
using namespace fluent::menus_toolbars;

using fluent::status_info::Toast;
auto addCommand = [this](FluentMenu* menu, const QString& text,
                         const QKeySequence& shortcut = QKeySequence()) {
    auto* action = menu->addAction(text);
    if (!shortcut.isEmpty()) action->setShortcut(shortcut);
    connect(action, &QAction::triggered, this, [this, text] {
        Toast::showOrUpdateToast(this, "gallery.action-feedback", text + " selected",
            Toast::Informational, 2200, Toast::Top, QMargins(16, 50, 16, 16));
    });
    return action;
};
auto* menuBar = new FluentMenuBar(this);
menuBar->setBackgroundVisible(false);
auto* fileMenu = new FluentMenu("File", menuBar);
addCommand(fileMenu, "New", QKeySequence::New);
addCommand(fileMenu, "Open...", QKeySequence::Open);
addCommand(fileMenu, "Save", QKeySequence::Save);
menuBar->addMenu(fileMenu);
auto* editMenu = new FluentMenu("Edit", menuBar);
addCommand(editMenu, "Undo", QKeySequence::Undo);
addCommand(editMenu, "Cut", QKeySequence::Cut);
addCommand(editMenu, "Copy", QKeySequence::Copy);
addCommand(editMenu, "Paste", QKeySequence::Paste);
menuBar->addMenu(editMenu);
auto* viewMenu = new FluentMenu("View", menuBar);
auto* wrap = viewMenu->addAction("Word wrap");
wrap->setCheckable(true);
wrap->setChecked(true);
menuBar->addMenu(viewMenu);
auto* helpMenu = new FluentMenu("Help", menuBar);
addCommand(helpMenu, "About");
menuBar->addMenu(helpMenu);

fluent::menus_toolbars::FluentMenuBar

Наследует QMenuBar · FluentElement · QMLPlus

Строка меню в стиле Fluent с меню переполнения и настраиваемой ролью шрифта. Действия, не помещающиеся в доступную ширину панели, остаются доступными через кнопку переполнения.

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

Методы

void setFontStyle(Typography::FontRole role)

Стиль типографики Fluent, используемый для текста меню.

Typography::FontRole fontStyle() const

Стиль типографики Fluent, используемый для текста меню.

bool backgroundVisible() const

Заливает ли строка меню свой фон. Отключите для слияния с карточкой или заголовком окна.

void setBackgroundVisible(bool visible)

Заливает ли строка меню свой фон. Отключите для слияния с карточкой или заголовком окна.

Свойства

Typography::FontRole fontStyle

Стиль типографики Fluent, используемый для текста меню.

Чтение fontStyle()Запись setFontStyle()Уведомление fontStyleChanged()
bool backgroundVisible

Заливает ли строка меню свой фон. Отключите для слияния с карточкой или заголовком окна.

Чтение backgroundVisible()Запись setBackgroundVisible()Уведомление backgroundVisibleChanged()

Сигналы

void fontStyleChanged()

Стиль типографики Fluent, используемый для текста меню.

void backgroundVisibleChanged(bool visible)

Заливает ли строка меню свой фон. Отключите для слияния с карточкой или заголовком окна.

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

Методы

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