DrawThemeTextEx

ビジュアルスタイルで定義された色とフォントを用いてテキストを描画する。DrawThemeText を拡張し、追加のテキスト書式オプションを指定できるようにする。

DrawThemeTextEx hTheme, hdc, iPartId, iStateId, pszText, cchText, dwTextFlags, pRect, pOptions

hTheme : [intptr] 型: HTHEME ウィンドウの指定されたテーマデータへのハンドル。HTHEME を作成するには OpenThemeData を使用する。
hdc : [intptr] 型: HDC 描画に使用する HDC。
iPartId : [int] 型: int 目的のテキスト外観を持つコントロールパート。Parts and States を参照。値が 0 の場合、テキストはデフォルトのフォント、またはデバイスコンテキストに選択されているフォントで描画される。
iStateId : [int] 型: int 目的のテキスト外観を持つコントロール状態。Parts and States を参照。
pszText : [wstr] 型: LPCWSTR 描画するテキストを含む文字列へのポインター。
cchText : [int] 型: int 描画する文字数を含む int 型の値。-1 に設定すると文字列内のすべての文字が描画される。
dwTextFlags : [int] 型: DWORD 文字列の書式設定を指定する 1 つ以上の値を含む DWORD。指定可能なパラメーター値については Format Values を参照。
pRect : [var] 型: LPRECT テキストを描画する論理座標での矩形を含む RECT 構造体へのポインター。
pOptions : [var] 型: const DTTOPTS* 描画されるテキストに適用される追加の書式設定オプションを定義する DTTOPTS 構造体。

(プラグイン / モジュール : uxtheme.dll)

解説

ビジュアルスタイルで定義された色とフォントを用いてテキストを描画する。DrawThemeText
を拡張し、追加のテキスト書式オプションを指定できるようにする。

[戻り値]
型: HRESULT 関数が成功した場合は S_OK を返す。それ以外の場合は HRESULT エラーコードを返す。

[備考]

指定されたパートおよび状態に対してテーマフォントが定義されている場合、関数は常にそれを使用する。それ以外の場合は、デバイスコンテキストに現在選択されているフォントを使用する。テーマフォントが定義されているかどうかを調べるには、プロパティ識別子として
TMT_FONT を指定して GetThemeFont または GetThemePropertyOrigin を呼び出す。

情報