Статус и уведомления
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);import fluentqt
info = fluentqt.InfoBar()
info.setSeverity(fluentqt.InfoBar.InfoBarSeverity.Informational)
info.setTitle("Update available")
info.setMessage("Version 3.2 is ready.")
success = fluentqt.InfoBar()
success.setSeverity(fluentqt.InfoBar.InfoBarSeverity.Success)
success.setTitle("Saved")
success.setMessage("All changes were saved.")
warning = fluentqt.InfoBar()
warning.setSeverity(fluentqt.InfoBar.InfoBarSeverity.Warning)
warning.setTitle("Storage almost full")
warning.setMessage("Clear space before syncing.")
error = fluentqt.InfoBar()
error.setSeverity(fluentqt.InfoBar.InfoBarSeverity.Error)
error.setTitle("Upload failed")
error.setMessage("The document could not be saved.")API
ОбъявлениеНет подходящих элементов API.
fluent::status_info::InfoBar
Наследует QWidget · FluentElement · QMLPlus
Встроенная панель уведомлений Fluent с уровнями важности, опциональным виджетом действия и кнопкой закрытия. Отображает заголовок и сообщение со стилем статуса и состоянием открытия/закрытия.
Конструкторы
Деструкторы
Перечисления
enum InfoBarSeverityInformationalSuccessWarningError
Методы
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 = 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: QWidget