基礎指南
圖示
顯示內建 Fluent 圖示,或載入自訂 TTF/OTF 圖示字型檔。
使用具名圖示常數
請使用 Typography::Icons(C++)或 fluentqt.Icons(Python)中的具名常數,而非直接手寫 "\uE713" 等字元編碼。可直接傳入 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);import fluentqt
icon = fluentqt.FontIcon(fluentqt.Icons.Settings)
icon.setIconSize(fluentqt.IconSize.Standard)
btn = fluentqt.Button("Settings")
btn.setIconGlyph(fluentqt.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"));
}import fluentqt
from PySide6.QtGui import QFontDatabase
font_id = QFontDatabase.addApplicationFont(":/icons/application.ttf")
families = QFontDatabase.applicationFontFamilies(font_id)
if font_id >= 0 and families:
# Replace this codepoint with one defined by your font.
icon = fluentqt.FontIcon(chr(0xE064))
icon.setFontFamily(families[0])
icon.setIconSize(20)
icon.setAccessibleName("Application icon")常用尺寸與無障礙名稱
可使用 Typography::IconSize 預設尺寸:Compact(12px)適合小箭頭、Standard(16px)適合一般控制項、Large(20px)或 XLarge(24px)適合標題。純圖示按鈕請呼叫 setAccessibleName(),讓螢幕閱讀器能正確朗讀用途。