기초 가이드
아이콘
내장 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);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()을 호출하세요.