次の方法で共有

DrawTextExPrivWrap 関数

  • [アーティクル]

[DrawTextExPrivWrap は、Windows XP と Service Pack 2 (SP2) を使用して利用できます。 後続のバージョンでは変更または使用できない可能性があります。 代わりに DrawTextEx を直接使用することをお勧めします。

指定した四角形に書式設定されたテキストを描画します。 この関数は、 DrawTextEx の呼び出しをラップします。

構文

int WINAPI DrawTextExPrivWrap(
  _In_    HDC              hdc,
  _Inout_ LPTSTR           lpchText,
  _In_    int              cchText,
  _Inout_ LPRECT           lprc,
  _In_    UINT             dwDTFormat,
  _In_    LPDRAWTEXTPARAMS lpDTParams
);

パラメーター

hdc [in]

種類: HDC

描画するデバイス コンテキストへのハンドル。

lpchText [in, out]

種類: LPTSTR

描画するテキストを含むバッファーへのポインター。 cchText パラメーターが -1 の場合、文字列は null で終わる必要があります。

dwDTFormat にDT_MODIFYSTRINGが含まれている場合、関数はこの文字列に最大 4 文字を追加できます。 文字列を含むバッファーは、これらの余分な文字に対応できる十分な大きさにする必要があります。

cchText [in]

型: int

lpchText によって指される文字列の長さ。 cchText が -1 の場合、lpchText パラメーターは null で終わる文字列へのポインターであると見なされ、DrawTextEx は文字数を自動的に計算します。

lprc [in, out]

型: LPRECT

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

dwDTFormat [in]

型: UINT

書式設定オプション。 オプションの完全な一覧については、 DrawTextEx のドキュメントを参照してください。

lpDTParams [in]

型: LPDRAWTEXTPARAMS

追加の書式設定オプションを指定する DRAWTEXTPARAMS 構造体へのポインター。 このパラメーターは、NULL でもかまいません。

戻り値

型: int

関数が成功した場合、戻り値は論理単位のテキストの高さになります。 DT_VCENTERまたはDT_BOTTOMを指定した場合、戻り値は lprc の上部メンバーから描画されたテキストの下部までのオフセットです。

関数が失敗した場合は、0 を返します。

詳細なエラー情報を得るには、GetLastError を呼び出します。

注釈

DrawTextExPrivWrap は、名前によってエクスポートされたり、パブリック ヘッダー ファイルで宣言されたりしません。 これを使用するには、 GetProcAddress を 使用し、ComCtl32.dllから序数 416 を要求して関数ポインターを取得する必要があります。

詳細については、「 DrawTextEx」を参照してください。

要件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003 [デスクトップ アプリのみ]
[DLL]
Comctl32.dll (バージョン 6.0 以降)