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

下圖顯示 Pala以 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 Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	dwrite.h
程式庫	Dwrite.lib
Dll	Dwrite.dll

另請參閱

IDWriteTextLayout