IDWriteTextLayout::SetFontWeight メソッド

DWRITE_TEXT_RANGE 構造体で指定されたテキスト範囲内のテキストのフォントの太さを設定します。

構文

virtual HRESULT SetFontWeight(
    DWRITE_FONT_WEIGHT  fontWeight,
    DWRITE_TEXT_RANGE  textRange
) = 0;

パラメーター

• fontWeight
  textRange で指定された範囲内のテキストに設定するフォントの太さ。

• textRange
  この変更を適用するテキスト範囲。

戻り値

メソッドが成功した場合は、S_OK が返されます。 それ以外の場合は、エラー コードが返されます。HRESULT.

解説

フォントの太さは、DWRITE_FONT_WEIGHT 列挙型で提供される定義済みのフォントの太さの値のいずれか、または 1 ～ 999 の整数に設定できます。この範囲外の値に設定すると、メソッドは失敗して、E_INVALIDARG という戻り値が返されます。

次の図は、Palatino Linotype 書体の Normal と Ultra-bold の太さの例を示しています。

 

 

例

次のコードは、フォントの太さを太字に設定する方法を示しています。

  
// 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, Windows Vista SP2 および Windows Vista 用のプラットフォーム更新プログラム
サーバーの最小要件	Windows Server 2008 R2, Windows Server 2008 SP2 および Windows Server 2008 用のプラットフォーム更新プログラム
ヘッダー	Dwrite.h
ライブラリ	Dwrite.lib
DLL	Dwrite.dll

参照

IDWriteTextLayout