MLM_SETREADONLY

This message sets or clears read-only mode.

Syntax

param1
USHORT usReadOnly; /* New read-only value. */

param2
ULONG ulReserved;  /* Reserved value, should be 0. */

Parameters

usReadOnly (USHORT) - input

New read-only value.

TRUE: Read-only mode set.

FALSE: Read-only mode cleared.

ulReserved (ULONG) - input

Reserved value, should be 0.

Returns

rc (BOOL) - return

Previous read-only value.

TRUE: Read-only mode was set.

FALSE: Read-only mode was cleared.

Remarks

When read-only mode is set, characters typed at the keyboard do not get inserted into the MLE text. The API insertion interface, however, is still functional, as are selection-manipulation activities and copy-to-clipboard operations. This is useful as a means of preventing text modification (such as in a help system) and for providing a minimal blocking printing semaphore.

Default Processing

The default window procedure takes no action on this message, other than to set rc to FALSE.