A close look at event driven processing reveals discrete, self-contained objects that interact based on user action, not on a pre-determined system flow. Objects communicate with other objects by sending messages about events that occur in the application. When an object receives a message, a response is triggered and some activity occurs in the application.
Event messages can be sent in two ways - automatically by the operating system in response to some physical event, such as the click of a mouse or the pressing of a key; or, programmatically, when you want to change the state of an object, initiate some other process, or simulate a physical action.
This chapter contains a summary listing of OpenInsight events, arranged in alphabetical order. Available information includes a brief description of each event, syntax, an explanation of parameters, as well as sources of other information on the event (where applicable). Icons are used to label eventswhose default event handler was designed to be used exclusively with Lotus Notes, or with OpenInsight native data.
For more information on OpenInsight events, refer to the Guide to Application Development.
OpenInsight Events Reference
| Event | Description |
|---|---|
| ACTIVATED | Occurs when a window or control on a window gets focus. Activating an MDI child also activates the frame |
| ARRANGEICONS | Arranges MDI children inside client area |
| BUTTONDOWN | Occurs when the mouse button is pressed. |
| BUTTONUP | Occurs when the mouse button is released. |
| CALCULATE | Calculates fields based on the control or cell (in an edit table) losing focus. |
| CASCADE | Cascades all MDI children within the frame. |
| CHANGED | Occurs when a user has taken an action that might have altered text. |
| CHAR | Occurs when a character is entered. |
| CLEAR | Clears the form. |
| CLICK | Occurs when a user presses, then releases, the mouse button over a control. |
| CLOSE | Occurs when a window closes. |
| COLSIZE | Occurs when a column width changes. |
| CREATE | Occurs as a window begins execution. |
| DBLCLK | Occurs when a user double-clicks the mouse button over a control. |
| DDEADVISE | Occurs when a DDE server application notifies OpenInsight that a data item has changed. |
| DDEERROR | Occurs when a DDE communication fails. |
| DELETE | Used to delete a record. |
| DELETEROW | Occurs when a row is deleted from an edit table. |
| DRAGDROP | This event is fired at a drop target control in response to data being dropped into it. |
| DRAGOVER | This event is fired at a drop target control in response to data being dragged into, over and out of it. |
| DRAGEND | This event is fired at a drag source control in response to data being dragged from it. |
| DRAGSTART | This event is fired at a drag source control in response to data being dragged from it. |
| DROPDOWN | Occurs when the list portion of a combo box is about to drop-down. |
| DSOABS | Go to the specified absolute row in the DataSet or refresh the form to reflect DataSet changes. |
| DSOCLEAR | Clear the records in the DataSet. |
| DSOCOMMIT | Event that triggers writing of DataSet updates to the data source. |
| DSODELETE | Deletes the current record from the DataSet object. |
| DSOEXECUTE | Executes a DataSet definition script to establish a DataSet object. |
| DSOFIRST | Go to the first record in the DataSet. |
| DSOINSERT | Inserts a record into the DataSet object. |
| DSOINSTANCE | This event is executed before the create event for the window and allows you to circumvent the normal event processing that creates the DataSet used by the window. |
| DSOLAST | Go to the last record in the DataSet. |
| DSONEXT | Go to the next (positional) record in the DataSet. |
| DSOPREV | Go to the previous (positional) record in the DataSet. |
| DSOROLLBACK | Acts on the DataSet, rolling back any changes since last commit. |
| DSOSETPARAM | Passes parameters to the DataSet definition script. |
| GOTFOCUS | Occurs when focus shifts to the control. |
| HELP | Programmer defined; usually occurs when user selects a menu item or uses an accelerator key combination to get additional information. |
| HSCROLL | Occurs when a window is scrolled horizontally. |
| INACTIVATED | Occurs when a window and all of the child windows (if applicable) no longer have focus. |
| INSERTROW | Occurs when a row gets inserted into an edit table. |
| IXLOOKUP | Looks up index. |
| LOSTFOCUS | Occurs when focus passes from a control to anywhere else. |
| MENU | Occurs when a user selects a menu item. |
| MOVE | Occurs when a user moves the splitter bar control. |
| NOTES | Programmer defined; usually occurs when user selects a menu item or uses an accelerator key combination to get additional information. The NOTES event does not refer to Lotus Notes. |
| OLE | The OLE event is generated for each message generated by an OLE object that is requested using QUALIFY_EVENT. |
| OMNIEVENT | User-defined event. |
| OPTIONS | Programmer defined; usually occurs when user selects a menu item or uses an accelerator key combination to get additional information. |
| PAGE | Executes a specified page action. |
| POSCHANGED | Occurs when the position of the edit table cell with focus changes. |
| QBFABS | Go to a specified position in a QBF (Query By Form) result list. |
| QBFCLOSE | Close QBF mode. |
| QBFFIRST | Go to first record in a QBF result list. |
| QBFINIT | Initialize the QBF mode. |
| QBFLAST | Go to the last record in a QBF result list. |
| QBFNEXT | Go to the next record in a QBF result list. |
| QBFPREV | Go to a previous record in a QBF result list. |
| QBFRUN | Execute a QBF query. |
| QBFTABLE | Displays a the records from a QBF result list in tabular format. |
| READ | Read data into a form from a database. |
| SIZE | Occurs when a window's size or position has changed. |
| SUBMIT | PushButton, Static Text, Window |
| SYSMSG | Occurs when form IO logic wants to report an error or warning. |
| TILE | Resize MDI children to fill the client area. |
| TIMER | Occurs when the amount of time specified by the TIMER property has passed. |
| VSCROLL | Vertical scroll bar. |
| WINMSG | The WINMSG event is generated for each Windows message that is requested using QUALIFY_EVENT. |
| WRITE | Write data from a form to a database. |
