Fluent-Qt

Статус и уведомления

InfoBar Информационная панель

Встроенная панель для сообщений о состоянии с уровнем важности и необязательными действиями.

Пример

InfoBar Информационная панель: Уровень важности

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

Уровень важности

Уровень важности определяет ведущую иконку и оформление фона для сообщений о состоянии.

#include <FluentQt/StatusInfo.h>
using namespace fluent::status_info;

auto* info = new InfoBar(this);
info->setSeverity(InfoBar::Informational);
info->setTitle("Update available");
info->setMessage("Version 3.2 is ready.");

auto* error = new InfoBar(this);
error->setSeverity(InfoBar::Error);
error->setTitle("Upload failed");
error->setMessage("The document could not be saved.");

keepInfoBarOpenWithToast(info);
keepInfoBarOpenWithToast(error);

fluent::status_info::InfoBar

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

Встроенная панель уведомлений Fluent с уровнями важности, опциональным виджетом действия и кнопкой закрытия. Отображает заголовок и сообщение со стилем статуса и состоянием открытия/закрытия.

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

Деструкторы

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

enum InfoBarSeverity
  • Informational
  • Success
  • Warning
  • Error

Методы

bool isOpen() const

Открыта ли информационная панель.

void setIsOpen(bool open)

Открыта ли информационная панель.

QString title() const

Текст заголовка, отображаемый в информационной панели.

void setTitle(const QString& title)

Текст заголовка, отображаемый в информационной панели.

QString message() const

Основной текст сообщения в информационной панели.

void setMessage(const QString& message)

Основной текст сообщения в информационной панели.

InfoBarSeverity severity() const

Уровень серьёзности, определяющий цвета и иконку уведомления.

void setSeverity(InfoBarSeverity severity)

Уровень серьёзности, определяющий цвета и иконку уведомления.

bool isClosable() const

Видима и доступна ли кнопка закрытия.

void setIsClosable(bool closable)

Видима и доступна ли кнопка закрытия.

bool isIconVisible() const

Видима ли иконка уровня важности.

void setIsIconVisible(bool visible)

Видима ли иконка уровня важности.

bool singleLine() const

Использует ли уведомление компактную однострочную компоновку.

void setSingleLine(bool singleLine)

Использует ли уведомление компактную однострочную компоновку.

int preferredWidth() const

Предпочтительная ширина, используемая макетом уведомлений.

void setPreferredWidth(int width)

Предпочтительная ширина, используемая макетом уведомлений.

int singleLineHeight() const

Высота, используемая в однострочной компоновке уведомления.

void setSingleLineHeight(int height)

Высота, используемая в однострочной компоновке уведомления.

int multiLineMinHeight() const

Минимальная высота для многострочной компоновки уведомления.

void setMultiLineMinHeight(int height)

Минимальная высота для многострочной компоновки уведомления.

int multiLineActionMinHeight() const

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

void setMultiLineActionMinHeight(int height)

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

QWidget* actionWidget() const

Необязательный виджет действия, размещаемый в уведомлении.

void setActionWidget(QWidget* widget)

Необязательный виджет действия, размещаемый в уведомлении.

QMargins contentMargins() const

Поля вокруг области содержимого элемента управления.

void setContentMargins(const QMargins& margins)

Поля вокруг области содержимого элемента управления.

int closeButtonSize() const

Размер кнопки закрытия.

void setCloseButtonSize(int size)

Размер кнопки закрытия.

QString closeButtonAccessibleName() const

Пользовательское имя доступности для кнопки закрытия только со значком.

void setCloseButtonAccessibleName(const QString& name)

Пользовательское имя доступности для кнопки закрытия только со значком.

int iconTextSpacing() const

Расстояние между значком и текстовым содержимым.

void setIconTextSpacing(int spacing)

Расстояние между значком и текстовым содержимым.

int titleMessageSpacing() const

Расстояние между заголовком и текстом сообщения.

void setTitleMessageSpacing(int spacing)

Расстояние между заголовком и текстом сообщения.

int cornerRadius() const

Радиус скругления фона компонента.

void setCornerRadius(int radius)

Радиус скругления фона компонента.

int severityIconSize() const

Размер области фона, зарезервированной для значка серьёзности.

void setSeverityIconSize(int size)

Размер области фона, зарезервированной для значка серьёзности.

int severityIconGlyphSize() const

Размер глифа значка уровня важности.

void setSeverityIconGlyphSize(int size)

