Fluent-Qt

Estado e información

InfoBar Barra de información

Una barra integrada para mensajes de estado con nivel de gravedad y acciones opcionales.

Ejemplo

InfoBar Barra de información: Gravedad

Uso

Gravedad

La gravedad cambia el icono inicial y el estilo de fondo de los mensajes de estado.

#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

Hereda de QWidget · FluentElement · QMLPlus

Barra de notificaciones en línea Fluent con niveles de gravedad, widget de acción opcional y botón de cierre. Muestra un título y un mensaje con estilo de estado y estado abierto/cerrado.

Constructores

Destructores

Enumeraciones

enum InfoBarSeverity
  • Informational
  • Success
  • Warning
  • Error

Métodos

bool isOpen() const

Indica si la barra de información está abierta.

void setIsOpen(bool open)

Indica si la barra de información está abierta.

QString title() const

Texto del título mostrado en la barra de información.

void setTitle(const QString& title)

Texto del título mostrado en la barra de información.

QString message() const

Texto del cuerpo del mensaje mostrado en la barra de información.

void setMessage(const QString& message)

Texto del cuerpo del mensaje mostrado en la barra de información.

InfoBarSeverity severity() const

Nivel de gravedad usado por los colores y el icono de la notificación.

void setSeverity(InfoBarSeverity severity)

Nivel de gravedad usado por los colores y el icono de la notificación.

bool isClosable() const

Indica si el control de cierre está visible y activo.

void setIsClosable(bool closable)

Indica si el control de cierre está visible y activo.

bool isIconVisible() const

Indica si es visible el icono de gravedad.

void setIsIconVisible(bool visible)

Indica si es visible el icono de gravedad.

bool singleLine() const

Indica si la notificación usa un diseño compacto de una sola línea.

void setSingleLine(bool singleLine)

Indica si la notificación usa un diseño compacto de una sola línea.

int preferredWidth() const

Ancho preferido usado por el diseño de notificaciones.

void setPreferredWidth(int width)

Ancho preferido usado por el diseño de notificaciones.

int singleLineHeight() const

Altura utilizada por el diseño de notificación de una sola línea.

void setSingleLineHeight(int height)

Altura utilizada por el diseño de notificación de una sola línea.

int multiLineMinHeight() const

Altura mínima usada por el diseño de notificación multilínea.

void setMultiLineMinHeight(int height)

Altura mínima usada por el diseño de notificación multilínea.

int multiLineActionMinHeight() const

Altura mínima cuando el diseño multilínea incluye acciones.

void setMultiLineActionMinHeight(int height)

Altura mínima cuando el diseño multilínea incluye acciones.

QWidget* actionWidget() const

Widget de acción opcional alojado en la notificación.

void setActionWidget(QWidget* widget)

Widget de acción opcional alojado en la notificación.

QMargins contentMargins() const

Márgenes aplicados alrededor del área de contenido del control.

void setContentMargins(const QMargins& margins)

Márgenes aplicados alrededor del área de contenido del control.

int closeButtonSize() const

Tamaño del botón de cerrar.

void setCloseButtonSize(int size)

Tamaño del botón de cerrar.

QString closeButtonAccessibleName() const

Nombre accesible personalizado para el botón de cierre de solo icono.

void setCloseButtonAccessibleName(const QString& name)

Nombre accesible personalizado para el botón de cierre de solo icono.

int iconTextSpacing() const

Espaciado entre el icono y el contenido de texto.

void setIconTextSpacing(int spacing)

Espaciado entre el icono y el contenido de texto.

int titleMessageSpacing() const

Espaciado entre el título y el texto del mensaje.

void setTitleMessageSpacing(int spacing)

Espaciado entre el título y el texto del mensaje.

int cornerRadius() const

Radio de esquina usado por el fondo del componente.

void setCornerRadius(int radius)

Radio de esquina usado por el fondo del componente.

int severityIconSize() const

Tamaño de fondo reservado para el icono de gravedad.

void setSeverityIconSize(int size)

Tamaño de fondo reservado para el icono de gravedad.

int severityIconGlyphSize() const

Tamaño del glifo usado por el icono de gravedad.

void setSeverityIconGlyphSize(int size)

Tamaño del glifo usado por el icono de gravedad.

int severityIconBackgroundInset() const

Margen interior aplicado al pintado del fondo del icono de gravedad.

void setSeverityIconBackgroundInset(int inset)

