Fluent-Qt

Status & info

Avatar

Represents a person or identity with an image, initials fallback, shape, size, and presence.

Example

Usage

Initials and sizes

Avatar generates a compact initials fallback from the caller-provided name and offers four token-aligned sizes.

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

auto* small = new Avatar("Ada Lovelace", this);
small->setAvatarSize(Avatar::AvatarSize::Small);

auto* medium = new Avatar("Grace Hopper", this);
medium->setAvatarSize(Avatar::AvatarSize::Medium);

auto* large = new Avatar("Lin Chen", this);
large->setAvatarSize(Avatar::AvatarSize::Large);

auto* extraLarge = new Avatar("Sam Rivera", this);
extraLarge->setAvatarSize(
    Avatar::AvatarSize::ExtraLarge);

import fluentqt

small = fluentqt.Avatar("Ada Lovelace")
small.setAvatarSize(fluentqt.Avatar.AvatarSize.Small)

medium = fluentqt.Avatar("Grace Hopper")
medium.setAvatarSize(fluentqt.Avatar.AvatarSize.Medium)

large = fluentqt.Avatar("Lin Chen")
large.setAvatarSize(fluentqt.Avatar.AvatarSize.Large)

extra_large = fluentqt.Avatar("Sam Rivera")
extra_large.setAvatarSize(fluentqt.Avatar.AvatarSize.ExtraLarge)

API

`fluent::status_info::Avatar`

Inherits QWidget · FluentElement · QMLPlus

Fluent identity image with initials fallback and optional presence status.

Constructors

explicit Avatar(QWidget* parent = nullptr)
explicit Avatar(const QString& name, QWidget* parent = nullptr)

Properties

QString name: Read name()Write setName()Notify nameChanged()
QString initials: Read initials()Write setInitials()Notify initialsChanged()
QPixmap image: Read image()Write setImage()Notify imageChanged()
AvatarShape shape: Read shape()Write setShape()Notify shapeChanged()
AvatarSize avatarSize: Read avatarSize()Write setAvatarSize()Notify avatarSizeChanged()
PresenceStatus presence: Read presence()Write setPresence()Notify presenceChanged()
QColor backgroundColor: Read backgroundColor()Write setBackgroundColor()Notify backgroundColorChanged()
QColor foregroundColor: Read foregroundColor()Write setForegroundColor()Notify foregroundColorChanged()

Signals

void nameChanged(const QString& name)
void initialsChanged(const QString& initials)
void imageChanged(const QPixmap& image)
void shapeChanged(AvatarShape shape)
void avatarSizeChanged(AvatarSize size)
void presenceChanged(PresenceStatus presence)
void backgroundColorChanged(const QColor& color)
void foregroundColorChanged(const QColor& color)

Enumerations

enum class AvatarShape: Avatar outline shape.
Circular
Square
enum class AvatarSize: Token-aligned avatar size presets in device-independent pixels.
Small = 24
Medium = 32
Large = 40
ExtraLarge = 56
enum class PresenceStatus: Presence state rendered by the composed InfoBadge.
None
Available
Away
Busy
DoNotDisturb
Offline

Subclass interfaces

Methods

void paintEvent(QPaintEvent* event) override
void resizeEvent(QResizeEvent* event) override
void changeEvent(QEvent* event) override

Inherited from fluent::FluentElement

Methods

static void setTheme(Theme theme): Updates the global theme and notifies active FluentElement instances.
static void setThemeDeferred(Theme theme): Schedules a visible-first batched theme refresh without blocking the current interaction.
static Theme currentTheme(): Returns the currently active global theme.
static bool themeUsesDarkAppearance(Theme theme): Returns whether a theme uses dark-backed chrome and material tokens.
static void refreshTheme(): Re-broadcasts the current theme to repaint after a design-token change.
static int themeGeneration(): Monotonic counter bumped on every theme change, for staleness checks.
Theme effectiveTheme() const: Resolves the theme used by this element, honoring an inherited QWidget override.
bool effectiveThemeUsesDarkAppearance() const: Returns whether this element's effective theme uses dark-backed chrome.
bool setThemeOverrides(const QJsonObject& overrides): Component-facing token accessors.
QJsonObject themeOverrides() const: Returns this element's authored overrides.
void clearThemeOverrides(): Restores all token fields to global theme defaults.
Colors themeColors() const
const Colors& themeColorsRef() const: Non-copying access to the active color set (for hot paint paths).
FontStyle themeFont(Typography::FontRole role = Typography::FontRole::Body) const
Radius themeRadius() const
Spacing themeSpacing() const
Animation themeAnimation() const
Material::AcrylicToken themeAcrylic() const: Material, elevation, and adaptive layout tokens.
Material::MicaToken themeMica() const
Material::SmokeToken themeSmoke() const
Elevation::ShadowParams themeShadow(Elevation::Level level) const
int themeBreakpoint(Breakpoints::Breakpoint breakpoint = Breakpoints::Breakpoint::Medium) const
QColor themeBackdrop(bool active) const: Window-chrome backdrop color for the given activation state.
virtual void onThemeUpdated(): Called after the global theme changes.

Enumerations

enum Theme: Global visual theme used when resolving design tokens.
Light = 0
Dark = 1
HighContrast = 2

Types and aliases

struct Colors: Design token snapshots returned to components.
struct FontStyle
struct Radius
struct Spacing
struct Animation

Inherited from fluent::QMLPlus

Methods

AnchorLayout::Anchors* anchors(): Returns mutable anchors for the QWidget host.
void setState(const QString& name): Applies a named state, or clears state when name is empty.
QString state() const
void addState(const QMLState& state): Registers or replaces a named state definition.
void evaluateStates(): Reevaluates conditions; the first registered true condition wins.
QMLPlusRuntime* runtime(): Returns the lazy host-owned state observation object.
void setAnchors(const AnchorLayout::Anchors& anchors): Replaces all host anchors and invalidates the parent layout.
void resetAnchors(): Clears all host anchors and invalidates the parent layout.
void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay): Binds a source property to a property on the QWidget host.
BindingHandle bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {}): Installs a managed direct binding on this QWidget host.
BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {}): Installs an explicit-dependency C++ expression on this QWidget host.
void addTransition(const StateTransition& transition): Registers a state transition in precedence order.
void setBehavior(const char* propertyName, const PropertyAnimation& animation): Sets the default animation for this host's managed property writes.
void clearBehavior(const char* propertyName): Removes the default animation for future managed writes.
bool writeProperty(const char* propertyName, const QVariant& value): Writes a host property through Behavior without removing its binding.

All inherited Qt members：QWidget