EM_SETRECT消息

设置多行编辑控件的格式矩形。格式设置矩形是控件在其中绘制文本的限制矩形。限制矩形与编辑控件窗口的大小无关。

此消息仅由多行编辑控件处理。可以将此消息发送到编辑控件或富编辑控件。

参数

wParam

Rich Edit 2.0 及更高版本： 指示 lParam 是指定绝对坐标还是相对坐标。值为零表示绝对坐标。值 1 指示相对于当前格式矩形的偏移量。 (偏移量可以是正数或负数。)

编辑控件和 Rich Edit 1.0： 不使用此参数，并且必须为零。

lParam

指向 RECT 结构的指针，该结构指定矩形的新尺寸。如果此参数为 NULL，则格式矩形设置为其默认值。

此消息不返回值。

如果安装了触摸设备，或者从安装了挂钩的线程发送EM_SETRECT，则将 lParam 设置为 NULL 不起作用 (请参阅 SetWindowsHookEx) 。在这些情况下， lParam 应包含指向 RECT 结构的有效指针。

EM_SETRECT消息会导致重绘编辑控件的文本。若要在不重绘文本的情况下更改格式矩形的大小，请使用 EM_SETRECTNP 消息。

首次创建编辑控件时，格式矩形将设置为默认大小。可以使用 EM_SETRECT 消息使格式矩形大于或小于编辑控件窗口。

如果编辑控件没有水平滚动条，并且格式设置矩形设置为大于编辑控件窗口，则超过编辑控件窗口宽度的文本行 (但小于) 格式矩形宽度的文本行将被剪裁而不是换行。

如果编辑控件包含边框，则格式化矩形会减去边框的大小。如果要调整 EM_GETRECT 消息返回的矩形，则必须在将矩形与 EM_SETRECT 消息一起使用之前删除边框的大小。

Rich Edit： 在 Microsoft Rich Edit 1.0 及更高版本中受支持。格式设置矩形不包括选择栏，这是每个段落左侧的未标记区域。当用户在选择栏中单击时，将选择相应的行。有关 Rich Edit 版本与各种系统版本的兼容性的信息，请参阅关于 Rich Edit 控件。