Read the next available event of the form, but does not wait for it.
Syntax |
event(): string |
---|---|
Result |
Return the next available event name, or "" for no event available |
Supported events are the following:
Event |
Description |
---|---|
close |
The form (e.g. the user interface) want to close. (This happen when you close the window, when RDE wan to close the window or you press the ESC key) |
clicked:<name> |
The user has clicked the button widget named as <name>. |
Notes:
•Actually the form does not stack events, but store only the last event: you should be quickly as possible to read intermediate events, if you need them (but usually not).
•Event name are only lowercase: on the other hand, widget <name> have its original case as defined when creating the form.
Example
Example of a generic form event loop, considering an external existing user interface file called myform.ui:
XForm form String event form.createFromUI ("myform.ui") form.show () while (event != "close) event = form.event () ... end form.hide () |