IDWriteTextLayout：：SetFontWeight 方法 (dwrite.h)

设置由 DWRITE_TEXT_RANGE 结构指定的文本范围内的文本的字体粗细。

语法

HRESULT SetFontWeight(
  DWRITE_FONT_WEIGHT fontWeight,
  DWRITE_TEXT_RANGE  textRange
);

参数

fontWeight

类型： DWRITE_FONT_WEIGHT

要为 textRange 指定的区域内的文本设置的字体粗细。

textRange

类型： DWRITE_TEXT_RANGE

应用此更改的文本范围。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

字体粗细可以设置为 DWRITE_FONT_WEIGHT 枚举中提供的预定义字体粗细值之一，也可以设置为 1 到 999 的整数。 超出此范围的值将导致方法失败，返回值 E_INVALIDARG 。

下图显示了 Palatino Linotype 字体的 Normal 和 UltraBold 权重示例。

示例

以下代码演示如何将字体粗细设置为粗体。

// Set the font weight to bold for the entire string.
DWRITE_TEXT_RANGE textRange = {0, cTextLength_};

if (SUCCEEDED(hr))
{
    hr = pTextLayout_->SetFontWeight(DWRITE_FONT_WEIGHT_BOLD, textRange);
}

要求

要求	值
最低受支持的客户端	Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台	Windows
标头	dwrite.h
Library	Dwrite.lib
DLL	Dwrite.dll

另请参阅

IDWriteTextLayout