Класс QFontInfo

Класс QFontInfo предоставляет общую информацию о шрифтах. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Примечание: Все функции в этом классе являются реентерабельными.

Открытые функции

Подробное описание

Класс QFontInfo предоставляет общую информацию о шрифтах.

Класс QFontInfo предоставляет те же функции доступа, что и QFont, например, family(), pointSize(), italic(), weight(), fixedPitch(), styleHint() и т. д. Но в то время как функции доступа к QFont возвращают значения, которые были установлены, объект QFontInfo возвращает значения, которые применяются к шрифту, который фактически будет использоваться для отображения текста.

Например, когда программа запрашивает шрифт Courier 25 пунктов на компьютере, на котором установлен не масштабируемый шрифт Courier 24 пунктов, QFont (обычно) будет использовать шрифт Courier 24 пунктов для отрисовки. В этом случае QFont::pointSize() возвращает 25, а QFontInfo::pointSize() возвращает 24.

Существует три способа создания объекта QFontInfo.

1. Вызов конструктора QFontInfo со QFont создает объект информации о шрифте для шрифта, совместимого с экраном, то есть шрифт не может быть шрифтом принтера. Если шрифт будет изменен позже, объект информации о шрифте не обновляется.

   (Примечание: если вы используете шрифт принтера, возвращаемые значения могут быть неточными. Шрифты принтера не всегда доступны, поэтому используется ближайший шрифт экрана, если предоставлен шрифт принтера.)

2. QWidget::fontInfo() возвращает информацию о шрифте виджета. Это эквивалентно вызову QFontInfo(widget->font()). Если шрифт виджета будет изменен позже, объект информации о шрифте не обновляется.
3. QPainter::fontInfo() возвращает информацию о шрифте текущего шрифта художника. Если шрифт художника будет изменен позже, объект информации о шрифте не обновляется.

См. также QFont, QFontMetrics и QFontDatabase.

Документация по функциям членов

QFontInfo::QFontInfo(const QFont &font)

Создает объект информации о шрифте для font.

Шрифт должен быть совместим с экраном, то есть шрифт, который используется для отображения текста в виджетах или пиксельных изображениях, а не в QPicture или QPrinter.

Объект информации о шрифте содержит информацию о шрифте, переданном в конструктор в момент его создания, и не обновляется, если атрибуты шрифта изменены позже.

Используйте QPainter::fontInfo(), чтобы получить информацию о шрифте при рисовании. Это даст правильные результаты также при рисовании на устройствах отображения, которые не совместимы с экраном.

QFontInfo::QFontInfo(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

Возвращает имя стиля сопоставленного системного шрифта на системах, которые его поддерживают.

Эта функция была добавлена в Qt 4.8.

См. также QFont::styleName().

void QFontInfo::swap(QFontInfo &other)

Меняет местами этот экземпляр информации о шрифте с other. Эта функция очень быстрая и никогда не терпит неудачу.

Эта функция была добавлена в Qt 5.0.

int QFontInfo::weight() const

Возвращает значение начертания сопоставленного системного шрифта.

См. также QFont::weight() и bold().

QFontInfo &QFontInfo::operator=(const QFontInfo &fi)

Присваивает информацию о шрифте из fi.