font QML Value Type
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 objectfont.features- string
font.styleName object[QML]{QtQuick::Text::}{font.variableAxes}
Example:
Text { font.family: "Helvetica"; font.pointSize: 13; font.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.