EM_FORMATRANGE

The EM_FORMATRANGE message formats a range of text in a rich edit control for a specific device.

EM_FORMATRANGE 
wParam = (WPARAM) (BOOL) fRender; 
lParam = (LPARAM) (FORMATRANGE FAR *) lpFmt; 
 

Parameters

fRender

Value specifying whether to render the text. If this parameter is nonzero, the text is rendered. Otherwise, the text is just measured.

lpFmt

Pointer to a FORMATRANGE structure containing information about the output device, or NULL to free information cached by the control.

This message is typically used with the EM_DISPLAYBAND message to format a rich edit control's contents for an output device such as a printer.

It is very important to free cached information after the last time you use this message by specifying NULL in lpFmt. In addition, after using this message for one device, you must free cached information before using it again for a different device.

Return Values

Returns the index of the last character that fits in the region plus one.

QuickInfo

  Windows NT: Requires version 3.51 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in richedit.h.

See Also

Rich Edit Controls Overview, Rich Edit Messages, EM_DISPLAYBAND, FORMATRANGE