Fluent-Qt

Grundlagen

Symbole

Zeige mitgelieferte Fluent-Symbole oder Symbole aus deiner eigenen TTF/OTF-Schriftartdatei an.

Symbolnamen verwenden

Nutze benannte Konstanten aus Typography::Icons (C++) oder fluentqt.Icons (Python) statt roher Codepoints wie "\uE713". Übergib sie direkt an FontIcon oder Button.

#include <FluentQt/BasicInput.h>
#include <FluentQt/Foundation.h>

auto* icon = new fluent::FontIcon(Typography::Icons::Settings, this);
icon->setIconSize(Typography::IconSize::Standard);
auto* btn = new fluent::basicinput::Button("Settings", this);
btn->setIconGlyph(Typography::Icons::Settings);

Eigene Symbolschrift verwenden

Lade deine TTF/OTF-Datei über QFontDatabase und übergib den Familiennamen zusammen mit dem Symbolzeichen an FontIcon::setFontFamily(). Eigene Schriften werden direkt in iconSize gerendert und behalten Farbe, Deckkraft und Drehung bei. Eine leere Zeichenkette schaltet zurück zu den mitgelieferten Symbolen.

#include <FluentQt/Foundation.h>
#include <QFontDatabase>

const int id = QFontDatabase::addApplicationFont(
    QStringLiteral(":/icons/application.ttf"));
const QStringList families = QFontDatabase::applicationFontFamilies(id);
if (id >= 0 && !families.isEmpty()) {
    // Replace this codepoint with one defined by your font.
    auto* icon = new fluent::FontIcon(QStringLiteral("\uE064"), this);
    icon->setFontFamily(families.first());
    icon->setIconSize(20);
    icon->setAccessibleName(QStringLiteral("Application icon"));
}

Größen und Barrierefreiheit

Verwende die Vorgaben aus Typography::IconSize: Compact (12px) für kleine Pfeile, Standard (16px) für Steuerelemente und Large (20px) / XLarge (24px) für Überschriften. Setze bei reinen Symbolschaltflächen setAccessibleName(), damit Screenreader deren Funktion ansagen können.

API-Referenz