Graphics::SetTextRenderingHint メソッド (gdiplusgraphics.h)

Graphics::SetTextRenderingHint メソッドは、この Graphics オブジェクトのテキスト レンダリング モードを設定します。

構文

Status SetTextRenderingHint(
  [in] TextRenderingHint newMode
);

パラメーター

[in] newMode

種類: TextRenderingHint

TextRenderingHint 列挙体の要素。この Graphics オブジェクトがテキストのレンダリングに現在使用しているプロセスを指定します。

戻り値

種類: 状態

メソッドが成功した場合は、 Status 列挙の要素である Ok を返します。

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

解説

TextRenderingHintClearTypeGridFit は、Windows XP および Windows Server 2003 でのみサポートされています。

TextRenderingHintClearTypeGridFit を CompositingModeSourceCopy と共に使用することはできません。

例

次の例では、テキスト レンダリング ヒントを 2 つの異なる値に設定し、各値を示すテキストを描画します。

VOID Example_SetTextRenderingHint(HDC hdc)
{
   Graphics graphics(hdc);

   // Set the text rendering hint to TextRenderingHintSingleBitPerPixel. 
   graphics.SetTextRenderingHint(TextRenderingHintSingleBitPerPixel);

   // Draw text.
   graphics.DrawString(
   L"Low quality rendering",
       21,
   &Font(L"Arial", 24),
   PointF(0, 0),
   &SolidBrush(Color(255, 0, 0, 0)));

   // Get the text rendering hint.
   TextRenderingHint hint = graphics.GetTextRenderingHint();

   // Set the text rendering hint to TextRenderingHintAntiAlias. 
   graphics.SetTextRenderingHint(TextRenderingHintAntiAlias);

   // Draw more text to demonstrate the difference.
   graphics.DrawString(
   L"High quality rendering",
       22,
   &Font(L"Arial", 24),
   PointF(0, 50),
   &SolidBrush(Color(255, 0, 0, 0)));
}

要件

関連項目

テキストによるアンチエイリアシング

CompositingMode

グラフィックス

Graphics::GetTextRenderingHint

Graphics::SetCompositingMode

TextRenderingHint