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.

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 | 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

Dwrite.h

 

 

Community Additions

ADD
Show:
© 2014 Microsoft