Fluent-Qt

État et informations

InfoBar Barre d'information

Une barre intégrée pour afficher des messages d'état avec un niveau de gravité et des actions facultatives.

Exemple

InfoBar Barre d'information: Gravité

Utilisation

Gravité

La gravité modifie l'icône de début et l'aspect d'arrière-plan des messages d'état.

#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

Hérite de QWidget · FluentElement · QMLPlus

Barre de notification en ligne Fluent avec niveaux de gravité, widget d'action optionnel et bouton de fermeture. Affiche un titre et un message avec style d'état et état ouvert/fermé.

Constructeurs

Destructeurs

Énumérations

enum InfoBarSeverity
  • Informational
  • Success
  • Warning
  • Error

Méthodes

bool isOpen() const

Indique si la barre d'information est ouverte.

void setIsOpen(bool open)

Indique si la barre d'information est ouverte.

QString title() const

Texte du titre affiché dans la barre d'information.

void setTitle(const QString& title)

Texte du titre affiché dans la barre d'information.

QString message() const

Texte du corps du message affiché dans la barre d'informations.

void setMessage(const QString& message)

Texte du corps du message affiché dans la barre d'informations.

InfoBarSeverity severity() const

Niveau de gravité utilisé par les couleurs et l'icône de notification.

void setSeverity(InfoBarSeverity severity)

Niveau de gravité utilisé par les couleurs et l'icône de notification.

bool isClosable() const

Indique si le bouton de fermeture est visible et actif.

void setIsClosable(bool closable)

Indique si le bouton de fermeture est visible et actif.

bool isIconVisible() const

Indique si l'icône de gravité est visible.

void setIsIconVisible(bool visible)

Indique si l'icône de gravité est visible.

bool singleLine() const

Indique si la notification utilise une disposition compacte sur une seule ligne.

void setSingleLine(bool singleLine)

Indique si la notification utilise une disposition compacte sur une seule ligne.

int preferredWidth() const

Largeur préférée utilisée par la disposition des notifications.

void setPreferredWidth(int width)

Largeur préférée utilisée par la disposition des notifications.

int singleLineHeight() const

Hauteur utilisée par la disposition de notification sur une seule ligne.

void setSingleLineHeight(int height)

Hauteur utilisée par la disposition de notification sur une seule ligne.

int multiLineMinHeight() const

Hauteur minimale utilisée par la disposition de notification multiligne.

void setMultiLineMinHeight(int height)

Hauteur minimale utilisée par la disposition de notification multiligne.

int multiLineActionMinHeight() const

Hauteur minimale lorsque la disposition multiligne inclut des actions.

void setMultiLineActionMinHeight(int height)

Hauteur minimale lorsque la disposition multiligne inclut des actions.

QWidget* actionWidget() const

Widget d'action optionnel hébergé par la notification.

void setActionWidget(QWidget* widget)

Widget d'action optionnel hébergé par la notification.

QMargins contentMargins() const

Marges appliquées autour de la zone de contenu du contrôle.

void setContentMargins(const QMargins& margins)

Marges appliquées autour de la zone de contenu du contrôle.

int closeButtonSize() const

Taille du bouton de fermeture.

void setCloseButtonSize(int size)

Taille du bouton de fermeture.

QString closeButtonAccessibleName() const

Nom d'accessibilité personnalisé pour le bouton de fermeture à icône seule.

void setCloseButtonAccessibleName(const QString& name)

Nom d'accessibilité personnalisé pour le bouton de fermeture à icône seule.

int iconTextSpacing() const

Espacement entre l'icône et le contenu textuel.

void setIconTextSpacing(int spacing)

Espacement entre l'icône et le contenu textuel.

int titleMessageSpacing() const

Espacement entre le titre et le texte du message.

void setTitleMessageSpacing(int spacing)

Espacement entre le titre et le texte du message.

int cornerRadius() const

Rayon d'arrondi utilisé pour l'arrière-plan du composant.

void setCornerRadius(int radius)

Rayon d'arrondi utilisé pour l'arrière-plan du composant.

int severityIconSize() const

Taille d'arrière-plan réservée à l'icône de gravité.

void setSeverityIconSize(int size)

Taille d'arrière-plan réservée à l'icône de gravité.

int severityIconGlyphSize() const

Taille de glyphe utilisée par l'icône de gravité.

void setSeverityIconGlyphSize(int size)

Taille de glyphe utilisée par l'icône de gravité.

int severityIconBackgroundInset() const

