edit

Syntax edit (address, windowTitle = nil, flReadOnly = false)

Params address is an address value that points to the object in the database that you wish to edit.

windowTitle is an optional parameter, a string.

flReadOnly is an optional parameter, a boolean.

Action Opens the object at address in an appropriate type of window and prepares for the user to edit the object, if the parameter is a valid object database address.

For scalar objects (such as strings) for which no special editing window exists, Frontier selects the object in its parent's table and makes it available for editing.

If windowTitle is not nil, and the object is not a scalar, then, before opening the window for viewing, its title is changed to the indicated title.

Returns The address of the previous target window.

Examples edit (@examples.testOutline)

edit (@examples.testOutline, "This is just a test...")

edit (@examples.name) //it's a string, a scalar

new (tableType, @scratchpad.userInfo); scratchpad.userInfo.created = clock.now (); edit (@scratchpad.userInfo, "User Info")

edit (@examples.testOutline, flReadOnly:true) //open as read-only
Errors Supplying an address which Frontier cannot coerce into a valid address form produces an error.

If flReadOnly is true, and it's a wp-text object, then a scriptError is generated.

Notes This verb is implemented as a script.

The windowTitle parameter was added 10/9/98 by DW.

The flReadOnly parameter was added to Frontier 7.

See also target.set

close

window.setTitle

window.open

Discuss