The <program> element
The program element is a named tag instance that is created automatically at the beginning of an ioL console session.
It is the parent element of all other tags and data elements in the ioL environment, which all exist inside the program element's default field.
Note that invoking <program.clear> will clear the contents of the console.
The special program element defines several special fields that control various characteristics of the ioL console frame that displays your program's output, such as title bar text, program icon, window geometry and on-exit event handler.
Fields
The program element predefines the following fields automatically:
- background-color
- color
- height
- icon
- margin
- margin-bottom
- margin-left
- margin-right
- margin-top
- mouse
- onexit
- onresize
- rescom
- title
- width
Note
You cannot change the geometry of the program window itself by modifying the width and height fields, as you can for other elements within your program. You can only manipulate geometry and placement of objects within the program window.
Unlike other markup elements, the width and height fields for the program element are read-only. They will return the current geometry of the program window, which will change if the user resizes the window (see also the onresize field).
Programs are not allowed to resize the ioL console window that they are hosted within. This is left to the user, or the framing managment policy of the wider operating environment. (The concept of allowing programs to override their user's desktop preferences and/or system policies is considered harmful design policy, since it would be open to potential abuse.)