Класс QFontInfo

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

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

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

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

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

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

Например, когда программа запрашивает шрифт Courier 25pt на компьютере, на котором есть не масштабируемый шрифт Courier 24pt, QFont (обычно) использует шрифт Courier 24pt для отображения. В этом случае 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.

Шрифт должен быть совместим с экраном, т. е. шрифтом, который вы используете для отображения текста в виджетах или растровых изображениях, а не в 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

Возвращает значение «фиксированная ширина» соответствующего шрифта системы окон.

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

bool QFontInfo::italic() const

Возвращает значение «курсив» соответствующего шрифта системы окон.

См. также 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().

void QFontInfo::swap(QFontInfo &other)

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

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

int QFontInfo::weight() const

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

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