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
- string
font.styleName
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.
Font weighting is classified on a scale from 0 to 99, where a weight of 0 is ultralight, and 99 is extremely black. The following values are supported:
Constant | Description |
---|---|
Font.Thin | 0 |
Font.ExtraLight | 12 |
Font.Light | 25 |
Font.Normal | 50 |
Font.Medium | 57 |
Font.DemiBold | 63 |
Font.Bold | 75 |
Font.ExtraBold | 81 |
Font.Black | 87 |
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.