DWRITE_FONT_WEIGHT列舉 (dwrite.h)

表示字樣密度，以筆劃的光線或粗細來表示。 列舉值會對應至 OpenType 規格中的 usWeightClass 定義。 usWeightClass 代表介於 1 到 999 之間的整數值。 較低的值表示較輕的權數;較高的值表示較重的權數。

Syntax

typedef 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
} ;

常數

DWRITE_FONT_WEIGHT_THIN 值： 100 預先定義的字型粗細：細 (100) 。
DWRITE_FONT_WEIGHT_EXTRA_LIGHT 值： 200 預先定義的字型粗細：特別淺色 (200) 。
DWRITE_FONT_WEIGHT_ULTRA_LIGHT 值： 200 預先定義的字型粗細：Ultra-light (200) 。
DWRITE_FONT_WEIGHT_LIGHT 值： 300 預先定義的字型粗細：淺色 (300) 。
DWRITE_FONT_WEIGHT_SEMI_LIGHT 值： 350 預先定義的字型粗細：Semi-Light (350) 。
DWRITE_FONT_WEIGHT_NORMAL 值： 400 預先定義的字型粗細：一般 (400) 。
DWRITE_FONT_WEIGHT_REGULAR 值： 400 預先定義的字型粗細：一般 (400) 。
DWRITE_FONT_WEIGHT_MEDIUM 值： 500 預先定義的字型粗細：中 (500) 。
DWRITE_FONT_WEIGHT_DEMI_BOLD 值： 600 預先定義的字型粗細：Demi-bold (600) 。
DWRITE_FONT_WEIGHT_SEMI_BOLD 值： 600 預先定義的字型粗細：半粗體 (600) 。
DWRITE_FONT_WEIGHT_BOLD 值： 700 預先定義的字型粗細：粗體 (700) 。
DWRITE_FONT_WEIGHT_EXTRA_BOLD 值： 800 預先定義的字型粗細：粗體 (800) 。
DWRITE_FONT_WEIGHT_ULTRA_BOLD 值： 800 預先定義的字型粗細：超粗體 (800) 。
DWRITE_FONT_WEIGHT_BLACK 值： 900 預先定義的字型粗細：黑色 (900) 。
DWRITE_FONT_WEIGHT_HEAVY 值： 900 預先定義的字型粗細：大量 (900) 。
DWRITE_FONT_WEIGHT_EXTRA_BLACK 值： 950 預先定義的字型粗細：額外黑色 (950) 。
DWRITE_FONT_WEIGHT_ULTRA_BLACK 值： 950 預先定義的字型粗細：超黑色 (950) 。

備註

相較於同一個字樣中的「一般」字元，粗細通常會以與字樣中指定字元相關聯的增加筆劃或粗細來區分。 下圖顯示 Palaweight Linotype 字型的 Normal 和 UltraBold 權數範例。

注意 並非所有粗細都適用於所有字樣。 當粗細不適用於字樣時，會傳回最接近的相符權數。

 

字型粗細值小於 1 或大於 999 會被視為無效，而且字型 API 函式會拒絕這些值。

規格需求

需求	值
最低支援的用戶端	適用於 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
標頭	dwrite.h