font QML Value Type | Qt Quick (original) (raw)

a font value with the properties of QFont. The font type refers to a font value with the properties of QFont. More...

Detailed Description

Properties of type font default to the application's default font.

The most commonly used properties are:

string font.family
bool font.bold
bool font.italic
bool font.underline
real font.pointSize
int font.pixelSize

If both pointSize and a pixelSize are specified, pixelSize will be used.

The following properties are also available:

enumeration font.weight
bool font.overline
bool font.strikeout
enumeration font.capitalization
real font.letterSpacing
real font.wordSpacing
bool font.kerning
bool font.preferShaping
enumeration font.hintingPreference
object font.features
string font.styleName
object [QML] {QtQuick::Text::}{font.variableAxes}
bool font.contextFontMerging
bool font.preferTypoLineMetrics

Example:

[Text](qml-qtquick-text.html) {
    font.family: "Helvetica"
    font.pointSize: 13
    font.bold: true
}

As font is a structured value type, it can also be constructed with a JavaScript object:

readonly property [font](qml-font.html) myFont: ({
    family: "Helvetica",
    pointSize: 13,
    bold: true
})

When integrating with C++, note that any QFont value passed into QML from C++ is automatically converted into a font value, and vice-versa.

This value type is provided by the QtQuick import.

Numerical values for font weights follow the CSS specification, where a weight of 100 is extremely light, and 900 is extremely bold. The following values are supported:

Constant	Description
Font.Thin	100
Font.ExtraLight	200
Font.Light	300
Font.Normal	400
Font.Medium	500
Font.DemiBold	600
Font.Bold	700
Font.ExtraBold	800
Font.Black	900

Capitalization supports the following values:

Constant	Description
Font.MixedCase	No capitalization change is applied.
Font.AllUppercase	Alters the text to be rendered in all uppercase type.
Font.AllLowercase	Alters the text to be rendered in all lowercase type.
Font.SmallCaps	Alters the text to be rendered in small-caps type.
Font.Capitalize	Alters the text to be rendered with the first character of each word as an uppercase character.

Setting the hinting preference only has an effect when using the "NativeRendering" render type. The property supports the following values:

Constant	Description
Font.PreferDefaultHinting	Use the default hinting level for the target platform.
Font.PreferNoHinting	If possible, render text without hinting the outlines of the glyphs.
Font.PreferVerticalHinting	If possible, render text with no horizontal hinting, but align glyphs to the pixel grid in the vertical direction.
Font.PreferFullHinting	If possible, render text with hinting in both horizontal and vertical directions.

See also QML Value Types.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.