callback function AKA code function
Window ToFunction converts any design window into a grid function and a callback function.
When important events occur in a grid, its grid function calls the callback function and passes it message arguments that describe the situation. You can put code in callback functions to respond to any combination of events reported by the grid function, from none to all.
What constitutes an important event depends on the grid type. MouseDown + MouseUp generates a callback message in an XuiPushButton grid, but not in an XuiTextLine , while an Enter keystroke generates a callback in both grid types.
When a basic event takes place in a graphics window, GraphicsDesigner creates a message to describe the event. Whenever the state of keyboard, mouse, or window changes, GraphicsDesigner creates a message. Every message contains 8 arguments:
A window or grid number to identify the window or grid the message refers to.
A message number to identify the nature of the event that occurred.
6 general purpose arguments whose meanings depend on the message number.
GraphicsDesigner messages include WindowKeyDown, WindowResized, MouseDown, TimeOut.
Processing each GraphicsDesigner message typically causes other activity, involving additional GuiDesigner messages. GuiDesigner automatically maintains the GUI, tells your program about the event, and processes messages your program sends to update the GUI.
Each step in this process is a function in GuiDesigner or your program processing a message sent to it by another function.
GuiDesigner recognizes over 100 messages like Create, Destroy, HideWindow, Redraw, Resize, SetColor, SetTextString .
Messages are a fundamental part of GuiDesigner and GUI programs. Messages are pre-defined for every standard aspect of GUIs, and standard message processing functions are provided with GuiDesigner to process these messages appropriately.
° Routine messages are processed automatically by grid functions.
° Your programs send messages to grids to control the GUI.
° Grid functions send callback messages to your program when important events occur.