Retrait appliqué au dessin d'arrière-plan de l'icône de gravité.

void setSeverityIconBackgroundInset(int inset)

Retrait appliqué au dessin d'arrière-plan de l'icône de gravité.

Typography::FontRole titleFontRole() const

Préréglage Fluent Typography utilisé pour le texte du titre.

void setTitleFontRole(Typography::FontRole role)

Préréglage Fluent Typography utilisé pour le texte du titre.

Typography::FontRole messageFontRole() const

Préréglage Fluent Typography utilisé pour le texte du message.

void setMessageFontRole(Typography::FontRole role)

Préréglage Fluent Typography utilisé pour le texte du message.

QString informationalIconGlyph() const

Glyphe d'icône utilisé pour la gravité informative.

void setInformationalIconGlyph(const QString& glyph)

Glyphe d'icône utilisé pour la gravité informative.

QString successIconGlyph() const

Glyphe d'icône utilisé pour la gravité de succès.

void setSuccessIconGlyph(const QString& glyph)

Glyphe d'icône utilisé pour la gravité de succès.

QString warningIconGlyph() const

Glyphe d'icône utilisé pour la gravité d'avertissement.

void setWarningIconGlyph(const QString& glyph)

Glyphe d'icône utilisé pour la gravité d'avertissement.

QString errorIconGlyph() const

Glyphe d'icône utilisé pour la gravité d'erreur.

void setErrorIconGlyph(const QString& glyph)

Glyphe d'icône utilisé pour la gravité d'erreur.

Propriétés

bool isOpen

Indique si la barre d'information est ouverte.

Lecture isOpen()Écriture setIsOpen()Notification isOpenChanged()
QString title

Texte du titre affiché dans la barre d'information.

Lecture title()Écriture setTitle()Notification titleChanged()
QString message

Texte du corps du message affiché dans la barre d'informations.

Lecture message()Écriture setMessage()Notification messageChanged()
InfoBarSeverity severity

Niveau de gravité utilisé par les couleurs et l'icône de notification.

Lecture severity()Écriture setSeverity()Notification severityChanged()
bool isClosable

Indique si le bouton de fermeture est visible et actif.

Lecture isClosable()Écriture setIsClosable()Notification isClosableChanged()
bool isIconVisible

Indique si l'icône de gravité est visible.

Lecture isIconVisible()Écriture setIsIconVisible()Notification isIconVisibleChanged()
bool singleLine

Indique si la notification utilise une disposition compacte sur une seule ligne.

Lecture singleLine()Écriture setSingleLine()Notification singleLineChanged()
int preferredWidth

Largeur préférée utilisée par la disposition des notifications.

Lecture preferredWidth()Écriture setPreferredWidth()Notification preferredWidthChanged()
int singleLineHeight

Hauteur utilisée par la disposition de notification sur une seule ligne.

Lecture singleLineHeight()Écriture setSingleLineHeight()Notification singleLineHeightChanged()
int multiLineMinHeight

Hauteur minimale utilisée par la disposition de notification multiligne.

Lecture multiLineMinHeight()Écriture setMultiLineMinHeight()Notification multiLineMinHeightChanged()
int multiLineActionMinHeight

Hauteur minimale lorsque la disposition multiligne inclut des actions.

Lecture multiLineActionMinHeight()Écriture setMultiLineActionMinHeight()Notification multiLineActionMinHeightChanged()
QWidget* actionWidget

Widget d'action optionnel hébergé par la notification.

Lecture actionWidget()Écriture setActionWidget()Notification actionWidgetChanged()
QMargins contentMargins

Marges appliquées autour de la zone de contenu du contrôle.

Lecture contentMargins()Écriture setContentMargins()Notification contentMarginsChanged()
int closeButtonSize

Taille du bouton de fermeture.

Lecture closeButtonSize()Écriture setCloseButtonSize()Notification closeButtonSizeChanged()
QString closeButtonAccessibleName

Nom d'accessibilité personnalisé pour le bouton de fermeture à icône seule.

Lecture closeButtonAccessibleName()Écriture setCloseButtonAccessibleName()Notification closeButtonAccessibleNameChanged()
int iconTextSpacing

Espacement entre l'icône et le contenu textuel.

Lecture iconTextSpacing()Écriture setIconTextSpacing()Notification iconTextSpacingChanged()
int titleMessageSpacing

Espacement entre le titre et le texte du message.

Lecture titleMessageSpacing()Écriture setTitleMessageSpacing()Notification titleMessageSpacingChanged()
int cornerRadius

