EM_GETHANDLE

2.x

EM_GETHANDLE
wParam = 0;     /* not used, must be zero */
lParam = 0L;    /* not used, must be zero */

An application sends an EM_GETHANDLE message to retrieve a handle to the memory currently allocated for a multiline edit control. The handle is a local memory handle and can be used by any of the functions that take a local memory handle as a parameter.

This message is processed only by multiline edit controls.

Parameters

This message has no parameters.

Return Value

The return value is a local memory handle identifying the buffer that holds the contents of the edit control. If an error occurs, such as sending the message to a single-line edit control, the return value is zero.

Comments

An application can send this message to a multiline edit control in a dialog box only if it created the dialog box with the DS_LOCALEDIT style flag set. If the DS_LOCALEDIT style is not set, the return value is still nonzero, but the return value will not be meaningful.

Example

This example sends an EM_GETHANDLE message to a multiline edit control and calls the LocalSize function to determine the current size of the edit control using the handle returned by the EM_GETHANDLE message:

HANDLE hmemMle;
WORD cbMle;

hmemMle = (HLOCAL) SendDlgItemMessage(hdlg, ID_MYEDITCONTROL,
    EM_GETHANDLE, 0, 0L);
cbMle = LocalSize(hmemMle);

See Also

EM_SETHANDLE