This component is an invisible component that only is relevant when the client is running as applet within a browser.
The component allows to open a certain page (attribute URL) in a certain part of the browser (attribute TARGET). The component is triggered via a server side Trigger implementation (Trigger-object referenced in attribute TRIGGER).
Please note: the component requires some JavaScript coding being part of the page that holds the applet. The JavaScript coding is added automatically if generating the applet start page using the CaptainCasa toolset.
Typically used attributes
All attributes are
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.
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 |
Target in which the link should be opened. Applies for scenarios in which there are several frames to be addressed.
| _blank | New browser instance |
| xyz | Target name within a frame scenario. |
Trigger value: if the value changes then the component's activity is executed on client side. Use class Trigger on server side for implementations of this property.
The attribute value must be an expression.
URL that is loaded. Either an absolute address, or relative to the jsp starting page.
In case of setting this attribute to true then NOT the applet context will be used on client side for opening a new page, but the Java Desktop functions.
| true | Use java-Desktop functions to open browser |
| false | (default) Do not use desktop functions |
In case of setting this attribute to true then NOT the applet context will be used on client side for opening a new page, but the JS function ccOpenPageInTarget will be used. Background: the usage of the applet context seems to crash Internet Explorer in some situations...
| true | Use JavaScript method ccOpenPageInTarget (this method is already available when using .ccapplet for calling the applet) |
| false | (default) Go through applet context - with some risk in Internet Explorer Environment... |