FontWeight FontWeight FontWeight FontWeight FontWeight Struct


Expresses the density of a typeface, in terms of the lightness or heaviness of the strokes.

public : struct FontWeight
struct winrt::Windows::UI::Text::FontWeight
public struct FontWeight
Public Structure FontWeight
var fontWeight = {

   weight: /* Your value */

<object property="fontWeightsPropertyName"/>

Windows 10 requirements

Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)


This example shows how to set the FontWeight property on a XAML TextBlock.

<TextBlock Text="FontWeight ExtraBlack" FontWeight="ExtraBlack"/>
TextBlock textBlock1 = new TextBlock();
textBlock1.Text = "FontWeight ExtraBlack";
textBlock1.FontWeight = Windows.UI.Text.FontWeights.ExtraBlack;


In standard typography API, the weight of a font is expressed by using constant names, for example "Bold". Using constant names for setting a font weight property is supported through type converter behaviors and also by the FontWeights support class. For code access, the relevant information is expressed as the Weight member of a FontWeight structure.

The FontWeights values correspond to the "usWeightClass" definition in the OpenType specification. The "usWeightClass" represents an integer value between 1 and 999. Lower values indicate lighter weights; higher values indicate heavier weights.

The Weight member of a FontWeight structure is typically initiated with one of the FontWeights values. If you access a FontWeight structure in code, you can compare the value of its Weight member with values from the FontWeights static properties.


Weight Weight Weight Weight Weight

The font weight expressed as a numeric value. See Remarks.