DWRITE_FONT_WEIGHT enumeration (dwrite.h)

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

typedef enum DWRITE_FONT_WEIGHT {
  DWRITE_FONT_WEIGHT_THIN,
  DWRITE_FONT_WEIGHT_EXTRA_LIGHT,
  DWRITE_FONT_WEIGHT_ULTRA_LIGHT,
  DWRITE_FONT_WEIGHT_LIGHT,
  DWRITE_FONT_WEIGHT_SEMI_LIGHT,
  DWRITE_FONT_WEIGHT_NORMAL,
  DWRITE_FONT_WEIGHT_REGULAR,
  DWRITE_FONT_WEIGHT_MEDIUM,
  DWRITE_FONT_WEIGHT_DEMI_BOLD,
  DWRITE_FONT_WEIGHT_SEMI_BOLD,
  DWRITE_FONT_WEIGHT_BOLD,
  DWRITE_FONT_WEIGHT_EXTRA_BOLD,
  DWRITE_FONT_WEIGHT_ULTRA_BOLD,
  DWRITE_FONT_WEIGHT_BLACK,
  DWRITE_FONT_WEIGHT_HEAVY,
  DWRITE_FONT_WEIGHT_EXTRA_BLACK,
  DWRITE_FONT_WEIGHT_ULTRA_BLACK
} ;

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.

Illustration of the letter "W" in Normal and UltraBold weights
Note  Not all weights are available for all typefaces. When a weight is not available for a typeface, the closest matching weight is returned.
 
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 | UWP apps]
Minimum supported server Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | UWP apps]
Header dwrite.h