Changes between Initial Version and Version 1 of GUI_-_Classes

Timestamp:

Feb 23, 2008, 4:18:58 AM (16 years ago)

Author:

trac

Comment:

--

GUI_-_Classes

@@ +1 @@
+The GUIObject class provides a JavaScript wrapper around GUI objects, allowing their properties to be manipulated.
+
+= GUIObject Methods =
+
+== getByName ==
+
+'''Overview:'''
+ * Returns another GUIObject, matching a specific name.
+'''Syntax:'''
+ * var newguiobject = oldguiobject.getByName("objectname");
+'''Parameters:'''
+ * objectname: A string that corresponds to the name given in the GUI XML file. Case sensitive.
+'''Returns:'''
+ * A new GUIObject, or null if no match was found.
+'''Notes:'''
+ * Has the same effect as the global getGUIObjectByName(name) function.
+
+== toString ==
+(Implicit)
+
+'''Overview:'''
+ * Overrides the default string conversion to include the name of this GUI object.
+'''Syntax:'''
+ * var name = "The name is " + guiobject;
+'''Parameters:'''
+ * None.
+'''Returns:'''
+ * A string of the form '[GUIObject: objectname]'
+'''Notes:'''
+ * This function is called implicitly by the JavaScript engine to convert this object to a string.
+
+= GUIObject Properties =
+
+== parent ==
+
+'''Overview:'''
+ * The GUIObject corresponding to the parent of this object.
+'''Type:'''
+ * GUIObject
+'''Notes:'''
+ * Has the value null if the object has no parent. Read-only.
+
+== anything else ==
+
+'''Overview:'''
+ * Read/write access to object-type specific settings.
+'''Type:'''
+ * boolean / integer / double / string / GUIColor / GUISize
+'''Notes:'''
+ * Unrecognised parameters are passed to the GUI system as object-specific settings. The valid settings are documented in the GUI TDD, with the addition of 'caption'. If the object does not recognise the setting, an error is reported and a JS exception is thrown.
+
+These data types are used to pass data in and out of GUI objects. All have constructors (with parameters in the same order as the properties described below) and toString methods.
+
+= GUIMouse Properties =
+
+== x, y ==
+
+'''Overview:'''
+ * The coordinates of the mouse, measured in pixels from the top-left corner of the screen.
+'''Type:'''
+ * integer
+'''Notes:'''
+ * Read-only.
+
+== buttons ==
+
+'''Overview:'''
+ * Indicates the state of the mouse buttons. Bit 0 = LMB, bit 1 = RMB, bit 2 = MMB.
+'''Type:'''
+ * integer
+'''Notes:'''
+ * If the mouse buttons are read by code inside a mouse-related event handler, mouse-down events set the appropriate bit of 'buttons' high before executing the code, while mouse-up events clear the appropriate bit of 'buttons' to zero after running the code.
+
+= GUISize Properties =
+
+== left, top, right, bottom ==
+
+'''Overview:'''
+ * The absolute components of a rectangle, measured in pixels from the top-left corner of the parent object.
+'''Type:'''
+ * integer
+
+== rleft, rtop, rright, rbottom ==
+
+'''Overview:'''
+ * The relative components of a rectangle, measured in percentages of the width/height of the parent object.
+'''Type:'''
+ * integer
+'''Notes:'''
+ * The absolute and relative components are added to compute the final size of a GUI object. Either can be negative.
+
+= GUIColor Properties =
+
+== r, g, b, a ==
+
+'''Overview:'''
+ * The red/green/blue/alpha components of a colour, in the range 0.0 to 1.0.
+'''Type:'''
+ * double