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

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

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

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

Эта функция была введена в 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.