EM_SETRECT メッセージ

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

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

パラメーター

wParam

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

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

lParam

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

戻り値

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

解説

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

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

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

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

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

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

必要条件

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

関連項目

参照

EM_GETRECT

EM_SETRECTNP

その他のリソース

Rect