System is a special object, of which there is only one instance. It provides access to some global functions in eboxy. The System object has a section in the XML, but no attributes.
The System object has the following properties:
| Property | Description | Script |
|---|---|---|
| name | The name of the object (always "System") | Read-only |
| screenwidth | Width of the eboxy screen | Read-only |
| screenheight | Height of the eboxy screen | Read-only |
| currentfile | Currently loaded XML skin file | Read-only |
| version | eboxy version string (eg. 0.4.0) | Read-only |
| pagecount | Number of loaded pages | Read-only |
The following methods are supported by the system object:
| Method | Description |
|---|---|
| focusnext() | Jumps to the next widget |
| focusprevious() | Jumps to the previous widget |
| performaction(actionname) | Perform the specified action. Accepts the same actions as for used for key bindings. |
| printpluginlist() | Prints out a list of loaded plugins to the console |
| quit() | Quits eboxy |
| getpage(index) | Gets the name of the page at the specified index in the list (0 to system.pagecount) |
| gotopage(pagename) | Jumps to the specified page. Alternative to the page command for instances where you already have a string with the page name to go to. |
| selectfocused() | Presses the focused button/chooses the selected item in a listbox |
The following events are triggered by the system object:
| Event | Description |
|---|---|
| OnLoad | Occurs just after system plugins are initialised |
| OnShow | Occurs just after the first page has been displayed, and after eboxy is unhidden |
| OnHide | Occurs just before eboxy is hidden (with the exechide script command) |
| OnUnload | Occurs just before eboxy is unloaded |