Класс 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 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

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

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

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

void QFontInfo::swap(QFontInfo &other)

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

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

int QFontInfo::weight() const

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

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