EM_SETRECT mensaje

Establece el rectángulo de formato de un control de edición de varias líneas. El rectángulo de formato es el rectángulo de limitación en el que el control dibuja el texto. El rectángulo de limitación es independiente del tamaño de la ventana de control de edición.

Este mensaje solo se procesa mediante controles de edición multilínea. Puede enviar este mensaje a un control de edición o a un control de edición enriquecido.

Parámetros

wParam

Rich Edit 2.0 y versiones posteriores: Indica si lParam especifica coordenadas absolutas o relativas. Un valor de cero indica coordenadas absolutas. Un valor de 1 indica desplazamientos relativos al rectángulo de formato actual. (Los desplazamientos pueden ser positivos o negativos).

Editar controles y Rich Edit 1.0: Este parámetro no se usa y debe ser cero.

lParam

Puntero a una estructura RECT que especifica las nuevas dimensiones del rectángulo. Si este parámetro es NULL, el rectángulo de formato se establece en sus valores predeterminados.

Valor devuelto

Este mensaje no devuelve un valor.

Comentarios

Establecer lParam en NULL no tiene ningún efecto si se instala un dispositivo táctil o si se envía EM_SETRECT desde un subproceso que tiene instalado un enlace (consulte SetWindowsHookEx). En estos casos, lParam debe contener un puntero válido a una estructura RECT .

El EM_SETRECT mensaje hace que se vuelva a dibujar el texto del control de edición. Para cambiar el tamaño del rectángulo de formato sin volver a dibujar el texto, use el mensaje EM_SETRECTNP .

Cuando se crea un control de edición por primera vez, el rectángulo de formato se establece en un tamaño predeterminado. Puede usar el mensaje EM_SETRECT para que el rectángulo de formato sea mayor o menor que la ventana de control de edición.

Si el control de edición no tiene una barra de desplazamiento horizontal y el rectángulo de formato se establece como mayor que la ventana de control de edición, las líneas de texto que superen el ancho de la ventana de control de edición (pero menor que el ancho del rectángulo de formato) se recortan en lugar de encapsularse.

Si el control de edición contiene un borde, el rectángulo de formato se reduce según el tamaño del borde. Si va a ajustar el rectángulo devuelto por un mensaje de EM_GETRECT , debe quitar el tamaño del borde antes de usar el rectángulo con el mensaje EM_SETRECT .

Edición enriquecida: Compatible con Microsoft Rich Edit 1.0 y versiones posteriores. El rectángulo de formato no incluye la barra de selección, que es un área sin marcar a la izquierda de cada párrafo. Cuando el usuario hace clic en la barra de selección, se selecciona la línea correspondiente. Para obtener información sobre la compatibilidad de versiones de edición enriquecidas con las distintas versiones del sistema, vea Acerca de los controles de edición enriquecidos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	Winuser.h (incluye Windows.h)

Consulte también

Referencia

EM_GETRECT

EM_SETRECTNP

Otros recursos

RECT