Fluent-Qt

基礎ガイド

アイコン

内蔵の Fluent アイコンや、独自の TTF/OTF フォントファイルのアイコンを表示します。

アイコン名の利用

"\uE713" のような生のコードポイントではなく、Typography::Icons(C++)または fluentqt.Icons(Python)の名前付き定数を使用してください。そのまま FontIcon や 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);

カスタムアイコンフォントの利用

QFontDatabase で TTF/OTF ファイルを読み込み、そのファミリ名とアイコン文字を FontIcon::setFontFamily() に渡します。カスタムフォントは色・不透明度・回転を維持したまま iconSize で直接描画されます。内蔵アイコンに戻すには空文字列を渡してください。

#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"));
}

サイズとアクセシビリティ

Typography::IconSize のプリセットを使用します:小さな矢印には Compact(12px)、通常コントロールには Standard(16px)、見出しには Large(20px)や XLarge(24px)が適しています。アイコンのみのボタンでは、スクリーンリーダーが用途を読み上げられるよう setAccessibleName() を設定してください。

API リファレンス