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

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