GUI.Dispose | Part of GUI module |
Syntax | GUI.Dispose (widgetID : int)
|
Description | Eliminates the widget specified by widgetID. If the widget is visible, it is immediately made invisible before being deleted. It should be called in order to free up any memory that the widget might have allocated. Note that you cannot use the widget after it has been disposed of. If you wish to temporarily get rid of a widget, consider using the Hide method and then the Show method when you want to use it again.
|
Example | The following program waits for the Quit button to be pressed. When it is, the Quit button is deleted and a message is displayed in the center of the screen.
import GUI in "%oot/lib/GUI" View.Set ("graphics:150;100") var button, message : int button := GUI.CreateButton (20, 40, 0, "Quit", GUI.Quit) loop exit when GUI.ProcessEvent end loop GUI.Dispose (button) message := GUI.CreateLabelFull (0, 0, "Done", maxx, maxy, GUI.CENTER + GUI.MIDDLE, 0) |
Status | Exported qualified. This means that you can only call the procedure by calling GUI.Dispose , not by calling Dispose .
|