Класс QFontInfo
Класс QFontInfo предоставляет общую информацию о шрифтах. Подробнее...
| Заголовок: | #include <QFontInfo> |
| CMake: | find_package(Qt6 COMPONENTS Gui REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
Примечание: Все функции в этом классе являются повторно-входными.
Открытые функции
| QFontInfo(const QFontInfo &fi) | |
| QFontInfo(const QFont &font) | |
| QFontInfo & | operator=(const QFontInfo &fi) |
| ~QFontInfo() | |
| bool | bold() const |
| bool | exactMatch() const |
| QString | family() const |
| bool | fixedPitch() const |
| bool | italic() const |
| int | pixelSize() const |
| int | pointSize() const |
| qreal | pointSizeF() const |
| QFont::Style | style() const |
| QFont::StyleHint | styleHint() const |
| QString | styleName() const |
| void | swap(QFontInfo &other) |
| int | weight() const |
Подробное описание
Класс QFontInfo предоставляет те же функции доступа, что и QFont, например, family(), pointSize(), italic(), weight(), fixedPitch(), styleHint() и т. д. Но в то время как функции доступа QFont возвращают значения, которые были установлены, объект QFontInfo возвращает значения, которые применяются к шрифту, который фактически будет использоваться для отрисовки текста.
Например, когда программа запрашивает шрифт Courier 25pt на компьютере, на котором есть несжимаемый шрифт Courier 24pt, QFont (обычно) использует шрифт Courier 24pt для отрисовки. В этом случае QFont::pointSize() возвращает 25, а QFontInfo::pointSize() возвращает 24.
Существует три способа создания объекта QFontInfo.
- Вызов конструктора QFontInfo с QFont создаёт объект информации о шрифте для шрифта, совместимого с экраном, т. е. шрифт не может быть шрифтом для принтера. Если шрифт изменяется позже, объект информации о шрифте не обновляется.
(Примечание: Если вы используете шрифт для принтера, возвращаемые значения могут быть неточными. Шрифты для принтера не всегда доступны, поэтому, если предоставлен шрифт для принтера, используется ближайший шрифт для экрана.)
- QWidget::fontInfo() возвращает информацию о шрифте для шрифта виджета. Это эквивалентно вызову QFontInfo(widget->font()). Если шрифт виджета изменяется позже, объект информации о шрифте не обновляется.
- QPainter::fontInfo() возвращает информацию о шрифте для текущего шрифта рисовальщика. Если шрифт рисовальщика изменяется позже, объект информации о шрифте не обновляется.
См. также QFont, QFontMetrics и QFontDatabase.
Документация по функциям-членам
QFontInfo::QFontInfo(const QFontInfo &fi)
Конструирует копию fi.
QFontInfo::QFontInfo(const QFont &font)
Конструирует объект информации о шрифте для font.
Шрифт должен быть совместим с экраном, т. е. шрифтом, используемым для отрисовки текста в виджетах или QPixmap, а не QPicture или QPrinter.
Объект информации о шрифте хранит информацию о шрифте, переданном в конструктор в момент его создания, и не обновляется, если атрибуты шрифта изменяются позже.
Используйте QPainter::fontInfo() для получения информации о шрифте при рисовании. Это даст правильные результаты также при рисовании на устройстве рисования, которое не совместимо с экраном.
QFontInfo &QFontInfo::operator=(const QFontInfo &fi)
Присваивает информацию о шрифте из fi.
QFontInfo::~QFontInfo()
Удаляет объект информации о шрифте.
bool QFontInfo::bold() const
Возвращает true если weight() вернёт значение больше, чем QFont::Normal; в противном случае возвращает false.
См. также weight() и QFont::bold().
bool QFontInfo::exactMatch() const
Возвращает true если соответствующий системный шрифт точно такой же, как тот, что указан в шрифте; в противном случае возвращает false.
См. также QFont::exactMatch().
QString QFontInfo::family() const
Возвращает имя семейства соответствующего системного шрифта.
См. также QFont::family().
bool QFontInfo::fixedPitch() const
Возвращает значение fixed pitch соответствующего системного шрифта.
См. также QFont::fixedPitch().
bool QFontInfo::italic() const
Возвращает значение italic соответствующего системного шрифта.
См. также QFont::italic().
int QFontInfo::pixelSize() const
Возвращает размер шрифта в пикселях соответствующего системного шрифта.
См. также QFont::pointSize().
int QFontInfo::pointSize() const
Возвращает размер шрифта в пунктах соответствующего системного шрифта.
См. также pointSizeF() и QFont::pointSize().
qreal QFontInfo::pointSizeF() const
Возвращает размер шрифта в пунктах соответствующего системного шрифта.
См. также QFont::pointSizeF().
QFont::Style QFontInfo::style() const
Возвращает значение стиля соответствующего системного шрифта.
См. также QFont::style().
QFont::StyleHint QFontInfo::styleHint() const
Возвращает стиль соответствующего системного шрифта.
В настоящее время возвращает только стиль, установленный в QFont.
См. также QFont::styleHint() и QFont::StyleHint.
QString QFontInfo::styleName() const
Возвращает имя стиля соответствующего системного шрифта на системах, которые его поддерживают.
См. также QFont::styleName().
[since 5.0] void QFontInfo::swap(QFontInfo &other)
Меняет местами этот экземпляр информации о шрифте с other. Эта функция очень быстрая и никогда не терпит неудач.
Эта функция была добавлена в Qt 5.0.
int QFontInfo::weight() const
Возвращает вес соответствующего системного шрифта.
См. также QFont::weight() и bold().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.1/qfontinfo.html