Основы
Иконки
Отображайте встроенные иконки 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)Пользовательский шрифт иконок
Загрузите TTF/OTF-файл через QFontDatabase и передайте имя семейства вместе со знаком иконки в 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(), чтобы программы чтения с экрана могли озвучить действие кнопки.