DrawThemeTextEx 関数 (uxtheme.h)

ビジュアル スタイルで定義された色とフォントを使用してテキストを描画します。 追加のテキスト形式オプションを使用して DrawThemeText を拡張します。

構文

HRESULT DrawThemeTextEx(
  [in]      HTHEME        hTheme,
  [in]      HDC           hdc,
  [in]      int           iPartId,
  [in]      int           iStateId,
  [in]      LPCWSTR       pszText,
  [in]      int           cchText,
  [in]      DWORD         dwTextFlags,
  [in, out] LPRECT        pRect,
  [in]      const DTTOPTS *pOptions
);

パラメーター

[in] hTheme

種類: HTHEME

ウィンドウの指定されたテーマ データを処理します。 OpenThemeData を使用して HTHEME を作成します。

[in] hdc

種類: HDC

描画に使用する HDC。

[in] iPartId

型: int

目的のテキストの外観を備えたコントロールのパーツ。 「パーツと状態」を参照してください。 この値が 0 の場合、テキストは既定のフォント、またはデバイス コンテキストに選択されているフォントで描画されます。

[in] iStateId

型: int

目的のテキストの外観を備えたコントロールの状態。 「パーツと状態」を参照してください。

[in] pszText

種類: LPCWSTR

描画するテキストを含む文字列へのポインター。

[in] cchText

型: int

描画する文字数を含む int 型の値。 パラメーターが -1 に設定されている場合、文字列内のすべての文字が描画されます。

[in] dwTextFlags

型: DWORD

文字列の書式設定を指定する 1 つ以上の値を含む DWORD。 使用可能なパラメーター値については、「 値の書式設定 」を参照してください。

[in, out] pRect

種類: LPRECT

テキストを描画する四角形を論理座標で含む RECT 構造体へのポインター。

[in] pOptions

型: const DTTOPTS*

描画するテキストに適用される追加の書式設定オプションを定義する DTTOPTS 構造体。

戻り値

型: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

解説

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

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	uxtheme.h
Library	UxTheme.lib
[DLL]	UxTheme.dll