GetThemeTextExtent 関数 (uxtheme.h)

表示スタイルのフォントでレンダリングするときに、指定したテキストのサイズと位置を計算します。

構文

HRESULT GetThemeTextExtent(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  LPCWSTR pszText,
  [in]  int     cchCharCount,
  [in]  DWORD   dwTextFlags,
  [in]  LPCRECT pBoundingRect,
  [out] LPRECT  pExtentRect
);

パラメーター

[in] hTheme

種類: HTHEME

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

[in] hdc

種類: HDC

フォントを選択する HDC。

[in] iPartId

型: int

テキストを描画する部分を指定する int 型の値。 「パーツと状態」を参照してください。

[in] iStateId

型: int

パーツの状態を指定する int 型の値。 「パーツと状態」を参照してください。

[in] pszText

種類: LPCWSTR

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

[in] cchCharCount

型: int

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

[in] dwTextFlags

種類: DWORD

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

[in] pBoundingRect

種類: LPCRECT

テキストのレイアウトを制御するために使用される四角形を含む RECT 構造体へのポインター。 このパラメーターは NULL に設定できます。

[out] pExtentRect

型: LPRECT

レンダリングされたテキストに合わせて必要な四角形を論理座標で含む RECT 構造体へのポインター。

戻り値

種類: HRESULT

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

要件

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

こちらもご覧ください

プロパティ識別子