Index...
Centrallix Documentation
|
widget/formstatus
formstatus :: A specialized visual widget used to display the current mode of a form widget.
Metadata:
| type: | widget/formstatus |
| visual: | yes |
| container: | no |
| form element: | no |
Overview:
Many times with multi-mode forms like those offered by Centrallix, the end-user can become confused as to what the form is currently "doing" (for instance, is a blank form with a blinking cursor in a "new" state or "enter query" state?). Centrallix helps to address this issue using the form status widget. A form status widget displays the current mode of operation that a form is in, as well as whether the form is busy processing a query, save, or delete operation. This clear presentation of the form's mode is intended to clear up any confusion created by a multi-mode form. This widget is a special-case form element.
Usage:
The form status widget can only be used either directly or indirectly within a form widget. It can contain no visual widgets.
Properties:
| Property | Type | Description |
|---|
| style |
string |
Sets the style of the form widget. Can be "small", "large", or "largeflat". |
| x |
integer |
Allows you to set x position in pixels relative to the window. |
| y |
integer |
Allows you to set y position in pixels relative to the window. |
Child Properties:
none currently available
Actions:
none currently available
Events:
| Event | Description |
|---|
| Click |
This event occurs when the user clicks the widget. No parameters are available from this event. |
| MouseUp |
This event occurs when the user releases the mouse button on the widget. |
| MouseDown |
This event occurs when the user presses the mouse button on the widget. This differs from the 'Click' event in that the user must actually press and release the mouse button on the widget for a Click event to fire, whereas simply pressing the mouse button down will cause the MouseDown event to fire. |
| MouseOver |
This event occurs when the user first moves the mouse pointer over the widget. It will not occur again until the user moves the mouse off of the widget and then back over it again. |
| MouseOut |
This event occurs when the user moves the mouse pointer off of the widget. |
| MouseMove |
This event occurs when the user moves the mouse pointer while it is over the widget. The event will repeatedly fire each time the pointer moves. |
Sample Code:
$Version=2$
formstatus "widget/formstatus"
{
x=5; y=450;
style="largeflat";
}
Comments...
(none yet)
Add a Comment...
|
