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