Rayon d'arrondi utilisé pour l'arrière-plan du composant.

Lecture cornerRadius()Écriture setCornerRadius()Notification cornerRadiusChanged()
int severityIconSize

Taille d'arrière-plan réservée à l'icône de gravité.

Lecture severityIconSize()Écriture setSeverityIconSize()Notification severityIconSizeChanged()
int severityIconGlyphSize

Taille de glyphe utilisée par l'icône de gravité.

Lecture severityIconGlyphSize()Écriture setSeverityIconGlyphSize()Notification severityIconGlyphSizeChanged()
int severityIconBackgroundInset

Retrait appliqué au dessin d'arrière-plan de l'icône de gravité.

Lecture severityIconBackgroundInset()Écriture setSeverityIconBackgroundInset()Notification severityIconBackgroundInsetChanged()
Typography::FontRole titleFontRole

Préréglage Fluent Typography utilisé pour le texte du titre.

Lecture titleFontRole()Écriture setTitleFontRole()Notification titleFontRoleChanged()
Typography::FontRole messageFontRole

Préréglage Fluent Typography utilisé pour le texte du message.

Lecture messageFontRole()Écriture setMessageFontRole()Notification messageFontRoleChanged()
QString informationalIconGlyph

Glyphe d'icône utilisé pour la gravité informative.

Lecture informationalIconGlyph()Écriture setInformationalIconGlyph()Notification informationalIconGlyphChanged()
QString successIconGlyph

Glyphe d'icône utilisé pour la gravité de succès.

Lecture successIconGlyph()Écriture setSuccessIconGlyph()Notification successIconGlyphChanged()
QString warningIconGlyph

Glyphe d'icône utilisé pour la gravité d'avertissement.

Lecture warningIconGlyph()Écriture setWarningIconGlyph()Notification warningIconGlyphChanged()
QString errorIconGlyph

Glyphe d'icône utilisé pour la gravité d'erreur.

Lecture errorIconGlyph()Écriture setErrorIconGlyph()Notification errorIconGlyphChanged()

Signaux

void isOpenChanged(bool open)

Indique si la barre d'information est ouverte.

void titleChanged(const QString& title)

Texte du titre affiché dans la barre d'information.

void messageChanged(const QString& message)

Texte du corps du message affiché dans la barre d'informations.

void severityChanged(InfoBarSeverity severity)

Niveau de gravité utilisé par les couleurs et l'icône de notification.

void isClosableChanged(bool closable)

Indique si le bouton de fermeture est visible et actif.

void isIconVisibleChanged(bool visible)

Indique si l'icône de gravité est visible.

void singleLineChanged(bool singleLine)

Indique si la notification utilise une disposition compacte sur une seule ligne.

void preferredWidthChanged(int width)

Largeur préférée utilisée par la disposition des notifications.

void singleLineHeightChanged(int height)

Hauteur utilisée par la disposition de notification sur une seule ligne.

void multiLineMinHeightChanged(int height)

Hauteur minimale utilisée par la disposition de notification multiligne.

void multiLineActionMinHeightChanged(int height)

Hauteur minimale lorsque la disposition multiligne inclut des actions.

void actionWidgetChanged(QWidget* widget)

Widget d'action optionnel hébergé par la notification.

void contentMarginsChanged(const QMargins& margins)

Marges appliquées autour de la zone de contenu du contrôle.

void closeButtonSizeChanged(int size)

Taille du bouton de fermeture.

void closeButtonAccessibleNameChanged(const QString& name)

Nom d'accessibilité personnalisé pour le bouton de fermeture à icône seule.

void iconTextSpacingChanged(int spacing)

Espacement entre l'icône et le contenu textuel.

void titleMessageSpacingChanged(int spacing)

Espacement entre le titre et le texte du message.

void cornerRadiusChanged(int radius)

Rayon d'arrondi utilisé pour l'arrière-plan du composant.

void severityIconSizeChanged(int size)

Taille d'arrière-plan réservée à l'icône de gravité.

void severityIconGlyphSizeChanged(int size)

Taille de glyphe utilisée par l'icône de gravité.

void severityIconBackgroundInsetChanged(int inset)

Retrait appliqué au dessin d'arrière-plan de l'icône de gravité.

void titleFontRoleChanged(Typography::FontRole role)

Préréglage Fluent Typography utilisé pour le texte du titre.

void messageFontRoleChanged(Typography::FontRole role)

Préréglage Fluent Typography utilisé pour le texte du message.

