info(“formevent”)
info(“formevent”)

The info(“formevent”) function returns the last event that occurred to the current form.

Description

This function returns the last event that occured to the current form. This function should only be used in code that has been set up to process form events. This code can be set up in the Form Properties Panel of the Object Inspector Panel, or can be set up via a procedure with the setformoptions statement.

The possible events that can be returned by this function are:

OPEN – The window has just been opened.

FRONT – The window has just been brought to the front (this event also happens when the form is opened).

RESIZE – The window has just been resized (this event also happens when the form is opened).

This example is useful for debugging – it displays a notification whenever any form event occurs.

    nsnotify "Form Event: "+info("formevent"),"Text",info("formname")

This example sets up a variable when the form is first opened.

    if info("formevent") match "open"
        windowglobal windowOpenTime
        windowOpenTime = supernow()
    endif

See Also

- getformoption( -- returns information about a form.
- setformoptions -- modifies one or more properties of a form (name, viewing mode, etc.).

History

Version | Status | Notes
10.0 | New | New in this version.