Margen interior aplicado al pintado del fondo del icono de gravedad.

Typography::FontRole titleFontRole() const

Preajuste de Fluent Typography usado por el texto del título.

void setTitleFontRole(Typography::FontRole role)

Preajuste de Fluent Typography usado por el texto del título.

Typography::FontRole messageFontRole() const

Preajuste de Fluent Typography usado por el texto del mensaje.

void setMessageFontRole(Typography::FontRole role)

Preajuste de Fluent Typography usado por el texto del mensaje.

QString informationalIconGlyph() const

Glifo de icono usado para el nivel de gravedad informativo.

void setInformationalIconGlyph(const QString& glyph)

Glifo de icono usado para el nivel de gravedad informativo.

QString successIconGlyph() const

Glifo de icono usado para el nivel de gravedad de éxito.

void setSuccessIconGlyph(const QString& glyph)

Glifo de icono usado para el nivel de gravedad de éxito.

QString warningIconGlyph() const

Glifo de icono usado para el nivel de gravedad de advertencia.

void setWarningIconGlyph(const QString& glyph)

Glifo de icono usado para el nivel de gravedad de advertencia.

QString errorIconGlyph() const

Glifo de icono usado para el nivel de gravedad de error.

void setErrorIconGlyph(const QString& glyph)

Glifo de icono usado para el nivel de gravedad de error.

Propiedades

bool isOpen

Indica si la barra de información está abierta.

Lectura isOpen()Escritura setIsOpen()Notificación isOpenChanged()
QString title

Texto del título mostrado en la barra de información.

Lectura title()Escritura setTitle()Notificación titleChanged()
QString message

Texto del cuerpo del mensaje mostrado en la barra de información.

Lectura message()Escritura setMessage()Notificación messageChanged()
InfoBarSeverity severity

Nivel de gravedad usado por los colores y el icono de la notificación.

Lectura severity()Escritura setSeverity()Notificación severityChanged()
bool isClosable

Indica si el control de cierre está visible y activo.

Lectura isClosable()Escritura setIsClosable()Notificación isClosableChanged()
bool isIconVisible

Indica si es visible el icono de gravedad.

Lectura isIconVisible()Escritura setIsIconVisible()Notificación isIconVisibleChanged()
bool singleLine

Indica si la notificación usa un diseño compacto de una sola línea.

Lectura singleLine()Escritura setSingleLine()Notificación singleLineChanged()
int preferredWidth

Ancho preferido usado por el diseño de notificaciones.

Lectura preferredWidth()Escritura setPreferredWidth()Notificación preferredWidthChanged()
int singleLineHeight

Altura utilizada por el diseño de notificación de una sola línea.

Lectura singleLineHeight()Escritura setSingleLineHeight()Notificación singleLineHeightChanged()
int multiLineMinHeight

Altura mínima usada por el diseño de notificación multilínea.

Lectura multiLineMinHeight()Escritura setMultiLineMinHeight()Notificación multiLineMinHeightChanged()
int multiLineActionMinHeight

Altura mínima cuando el diseño multilínea incluye acciones.

Lectura multiLineActionMinHeight()Escritura setMultiLineActionMinHeight()Notificación multiLineActionMinHeightChanged()
QWidget* actionWidget

Widget de acción opcional alojado en la notificación.

Lectura actionWidget()Escritura setActionWidget()Notificación actionWidgetChanged()
QMargins contentMargins

Márgenes aplicados alrededor del área de contenido del control.

Lectura contentMargins()Escritura setContentMargins()Notificación contentMarginsChanged()
int closeButtonSize

Tamaño del botón de cerrar.

Lectura closeButtonSize()Escritura setCloseButtonSize()Notificación closeButtonSizeChanged()
QString closeButtonAccessibleName

Nombre accesible personalizado para el botón de cierre de solo icono.

Lectura closeButtonAccessibleName()Escritura setCloseButtonAccessibleName()Notificación closeButtonAccessibleNameChanged()
int iconTextSpacing

Espaciado entre el icono y el contenido de texto.

Lectura iconTextSpacing()Escritura setIconTextSpacing()Notificación iconTextSpacingChanged()
int titleMessageSpacing

Espaciado entre el título y el texto del mensaje.

Lectura titleMessageSpacing()Escritura setTitleMessageSpacing()Notificación titleMessageSpacingChanged()
int cornerRadius

Radio de esquina usado por el fondo del componente.