void informationalIconGlyphChanged(const QString& glyph)

Glyphe d'icône utilisé pour la gravité informative.

void successIconGlyphChanged(const QString& glyph)

Glyphe d'icône utilisé pour la gravité de succès.

void warningIconGlyphChanged(const QString& glyph)

Glyphe d'icône utilisé pour la gravité d'avertissement.

void errorIconGlyphChanged(const QString& glyph)

Glyphe d'icône utilisé pour la gravité d'erreur.

Ajouts PySide6

takeActionWidget()

Détache et renvoie le widget d’action courant en transférant sa propriété à Python.

Membres protégés

Méthodes

Hérité de fluent::FluentElement

Énumérations

enum Theme

Thème visuel global utilisé lors de la résolution des tokens de design.

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

Méthodes

static void setTheme(Theme theme)

Met à jour le thème global et notifie les instances FluentElement actives.

static void setThemeDeferred(Theme theme)

Planifie une actualisation par lots du thème en donnant la priorité aux éléments visibles sans bloquer l'interaction en cours.

static Theme currentTheme()

Retourne le thème global actuellement actif.

static bool themeUsesDarkAppearance(Theme theme)

Indique si un thème utilise un habillage à fond sombre et des jetons de matériau.

static void refreshTheme()

Rediffuse le thème actuel pour redessiner après une modification de jeton de design.

static int themeGeneration()

Compteur monotone incrémenté à chaque changement de thème pour la vérification d'obsolescence.

Theme effectiveTheme() const

Résout le thème utilisé par cet élément, en respectant une surcharge héritée de QWidget.

bool effectiveThemeUsesDarkAppearance() const

Indique si le thème effectif de cet élément utilise un habillage à fond sombre.

bool setThemeOverrides(const QJsonObject& overrides)

Remplace les surcharges éparses de jetons de couleur, de rayon et de police de cet élément.

QJsonObject themeOverrides() const

Renvoie les surcharges définies pour cet élément.

void clearThemeOverrides()

Restaure tous les champs de tokens aux valeurs par défaut du thème global.

const Colors& themeColorsRef() const

Accès sans copie au jeu de couleurs actif pour les chemins de peinture critiques.

Material::AcrylicToken themeAcrylic() const

Jetons de matériau, d'élévation et de mise en page adaptative.

QColor themeBackdrop(bool active) const

Couleur d'arrière-plan du chrome de fenêtre pour l'état d'activation donné.

virtual void onThemeUpdated()

Appelé après un changement du thème global.

Types et alias

struct Colors

Instantanés de tokens de design renvoyés aux composants.

Hérité de fluent::QMLPlus

Méthodes

AnchorLayout::Anchors* anchors()

Retourne les ancres modifiables pour l'hôte QWidget.

void setState(const QString& name)

Applique un état enregistré par son nom, ou restaure l'état par défaut lorsque @p name est vide. Les noms inconnus sont ignorés et les liaisons existantes reprennent à la sortie de l'état.

void addState(const QMLState& state)

Enregistre ou remplace une définition d'état nommée ; remplacer l'état actif l'applique immédiatement.

void evaluateStates()

Réévalue les conditions d'état dans l'ordre d'enregistrement et active la première correspondance, ou l'état par défaut si aucune ne correspond. S'exécute aussi automatiquement lorsque les propriétés dépendantes notifient ; les états dérivés utilisant extend héritent des modifications ancêtres sauf en cas de cycle ou d'absence.

QMLPlusRuntime* runtime()

Retourne l'observateur d'état créé à la demande et détenu par cet hôte.

void setAnchors(const AnchorLayout::Anchors& anchors)

Remplace toutes les ancres de l'hôte et invalide la mise en page parente.

void resetAnchors()

Efface tous les ancrages de l'hôte et invalide la mise en page parente.

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

Lie @p sourceProp sur @p source à @p targetProp sur cet hôte QWidget via PropertyBinder::bind().

void addTransition(const StateTransition& transition)

Enregistre une transition d'état par ordre de priorité.

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

Définit l'animation par défaut utilisée lorsque @p propertyName est modifié via writeProperty() ou une liaison. Les règles StateTransition explicites ont la priorité ; les appels directs aux setters C++ ne sont pas animés.

void clearBehavior(const char* propertyName)

Supprime l'animation par défaut pour les futures écritures gérées.

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

Écrit une propriété hôte via Behavior sans supprimer sa liaison.

Documentation de la classe de base Qt : QWidget