AFX_GLOBAL_DATA::DrawTextOnGlass

[アーティクル]
08/09/2011

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

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) の構成が無効になっている場合は、テキストを描画するためにテーマが使用されません。