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] |
|