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

[since 5.0] void QFontInfo::swap(QFontInfo &other)

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

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

int QFontInfo::weight() const

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

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