メッセージのEM_SETRECT

複数行の編集コントロールの 四角形の書式設定 を設定します。 書式設定の四角形は、コントロールがテキストを描画する制限四角形です。 制限する四角形は、編集コントロール ウィンドウのサイズに依存しません。

このメッセージは、複数行の編集コントロールによってのみ処理されます。 このメッセージは、編集コントロールまたはリッチ エディット コントロールのいずれかに送信できます。

パラメーター

wParam

リッチ エディット 2.0 以降:lParam で絶対座標と相対座標のどちらを指定するかを示します。 0 の値は、絶対座標を示します。 1 の値は、現在の書式設定の四角形を基準としたオフセットを示します。 (オフセットは正でも負でもかまいません)。

コントロールの編集とリッチ エディット 1.0: このパラメーターは使用されず、0 である必要があります。

lParam

四角形の新しい次元を指定する RECT 構造体へのポインター。 このパラメーターが NULL の場合、書式設定の四角形は既定値に設定されます。

戻り値

このメッセージは値を返しません。

解説

タッチ デバイスがインストールされている場合、またはフックがインストールされているスレッドからEM_SETRECTが送信された場合、lParamNULL に設定しても影響はありません (SetWindowsHookEx を参照)。 このような場合、 lParam には RECT 構造体への有効なポインターが含まれている必要があります。

EM_SETRECT メッセージにより、編集コントロールのテキストが再描画されます。 テキストを再描画せずに四角形の書式設定のサイズを変更するには、 EM_SETRECTNP メッセージを使用します。

編集コントロールを最初に作成すると、書式設定の四角形は既定のサイズに設定されます。 EM_SETRECT メッセージを使用すると、編集コントロール ウィンドウよりも大きいまたは小さい書式設定の四角形を作成できます。

編集コントロールに水平スクロール バーがない場合、書式設定の四角形が編集コントロール ウィンドウよりも大きくなるように設定されている場合、編集コントロール ウィンドウの幅を超えるテキスト行 (ただし、書式設定する四角形の幅よりも小さい) はラップされずにクリップされます。

編集コントロールに罫線が含まれている場合、書式設定の四角形は罫線のサイズによって縮小されます。 EM_GETRECT メッセージによって返される四角形を調整する場合は、EM_SETRECT メッセージで四角形を使用する前に、罫線のサイズを削除する必要があります。

リッチエディット: Microsoft Rich Edit 1.0 以降でサポートされています。 書式設定の四角形には、各段落の左側にあるマークされていない領域である選択バーは含まれません。 ユーザーが選択バーをクリックすると、対応する行が選択されます。 リッチ エディット バージョンとさまざまなシステム バージョンの互換性については、「 リッチ エディット コントロールについて」を参照してください。

要件

要件
サポートされている最小のクライアント
Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows Server 2003 [デスクトップ アプリのみ]
Header
Winuser.h (Windows.h を含む)

関連項目

参照

EM_GETRECT

EM_SETRECTNP

その他のリソース

RECT