Размер глифа значка уровня важности.

int severityIconBackgroundInset() const

Внутренний отступ при отрисовке фона значка уровня важности.

void setSeverityIconBackgroundInset(int inset)

Внутренний отступ при отрисовке фона значка уровня важности.

Typography::FontRole titleFontRole() const

Пресет Fluent Typography для текста заголовка.

void setTitleFontRole(Typography::FontRole role)

Пресет Fluent Typography для текста заголовка.

Typography::FontRole messageFontRole() const

Пресет Fluent Typography для текста сообщения.

void setMessageFontRole(Typography::FontRole role)

Пресет Fluent Typography для текста сообщения.

QString informationalIconGlyph() const

Глиф значка для информационного уровня.

void setInformationalIconGlyph(const QString& glyph)

Глиф значка для информационного уровня.

QString successIconGlyph() const

Глиф значка для уровня успешного выполнения.

void setSuccessIconGlyph(const QString& glyph)

Глиф значка для уровня успешного выполнения.

QString warningIconGlyph() const

Глиф значка для уровня предупреждения.

void setWarningIconGlyph(const QString& glyph)

Глиф значка для уровня предупреждения.

QString errorIconGlyph() const

Глиф значка для уровня ошибки.

void setErrorIconGlyph(const QString& glyph)

Глиф значка для уровня ошибки.

Свойства

bool isOpen

Открыта ли информационная панель.

Чтение isOpen()Запись setIsOpen()Уведомление isOpenChanged()
QString title

Текст заголовка, отображаемый в информационной панели.

Чтение title()Запись setTitle()Уведомление titleChanged()
QString message

Основной текст сообщения в информационной панели.

Чтение message()Запись setMessage()Уведомление messageChanged()
InfoBarSeverity severity

Уровень серьёзности, определяющий цвета и иконку уведомления.

Чтение severity()Запись setSeverity()Уведомление severityChanged()
bool isClosable

Видима и доступна ли кнопка закрытия.

Чтение isClosable()Запись setIsClosable()Уведомление isClosableChanged()
bool isIconVisible

Видима ли иконка уровня важности.

Чтение isIconVisible()Запись setIsIconVisible()Уведомление isIconVisibleChanged()
bool singleLine

Использует ли уведомление компактную однострочную компоновку.

Чтение singleLine()Запись setSingleLine()Уведомление singleLineChanged()
int preferredWidth

Предпочтительная ширина, используемая макетом уведомлений.

Чтение preferredWidth()Запись setPreferredWidth()Уведомление preferredWidthChanged()
int singleLineHeight

Высота, используемая в однострочной компоновке уведомления.

Чтение singleLineHeight()Запись setSingleLineHeight()Уведомление singleLineHeightChanged()
int multiLineMinHeight

Минимальная высота для многострочной компоновки уведомления.

Чтение multiLineMinHeight()Запись setMultiLineMinHeight()Уведомление multiLineMinHeightChanged()
int multiLineActionMinHeight

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

Чтение multiLineActionMinHeight()Запись setMultiLineActionMinHeight()Уведомление multiLineActionMinHeightChanged()
QWidget* actionWidget

Необязательный виджет действия, размещаемый в уведомлении.

Чтение actionWidget()Запись setActionWidget()Уведомление actionWidgetChanged()
QMargins contentMargins

Поля вокруг области содержимого элемента управления.

Чтение contentMargins()Запись setContentMargins()Уведомление contentMarginsChanged()
int closeButtonSize

Размер кнопки закрытия.

Чтение closeButtonSize()Запись setCloseButtonSize()Уведомление closeButtonSizeChanged()
QString closeButtonAccessibleName

Пользовательское имя доступности для кнопки закрытия только со значком.

Чтение closeButtonAccessibleName()Запись setCloseButtonAccessibleName()Уведомление closeButtonAccessibleNameChanged()
int iconTextSpacing

Расстояние между значком и текстовым содержимым.

Чтение iconTextSpacing()Запись setIconTextSpacing()Уведомление iconTextSpacingChanged()
int titleMessageSpacing

Расстояние между заголовком и текстом сообщения.

Чтение titleMessageSpacing()Запись setTitleMessageSpacing()Уведомление titleMessageSpacingChanged()
int cornerRadius

Радиус скругления фона компонента.

Чтение cornerRadius()Запись setCornerRadius()Уведомление cornerRadiusChanged()
int severityIconSize

