The CLIENTCLOSER component is an invisible component. When the client is started as window on its own (i.e. as webstart client or as application, NOT as applet), then you can control the closing of the client by using this component.
The CLIENTCLOSER typically is positionned in the outmost page of your application.
There are two functions provided:
1. If the client is requested to be closed by the user (e.g. pressing alt-f4), then the CLIENTCLOSER component blocks the closing of the client and calls its ACTIONLISTENER method on server side. The server side application gets notified about the close-request of the user. - In principal now the server side application can do "anything it wants", e.g. show some popup information to warn the user, that data might get lost.
2. The server side application may trigger the actual closing of the client using attribute CLOSECLIENTTRIGGER. When this attribute is triggered, then the client will be definitely closed (without the processing described in 1.)
1. and 2. in principal are independent from one another. Typically of course, the notification of a close-request (1.) at the end somehow is transferred into a corresponding actual closing of the client (2.).
Typically used attributes
All attributes are
General attributes are
Binding to server side method that processes the events coming from this component.
The attribute value must be an expression.
| #{methodBinding} | Method binding |
Special binding to componet adapter object instance on server side.
The attribute value must be an expression.
| #{tobedefined} | Binding to IComponentAdapter instance |
Name of macro that is used for generating certain attributes of this component. Please pay attention: the value of this attribute is read one time for each control and cannot be changed afterwards.
The attribute value must not be changed once the component is created.
Trigger value: if the value changes then the (webstart) client will close.
Comment that can be asigned to any component. The comment is not operationally used.
| Any text | Any text |
Configuration information that is attached to this component. This information is not functionally used by CaptainCasa, but may be used for any application specific purpose.
Reference to an outside object that is the content behind the component. E.g. a field is representing a certain field of a database table: in this case you could define the value table;column. The reference plays a siginficant role within the attributemacro management.
The attribute value must not be changed once the component is created.
| ref | One reference |
| ref1;ref2 | Two references |
| ref1;ref2;ref3 | Three references |
Flag that indicated if this component is rendered at all. If set to false then the component is not rendered - there is no component data sent to the client.
The attribute value must be an expression.
| true | Component is rendered (default) |
| false | Component is not rendered |