Lectura cornerRadius()Escritura setCornerRadius()Notificación cornerRadiusChanged()
int severityIconSize

Tamaño de fondo reservado para el icono de gravedad.

Lectura severityIconSize()Escritura setSeverityIconSize()Notificación severityIconSizeChanged()
int severityIconGlyphSize

Tamaño del glifo usado por el icono de gravedad.

Lectura severityIconGlyphSize()Escritura setSeverityIconGlyphSize()Notificación severityIconGlyphSizeChanged()
int severityIconBackgroundInset

Margen interior aplicado al pintado del fondo del icono de gravedad.

Lectura severityIconBackgroundInset()Escritura setSeverityIconBackgroundInset()Notificación severityIconBackgroundInsetChanged()
Typography::FontRole titleFontRole

Preajuste de Fluent Typography usado por el texto del título.

Lectura titleFontRole()Escritura setTitleFontRole()Notificación titleFontRoleChanged()
Typography::FontRole messageFontRole

Preajuste de Fluent Typography usado por el texto del mensaje.

Lectura messageFontRole()Escritura setMessageFontRole()Notificación messageFontRoleChanged()
QString informationalIconGlyph

Glifo de icono usado para el nivel de gravedad informativo.

Lectura informationalIconGlyph()Escritura setInformationalIconGlyph()Notificación informationalIconGlyphChanged()
QString successIconGlyph

Glifo de icono usado para el nivel de gravedad de éxito.

Lectura successIconGlyph()Escritura setSuccessIconGlyph()Notificación successIconGlyphChanged()
QString warningIconGlyph

Glifo de icono usado para el nivel de gravedad de advertencia.

Lectura warningIconGlyph()Escritura setWarningIconGlyph()Notificación warningIconGlyphChanged()
QString errorIconGlyph

Glifo de icono usado para el nivel de gravedad de error.

Lectura errorIconGlyph()Escritura setErrorIconGlyph()Notificación errorIconGlyphChanged()

Señales

void isOpenChanged(bool open)

Indica si la barra de información está abierta.

void titleChanged(const QString& title)

Texto del título mostrado en la barra de información.

void messageChanged(const QString& message)

Texto del cuerpo del mensaje mostrado en la barra de información.

void severityChanged(InfoBarSeverity severity)

Nivel de gravedad usado por los colores y el icono de la notificación.

void isClosableChanged(bool closable)

Indica si el control de cierre está visible y activo.

void isIconVisibleChanged(bool visible)

Indica si es visible el icono de gravedad.

void singleLineChanged(bool singleLine)

Indica si la notificación usa un diseño compacto de una sola línea.

void preferredWidthChanged(int width)

Ancho preferido usado por el diseño de notificaciones.

void singleLineHeightChanged(int height)

Altura utilizada por el diseño de notificación de una sola línea.

void multiLineMinHeightChanged(int height)

Altura mínima usada por el diseño de notificación multilínea.

void multiLineActionMinHeightChanged(int height)

Altura mínima cuando el diseño multilínea incluye acciones.

void actionWidgetChanged(QWidget* widget)

Widget de acción opcional alojado en la notificación.

void contentMarginsChanged(const QMargins& margins)

Márgenes aplicados alrededor del área de contenido del control.

void closeButtonSizeChanged(int size)

Tamaño del botón de cerrar.

void closeButtonAccessibleNameChanged(const QString& name)

Nombre accesible personalizado para el botón de cierre de solo icono.

void iconTextSpacingChanged(int spacing)

Espaciado entre el icono y el contenido de texto.

void titleMessageSpacingChanged(int spacing)

Espaciado entre el título y el texto del mensaje.

void cornerRadiusChanged(int radius)

Radio de esquina usado por el fondo del componente.

void severityIconSizeChanged(int size)

Tamaño de fondo reservado para el icono de gravedad.

void severityIconGlyphSizeChanged(int size)

Tamaño del glifo usado por el icono de gravedad.

void severityIconBackgroundInsetChanged(int inset)

Margen interior aplicado al pintado del fondo del icono de gravedad.

void titleFontRoleChanged(Typography::FontRole role)

Preajuste de Fluent Typography usado por el texto del título.

void messageFontRoleChanged(Typography::FontRole role)

Preajuste de Fluent Typography usado por el texto del mensaje.

void informationalIconGlyphChanged(const QString& glyph)

Glifo de icono usado para el nivel de gravedad informativo.