Размер области фона, зарезервированной для значка серьёзности.

Чтение severityIconSize()Запись setSeverityIconSize()Уведомление severityIconSizeChanged()
int severityIconGlyphSize

Размер глифа значка уровня важности.

Чтение severityIconGlyphSize()Запись setSeverityIconGlyphSize()Уведомление severityIconGlyphSizeChanged()
int severityIconBackgroundInset

Внутренний отступ при отрисовке фона значка уровня важности.

Чтение severityIconBackgroundInset()Запись setSeverityIconBackgroundInset()Уведомление severityIconBackgroundInsetChanged()
Typography::FontRole titleFontRole

Пресет Fluent Typography для текста заголовка.

Чтение titleFontRole()Запись setTitleFontRole()Уведомление titleFontRoleChanged()
Typography::FontRole messageFontRole

Пресет Fluent Typography для текста сообщения.

Чтение messageFontRole()Запись setMessageFontRole()Уведомление messageFontRoleChanged()
QString informationalIconGlyph

Глиф значка для информационного уровня.

Чтение informationalIconGlyph()Запись setInformationalIconGlyph()Уведомление informationalIconGlyphChanged()
QString successIconGlyph

Глиф значка для уровня успешного выполнения.

Чтение successIconGlyph()Запись setSuccessIconGlyph()Уведомление successIconGlyphChanged()
QString warningIconGlyph

Глиф значка для уровня предупреждения.

Чтение warningIconGlyph()Запись setWarningIconGlyph()Уведомление warningIconGlyphChanged()
QString errorIconGlyph

Глиф значка для уровня ошибки.

Чтение errorIconGlyph()Запись setErrorIconGlyph()Уведомление errorIconGlyphChanged()

Сигналы

void isOpenChanged(bool open)

Открыта ли информационная панель.

void titleChanged(const QString& title)

Текст заголовка, отображаемый в информационной панели.

void messageChanged(const QString& message)

Основной текст сообщения в информационной панели.

void severityChanged(InfoBarSeverity severity)

Уровень серьёзности, определяющий цвета и иконку уведомления.

void isClosableChanged(bool closable)

Видима и доступна ли кнопка закрытия.

void isIconVisibleChanged(bool visible)

Видима ли иконка уровня важности.

void singleLineChanged(bool singleLine)

Использует ли уведомление компактную однострочную компоновку.

void preferredWidthChanged(int width)

Предпочтительная ширина, используемая макетом уведомлений.

void singleLineHeightChanged(int height)

Высота, используемая в однострочной компоновке уведомления.

void multiLineMinHeightChanged(int height)

Минимальная высота для многострочной компоновки уведомления.

void multiLineActionMinHeightChanged(int height)

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

void actionWidgetChanged(QWidget* widget)

Необязательный виджет действия, размещаемый в уведомлении.

void contentMarginsChanged(const QMargins& margins)

Поля вокруг области содержимого элемента управления.

void closeButtonSizeChanged(int size)

Размер кнопки закрытия.

void closeButtonAccessibleNameChanged(const QString& name)

Пользовательское имя доступности для кнопки закрытия только со значком.

void iconTextSpacingChanged(int spacing)

Расстояние между значком и текстовым содержимым.

void titleMessageSpacingChanged(int spacing)

Расстояние между заголовком и текстом сообщения.

void cornerRadiusChanged(int radius)

Радиус скругления фона компонента.

void severityIconSizeChanged(int size)

Размер области фона, зарезервированной для значка серьёзности.

void severityIconGlyphSizeChanged(int size)

Размер глифа значка уровня важности.

void severityIconBackgroundInsetChanged(int inset)

Внутренний отступ при отрисовке фона значка уровня важности.

void titleFontRoleChanged(Typography::FontRole role)

Пресет Fluent Typography для текста заголовка.

void messageFontRoleChanged(Typography::FontRole role)

Пресет Fluent Typography для текста сообщения.

void informationalIconGlyphChanged(const QString& glyph)

Глиф значка для информационного уровня.

void successIconGlyphChanged(const QString& glyph)

Глиф значка для уровня успешного выполнения.

void warningIconGlyphChanged(const QString& glyph)

Глиф значка для уровня предупреждения.

void errorIconGlyphChanged(const QString& glyph)

Глиф значка для уровня ошибки.

Дополнения PySide6

takeActionWidget()

Освобождает и возвращает текущий виджет действия, передавая владение стороне Python.

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

Методы

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