共用方式為

IDWriteFontSet4：：ConvertWeightStretchStyleToFontAxisValues 方法 (dwrite_3.h)

  • 發行項

從指定的字型粗細、延展、樣式和大小計算衍生的字型座標軸值。

語法

UINT32 ConvertWeightStretchStyleToFontAxisValues(
  DWRITE_FONT_AXIS_VALUE const *inputAxisValues,
  UINT32                       inputAxisCount,
  DWRITE_FONT_WEIGHT           fontWeight,
  DWRITE_FONT_STRETCH          fontStretch,
  DWRITE_FONT_STYLE            fontStyle,
  float                        fontSize,
  DWRITE_FONT_AXIS_VALUE       *outputAxisValues
);

參數

inputAxisValues

類型：_In_reads_opt_ (inputAxisCount) DWRITE_FONT_AXIS_VALUE const*

輸入座標軸值的陣列選擇性指標。 此陣列中的座標軸會從輸出中排除。 如此一來，明確的座標軸值會優先於衍生的座標軸值。

inputAxisCount

類型： UINT32

輸入座標軸值的陣列大小。

fontWeight

類型： DWRITE_FONT_WEIGHT

字型粗細，用來計算 「wght」 軸值。

fontStretch

類型： DWRITE_FONT_STRETCH

字型延展，用來計算 「wdth」 軸值。

fontStyle

類型： DWRITE_FONT_STYLE

字型樣式，用來計算 「slnt」 和 「ital」 座標軸值。

fontSize

類型： float

DIP 中的字型大小，用來計算 「opsz」 軸值。 如果此參數為零，則不會將 「opsz」 軸值新增至輸出陣列。

outputAxisValues

類型：_Out_writes_to_ (DWRITE_STANDARD_FONT_AXIS_COUNT，傳回) DWRITE_FONT_AXIS_VALUE*

寫入衍生座標軸值的輸出數位指標。 此陣列的大小至少必須 DWRITE_STANDARD_FONT_AXIS_COUNT ( 5) 。 傳回值是實際寫入此陣列的座標軸值數目。

傳回值

類型： UINT32

傳回實際寫入輸出陣列的衍生座標軸值數目。

備註

如果有任何) ，呼叫端應該將輸出座標軸值串連至輸入座標軸值 (，並將結合的座標軸值傳遞至 GetMatchingFonts 方法。 這不會產生重複項目，因為輸出不會在 inputAxisValues 陣列中包含任何座標軸。

規格需求

需求 值
最低支援的用戶端 Windows 11 組建 22621
標頭 dwrite_3.h
程式庫 Dwrite.lib
Dll Dwrite.dll