DWRITE_FONT_WEIGHT enumeration
Represents the density of a typeface, in terms of the lightness or heaviness of the strokes. The enumerated 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.
Syntax
enum DWRITE_FONT_WEIGHT {
DWRITE_FONT_WEIGHT_THIN = 100,
DWRITE_FONT_WEIGHT_EXTRA_LIGHT = 200,
DWRITE_FONT_WEIGHT_ULTRA_LIGHT = 200,
DWRITE_FONT_WEIGHT_LIGHT = 300,
DWRITE_FONT_WEIGHT_SEMI_LIGHT = 350,
DWRITE_FONT_WEIGHT_NORMAL = 400,
DWRITE_FONT_WEIGHT_REGULAR = 400,
DWRITE_FONT_WEIGHT_MEDIUM = 500,
DWRITE_FONT_WEIGHT_DEMI_BOLD = 600,
DWRITE_FONT_WEIGHT_SEMI_BOLD = 600,
DWRITE_FONT_WEIGHT_BOLD = 700,
DWRITE_FONT_WEIGHT_EXTRA_BOLD = 800,
DWRITE_FONT_WEIGHT_ULTRA_BOLD = 800,
DWRITE_FONT_WEIGHT_BLACK = 900,
DWRITE_FONT_WEIGHT_HEAVY = 900,
DWRITE_FONT_WEIGHT_EXTRA_BLACK = 950,
DWRITE_FONT_WEIGHT_ULTRA_BLACK = 950
};
Constants
- DWRITE_FONT_WEIGHT_THIN
-
Predefined font weight : Thin (100).
- DWRITE_FONT_WEIGHT_EXTRA_LIGHT
-
Predefined font weight : Extra-light (200).
- DWRITE_FONT_WEIGHT_ULTRA_LIGHT
-
Predefined font weight : Ultra-light (200).
- DWRITE_FONT_WEIGHT_LIGHT
-
Predefined font weight : Light (300).
- DWRITE_FONT_WEIGHT_SEMI_LIGHT
-
Predefined font weight : Semi-Light (350).
- DWRITE_FONT_WEIGHT_NORMAL
-
Predefined font weight : Normal (400).
- DWRITE_FONT_WEIGHT_REGULAR
-
Predefined font weight : Regular (400).
- DWRITE_FONT_WEIGHT_MEDIUM
-
Predefined font weight : Medium (500).
- DWRITE_FONT_WEIGHT_DEMI_BOLD
-
Predefined font weight : Demi-bold (600).
- DWRITE_FONT_WEIGHT_SEMI_BOLD
-
Predefined font weight : Semi-bold (600).
- DWRITE_FONT_WEIGHT_BOLD
-
Predefined font weight : Bold (700).
- DWRITE_FONT_WEIGHT_EXTRA_BOLD
-
Predefined font weight : Extra-bold (800).
- DWRITE_FONT_WEIGHT_ULTRA_BOLD
-
Predefined font weight : Ultra-bold (800).
- DWRITE_FONT_WEIGHT_BLACK
-
Predefined font weight : Black (900).
- DWRITE_FONT_WEIGHT_HEAVY
-
Predefined font weight : Heavy (900).
- DWRITE_FONT_WEIGHT_EXTRA_BLACK
-
Predefined font weight : Extra-black (950).
- DWRITE_FONT_WEIGHT_ULTRA_BLACK
-
Predefined font weight : Ultra-black (950).
Remarks
Weight differences are generally differentiated by an increased stroke or thickness that is associated with a given character in a typeface, as compared to a "normal" character from that same typeface. The following illustration shows an example of Normal and UltraBold weights for the Palatino Linotype typeface.

Font weight values less than 1 or greater than 999 are considered invalid, and they are rejected by font API functions.
Requirements
|
Minimum supported client |
Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps | Windows Store apps] |
|---|---|
|
Minimum supported server |
Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | Windows Store apps] |
|
Minimum supported phone |
Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps] |
|
Header |
|