The ACTIVEX component is a Java-wrapper around an ActiveX component. It is only available within the Swing client (not within the FX client).
Please pay attention: binding an ActiveX component into a Swing container is something "quite special" and should in general be avoided - please only use this component as "last option". If using the component please do not forget to spend quite some effort in testing your scenarios (e.g. in 32bit and 64bit Windows environment).
In many cases it is more stable (and simpler to implement/test) to run some native code as parallel process within the frontend client, and to communicate between the client Java process and the native process using e.g. CLIENTHTTPSENDER and CLIENTHTTPRECEIVER components.
Typically used attributes
All attributes are
Binding to server side method that processes the events coming from this component.
| #{methodBinding} | Method binding |
Special binding to componet adapter object instance on server side.
| #{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.
Spanning of columns if used inside a COLSYNCHEDROW.
| 1 | Control spans one column (default) |
| 2 | 2 columns |
| 3 | 3 columns |
If used with MENUITEM component: command string that is passed to the action listener of the component referencing the popup menu item. - If used with ACTIVEX component: Command that is sent to the ActiveX control. Pay attention: commands will only be executed if they differ from the previously executed command in order to avoid double calling. The command is a semicolon separated list of property-set commands (set(propertyname)) and method calls (method(param1,param2)). ONLY String parameters are supported at the moment.
| set(propertyName) | Set a property of the ActiveX control. |
| invoke() | Invoke of method |
| invoke(param1,param2) | Invoke of method with parameters |
| set(propertyName);invoke(param1,param2) | Concatenated command |
If set to true then the ActiveX control will call the server immediately after executing a command that is sent from the server. You use this option in cases, where you want to immediately transfer changed ActiveX properties to the server.
| true | Call back the server. |
| false | No call back of server (default) |
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.
Height of the control. Either defined as absolute value or as percentage value. Pay attention when using percentage sizing: the size refers to what is given from the components above. - When using components within a grid (FIXGRID) then the sizing of the component is completely managed by the grid, you do not need to specify any height in this case.
| 100 | 100 Pixels |
| 120 | 120 Pixels |
| 200 | 200 Pixels |
| 50% | 50 percents |
| 100% | Full available height |
Command that is executed when the ActiveX control is created on the client.
| set(propertyName) | Set a property of the ActiveX control. |
| invoke() | Invoke of method |
| invoke(param1,param2) | Invoke of method with parameters |
| set(propertyName);invoke(param1,param2) | Concatenated command |
Error message that is shown to the user if an error happens on client side (e.g. if the component is not available). If no message is defined, then no message will be output.
ActiveX program id of the component you want to integrate.
| #{Shell.Explorer} | Internet Explorer as ActiveX |
Comma separated list of properties or methods with string return value. The values will be transferred back to the server when changed.
| get(propertyName) | Property value |
| invoke(param1) | Invoke method that returns a string value |
| get(propertyName1);get(propertyName2) | Concatenated call |
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.
| 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.
| true | Component is rendered (default) |
| false | Component is not rendered |
If more than one component is arranged within one row, then components need to decide how they want to be aligned vertically inside the row - in case the height of the row exceeds the height of the component itself.
| top | Top |
| center | Center (default) |
| bottom | Bottom |
Defines if data is transferred to the server on change only.
| true | only update server on change of component data (default) |
| false | always pass data to server |
Delay duration that the client waits before creating the ActiveX component instance.
| 250 | 250ms (default) |
| 1000 | 1000 ms |
Delay duration that the client waits when removing and disposing the ActiveX component instance.
| 250 | 250ms (default) |
| 1000 | 1000 ms |
Width of the control. Either defined as absolute value or as percentage value. Pay attention when using percentage sizing: the size refers to what is given from the components above. - When using components within a grid (FIXGRID) then the sizing of the component is completely managed by the grid, you do not need to specify any width in this case.
| 100 | 100 Pixels |
| 120 | 120 Pixels |
| 200 | 200 Pixels |
| 50% | 50 percents |
| 100% | Full available width |