READONLY Mnemonic - Make Edit Control(s) Read-Only

Syntax

'READONLY'(id{,id...})

Description

For BBj-specific information, see READONLY Mnemonic – BBj.

The 'READONLY' mnemonic (Visual PRO/5 Rev 3.12 or later only) makes one or more edit, custom edit, InputE, or InputN controls read-only. The user can highlight the contents of a read-only edit control with the mouse and copy it to the clipboard, but cannot change it. Making a control read-only does not change its foreground color. If the control has a customized background color, making it read-only will not change it. The background color of controls that do not have a customized background color will change from the default window background color to the default 3D objects background color in accordance to a Windows standard color scheme. Read-only edit, custom edit, InputE, and InputN controls can be made user-editable with the 'READWRITE' mnemonic.

Parameter

Description

id

Control ID number. It must be an integer between 0 and 32767.

If an !ERROR=29 (mnemonic error) occurs, TCB(10) usually gets set to one of the following:

14

The current context (which can be changed with 'CONTEXT') does not contain a top-level or child window.

18

One of the specified controls does not exist.

27

One of the specified controls cannot be made read-only, i.e. it is not an edit, custom edit, InputE or InputN control.

30

No control id's were specified or the mnemonic was not sent to a valid SYSGUI device.

See Also

Mnemonics - Alphabetical Listing

Mnemonics - Group Listing