EM_FORMATRANGE メッセージ

特定のデバイスのリッチ エディット コントロールでテキストの範囲を書式設定します。

パラメーター

wParam

テキストをレンダリングするかどうかを指定します。 このパラメーターが 0 でない場合は、テキストがレンダリングされます。 それ以外の場合、テキストは単に測定されます。

lParam

出力デバイスに関する情報を含む FORMATRANGE 構造体。コントロールによってキャッシュされた情報を解放するには NULL 。

戻り値

このメッセージは、領域に収まる最後の文字のインデックスと 1 を返します。

解説

このメッセージは、通常、プリンターなどの出力デバイスのリッチ エディット コントロールのコンテンツを書式設定するために使用されます。

このメッセージを使用してテキストの範囲を書式設定した後、 EM_FORMATRANGE をもう一度送信してキャッシュされた情報を解放することが重要ですが、 lParam をNULL に設定します。そうしないと、メモリ リークが発生します。 また、1 つのデバイスでこのメッセージを使用した後、キャッシュされた情報を解放してから、別のデバイスで再び使用する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー	Richedit.h

関連項目

参照

EM_DISPLAYBAND

概念

リッチ エディット コントロールの印刷