通过

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*

指向将派生轴值写入到的输出数组的指针。 此数组的大小必须至少 为 5) (DWRITE_STANDARD_FONT_AXIS_COUNT。 返回值是实际写入此数组的轴值数。

返回值

类型： UINT32

返回实际写入输出数组的派生轴值的数目。

注解

调用方应将输出轴值连接到输入轴值 (（如果有任何) ），并将组合的轴值传递给 GetMatchingFonts 方法。 这不会导致重复，因为输出不包含 inputAxisValues 数组中存在的任何轴。

要求

要求 值
最低受支持的客户端 Windows 11内部版本 22621
标头 dwrite_3.h
Library Dwrite.lib
DLL Dwrite.dll