void successIconGlyphChanged(const QString& glyph)

Glifo de icono usado para el nivel de gravedad de éxito.

void warningIconGlyphChanged(const QString& glyph)

Glifo de icono usado para el nivel de gravedad de advertencia.

void errorIconGlyphChanged(const QString& glyph)

Glifo de icono usado para el nivel de gravedad de error.

Adiciones de PySide6

takeActionWidget()

Retira y devuelve el widget de acción actual, transfiriendo su propiedad a Python.

Miembros protegidos

Métodos

Heredado de fluent::FluentElement

Enumeraciones

enum Theme

Tema visual global usado al resolver los tokens de diseño.

  • Light = 0
  • Dark = 1
  • HighContrast = 2

Métodos

static void setTheme(Theme theme)

Actualiza el tema global y notifica a las instancias activas de FluentElement.

static void setThemeDeferred(Theme theme)

Programa una actualización de tema por lotes dando prioridad a lo visible sin bloquear la interacción actual.

static Theme currentTheme()

Devuelve el tema global activo actualmente.

static bool themeUsesDarkAppearance(Theme theme)

Devuelve si un tema utiliza cromo sobre fondo oscuro y tokens de material.

static void refreshTheme()

Vuelve a difundir el tema actual para repintar tras un cambio de token de diseño.

static int themeGeneration()

Contador monótono incrementado en cada cambio de tema para comprobaciones de obsolescencia.

Theme effectiveTheme() const

Resuelve el tema usado por este elemento, respetando una invalidación heredada de QWidget.

bool effectiveThemeUsesDarkAppearance() const

Devuelve si el tema efectivo de este elemento usa cromo sobre fondo oscuro.

bool setThemeOverrides(const QJsonObject& overrides)

Reemplaza las invalidaciones dispersas de tokens de color, radio y fuente de este elemento.

QJsonObject themeOverrides() const

Devuelve las anulaciones definidas en este elemento.

void clearThemeOverrides()

Restaura todos los campos de token a los valores predeterminados del tema global.

const Colors& themeColorsRef() const

Acceso sin copia al conjunto de colores activo para rutas críticas de pintado.

Material::AcrylicToken themeAcrylic() const

Tokens de material, elevación y diseño adaptable.

QColor themeBackdrop(bool active) const

Color de fondo del chrome de la ventana para el estado de activación indicado.

virtual void onThemeUpdated()

Se llama después de que cambia el tema global.

Tipos y alias

struct Colors

Instantáneas de tokens de diseño devueltas a los componentes.

Heredado de fluent::QMLPlus

Métodos

AnchorLayout::Anchors* anchors()

Devuelve los anclajes mutables del host QWidget.

void setState(const QString& name)

Aplica un estado registrado por nombre o restaura el estado predeterminado cuando @p name está vacío. Los nombres desconocidos se ignoran y los enlaces existentes se reanudan al salir del estado.

void addState(const QMLState& state)

Registra o reemplaza una definición de estado con nombre; reemplazar el estado activo lo aplica de inmediato.

void evaluateStates()

Reevalúa las condiciones de estado en orden de registro y activa la primera coincidencia, o el estado predeterminado si ninguna coincide. También se ejecuta automáticamente cuando notifican las propiedades dependientes; los estados derivados que usan extend heredan cambios de ancestros salvo que sean cíclicos o falten.

QMLPlusRuntime* runtime()

Devuelve el observador de estado creado de forma diferida y propiedad de este host.

void setAnchors(const AnchorLayout::Anchors& anchors)

Reemplaza todos los anclajes del host e invalida el diseño padre.

void resetAnchors()

Limpia todos los anclajes del host e invalida el diseño padre.

void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)

Vincula @p sourceProp en @p source con @p targetProp en este host QWidget mediante PropertyBinder::bind().

void addTransition(const StateTransition& transition)

Registra una transición de estado por orden de precedencia.

void setBehavior(const char* propertyName, const PropertyAnimation& animation)

Establece la animación por defecto usada al escribir @p propertyName mediante writeProperty() o un enlace. Las reglas StateTransition explícitas tienen prioridad; las llamadas directas a setters de C++ no se animan.

void clearBehavior(const char* propertyName)

Quita la animación predeterminada para futuras escrituras administradas.

bool writeProperty(const char* propertyName, const QVariant& value)

Escribe una propiedad del host mediante Behavior sin eliminar su enlace.

Documentación de la clase base de Qt: QWidget