次の方法で共有


AFX_GLOBAL_DATA::DrawTextOnGlass

指定されたテーマの視覚スタイルで、指定されたテキストを描画します。

BOOL DrawTextOnGlass(
   HTHEME hTheme, 
   CDC* pDC, 
   int iPartId, 
   int iStateId, 
   CString strText, 
   CRect rect, 
   DWORD dwFlags, 
   int nGlowSize = 0, 
   COLORREF clrText = (COLORREF)-1
);

パラメーター

  • [入力] hTheme
    ウィンドウのテーマ データのハンドル、または NULL。このパラメーターが NULL ではなく、テーマがサポートされている場合、フレームワークは、指定されたテーマを使用してテキストを描画します。それ以外の場合、フレームワークは、テーマを使用せずにテキストを描画します。

    OpenThemeData メソッドを使用して HTHEME を作成します。

  • [入力] pDC
    デバイス コンテキストへのポインター。

  • [入力] iPartId
    目的のテキストの外観を備えたコントロールの部分。詳細については、「Parts and States」の表の Parts 列を参照してください。この値が 0 の場合、テキストは既定のフォント、またはデバイス コンテキストに選択されているフォントで描画されます。

  • [入力] iStateId
    目的のテキストの外観を備えたコントロールの状態。詳細については、「Parts and States」の表の States 列を参照してください。

  • [入力] strText
    描画するテキスト。

  • [入力] rect
    指定されたテキストが描画される領域の境界。

  • [入力] dwFlags
    指定されたテキストの描画方法を指定するフラグのビットごとの組み合わせ (OR)。

    hTheme パラメーターが NULL の場合や、テーマがサポートされておらず、有効になっていない場合は、CDC::DrawText メソッドの nFormat パラメーターで有効なフラグを記述します。テーマがサポートされている場合は、DrawThemeTextEx メソッドの dwFlags パラメーターで有効なフラグを記述します。

  • [入力] nGlowSize
    指定されたテキストを描画する前に背景に描画されるグロー効果のサイズ。既定値は 0 です。

  • [入力] clrText
    指定されたテキストの描画に使用される色。既定値は既定の色です。

戻り値

指定されたテキストを描画するためにテーマが使用される場合は、TRUE を返します。それ以外の場合は、FALSE を返します。

解説

テーマは、アプリケーションの視覚スタイルを定義します。詳細については、「テーマと視覚スタイル」を参照してください。hTheme パラメーターが NULL の場合、DrawThemeTextEx メソッドがサポートされていない場合、または Desktop Window Manager (DWM) の構成が無効になっている場合は、テキストを描画するためにテーマが使用されません。

必要条件

ヘッダー : afxglobals.h

参照

関連項目

AFX_GLOBAL_DATA 構造体

階層図

テーマとスタイルのガイド

COLORREF

Parts and States

CDC::DrawText

DrawThemeTextEx

Desktop Window Manager

有効とコントロールの DWM の複合