Loading...
 

System Events

System Events

InstantView® knows the following predefined events:

Event Description
SELECT a button, MenuItem etc. has been selected (with mouse or a keyboard input provided for the window object according to CUA); in the case of an input field SELECT is triggered by the Return key, no ENTER label exists even by the Enter key
ENTER The Enter key was pressed in an input field. (see SELECT)
CURRENT

the window object receives the focus (also when opening a window)
the module starts to process a message and is the active module

NON_CURRENT the window object returns the focus (also when closing a window)
the module is no longer the active module
Attention: Is not triggered in the module if the processing of the last message is cancelled with an error message.
MOUSE_CLICK Single click with the left mouse button
MOUSE_CLICK_R Single click with the right mouse button
DOUBLE_CLICK Double click with left mouse button
DOUBLE_CLICK_R Double click with right mouse button
CLOSE the (parent) window is closed (also with CloseWindow). The closing can no longer be prevented.
CLOSING

The user has pressed the X of the window, or (ALT+F4) and wants to close the window Closing can be prevented by returning a FALSE with ReturnStack in response to the message. Alternatively, closing can be prevented by pressing cancel. If the message is not handled, or if there is another result on the stack, the window is closed.
CloseWindow does not trigger this message.

INITIALIZE

Triggered on any Window object during OpenWindow.
Triggered on the main module (.cxp) as the first message after initialising the system.
Triggered on external modules before it processes the first message received.

Attention: Is triggered on the STARTUP window before the INITIALIZE of the associated module!

DATES
198178

is sent once to each module, immediately before ClassiX is terminated. At that time, all windows are already closed and the opening of new windows or dialogues is no longer allowed.

RESIZE_WINDOW

Sent to a control when its size has changed.
208598
The event is now also sent to toplevel windows after they have been resized by the user (also maximize, minimize, restore) or resize.
The event is also triggered when the window is opened and if ClassiX restores a saved window size, the event can also be triggered twice when opened.

DRAIN_WINDOW Sent when DrainWindow is executed ( control widget only). At the end of the message, the object is expected on the stack to be saved by DrainWindow.
FILL_WINDOW Sent when FillWindow is executed ( control widget only). At the beginning of the message, the object is on the stack to be inserted into the control.
BACKSPACE The Backspace key (delete backwards, "|←") was pressed
C_UP The Cursor Up key ("↑") was pressed
C_DOWN Cursor Down key ("↓") was pressed
ESC 208532 Key Escape "⎋" was pressed
PG_UP Page Up ("Pos1") key was pressed
PG_DOWN Page Down ("End") key was pressed
PLUS The Plus ('+') key was pressed. By default in ObjectBoxes this means Expand
MINUS The Minus ('-') key was pressed. By default in ObjectBoxes this means Collapse
MULTIPLY The Mal key ('*') was pressed. By default in ObjectBoxes this means ExpandAll (node and recursively expand all subordinate nodes)
DIVIDE Key Divided ('/') was pressed. By default in ObjectBoxes this means Collapse (nodes and recursively collapse all subordinate nodes)
INSERT The Insert key ("Ins") was pressed.
DELETE The Remove key ("Del") was pressed.
F2 Key F2 was pressed
. . . . . .
F12 Key F12 was pressed
ALTERED the content of an input field was changed interactively; whether and from when the changes are registered is determined by the Alertinstruction
IS_ENABLEDwith this, a menu item can return whether it is enabled; this message is sent when menu items are displayed. The return value (0 or 1) decides whether a selection is allowed.

Attention: This event has not worked since at least Dll version 210919 and is no longer recognised as a system event from Dll version 228202.

IS_DROPPABLE an object is dragged and dropped, the potential source and target objects and the insert mode are on the stack The return value (0 or 1) determines whether a drop is allowed.
DROP objects dragged and dropped were dropped (only with flag ACCEPT_DROP), the objects and the insert mode are on the stack
TOOLTIP The machine requests an explanation text (tooltip) for the window object. This is done after a time interval has elapsed. The response to this event overwrites the default behaviour specifiedby the TOOLTIP(str)label in the Windows object definition. The string str of this label is passed to TOOLTIP on the stack. The string str remaining on the stack after execution becomes the Tip. (An empty stack suppresses the Tip).
COMBO_DROPDOWN Sent by an (object) combo box or enumeration when the user requests to open the combo box. The combo box can now be filled or the event can be responded to in another way.
OBOX_PRE_ENTRY_DISPLAY Is sent to an ObjectBox before a FillWindow (for OboxEdit)
OBOX_POST_ENTRY_DISPLAY Sent to an ObjectBox after a FillWindow (for OboxEdit)
OBOX_ENTRY_DISPLAYED see OBOX_POST_ENTRY_DISPLAY
OBOX_ENTRY_CHANGED Is sent to an ObjectBox after a DrainWindow (with OboxEdit)
OLE_SAVE The OLE document was saved by the server application ( MLOleBox and OleBox widgets only)
OLE_WRONG_TYPE An attempt was made to fill an OLE object of the wrong type into the OleBox (drag & drop) (only MLOleBox and OleBox widgets)
FORMAT_CHANGED

Issued to an ObjectListView/TreeList when the user has changed the list format. (Column order, column width or column visibility) The changed format can be read with GetFormat . Only in MorphIT.

208407 obsolete: The Gridmenu and SAVE_FORMAT/RESET_FORMAT are preferable for this.

218174 no longer supported by ClassiX

REPORT_LIST
233126
4.16.2
The user has selected the entry "Output list" in the list menu of the ListView.
RESET_FORMAT The user has selected the reset of the current format from the ListView drop-down menu.
SAVE_FORMAT

The user has selected to save the current format in the ListView/TreeList list menu.

STATE_IN

Sent to the ObjectCode of a status monitor after a transaction is posted to it.

STATE_OUT Sent to the ObjectCode of a status monitor after a transaction has been cleared from it.
TIME_CHANGED The system time has been changed
MIDNIGHT Sent by the DigitalTimer and AnalogTimer widgets at midnight