Graphical representation of a menu item. It typically is placed into MENUBAR, POPUPMENU or BUTTONMENU component.
The MENUITEM component is associated with some action that is triggered on server side.
Typically used attributes
All attributes are
General attributes are
Used inside: BUTTONMENU, MENU, MENUBAR, POPUPMENU
Text that is passed as control content to the accessible support devices (e.g. screen readers).
Binding to server side method that processes the events coming from this component.
| #{methodBinding} | Method binding |
Special binding to component adapter object instance on server side. The component adapter must be an instance of IComponentAdapterBinding. For some components (e.g. FIXGRID) there is an extended interface (e.g. IFIXGRIDComponentAdapterBinding).
| #{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.
Background color of the component. Any RGB value can be chosen using format #rrggbb.
| #FFFFFF | White |
| #000000 | Black |
| #FF0000 | Red |
| #00FF00 | Green |
| #0000FF | Blue |
| #0000FF30 | Blue with a transparency of x30. |
Name that is assigned to the component at client side: there is no specific function associated with the name - but it can be used on client side to describe the component in a clearer way. The name is e.g. used by UI test tools that replay certain user interaction sequences - and that reference components via their name.
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 |
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.
Indicator if component is enabled or not.
| true | Component is enabled. |
| false | Component is not enabled. |
Semicolon separated list of font attributes. Valid attributes are: faces (font family), size (integer number), weight (bold), posture (italic)
| family:Arial | family:Arial |
| family:Courier | family:Courier |
| size:12 | size:12 |
| weight:bold | weight:bold |
| size:12;weight:bold | size:12;weight:bold |
| size:12;posture:italic | size:12;posture:italic |
Foreground color of the component. Any RGB value can be chosen using format #rrggbb.
| #FFFFFF | White |
| #000000 | Black |
| #FF0000 | Red |
| #00FF00 | Green |
| #0000FF | Blue |
| #0000FF30 | Blue with a transparency of x30. |
Definition of keyboard key that is associated with this menu item.
| No keyboard association (default) | |
| ctrl-83 | Control key + s |
| alt-83 | Alt key + s |
| shift-83 | Shift key + s |
| ctrl-shift-83 | Control key + Shift key + s |
| 10 | return |
| 32 | space |
| 37 | cursor left |
| 38 | cursor up |
| 39 | cursor right |
| 40 | cursor down |
| 33 | page up |
| 34 | page down |
| 36 | Begin |
| 35 | End |
| 27 | escape |
| 127 | Del |
| 65 | a |
| 66 | b |
| 67 | c |
| 68 | d |
| 69 | e |
| 70 | f |
| 71 | g |
| 72 | h |
| 73 | i |
| 74 | j |
| 75 | k |
| 76 | l |
| 77 | m |
| 78 | n |
| 79 | o |
| 80 | p |
| 81 | q |
| 82 | r |
| 83 | s |
| 84 | t |
| 85 | u |
| 86 | v |
| 87 | w |
| 88 | x |
| 89 | y |
| 90 | z |
| 48 | 0 |
| 49 | 1 |
| 50 | 2 |
| 51 | 3 |
| 52 | 4 |
| 53 | 5 |
| 54 | 6 |
| 55 | 7 |
| 56 | 8 |
| 57 | 9 |
| 112 | F1 |
| 113 | F2 |
| 114 | F3 |
| 115 | F4 |
| 116 | F5 |
| 117 | F6 |
| 118 | F7 |
| 119 | F8 |
| 120 | F9 |
| 121 | F10 |
| 122 | F11 |
| 123 | F12 |
A popup menu item may be used in order to define hotkeys. If you do not want the popup menu item in the menu at all, the set this attribute to true.
| false | Show in menu (default) |
| true | Do not show, only serve as hotkey |
Reference to image within your web application. The image is defined in an absolute way (e.g. /images/abc.png) - the root directory for absolute addressing is the directory of the web application.
| /images/abc.png | Image /images/abc.png |
| /images/svg/def.svg | Image /images/svg/def.svg |
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 |
In CaptainCasa you can define styles definitions for components. A style definition is a definition of a set of default attribute values that are applied to the component. In case you want to differenciate between different usage types of the component you can apply multiple styles - and use the stylevariant attribute to select between.
Text that is shown and (dependent from the component type) edited inside the component. The terminator is a decimal byte value.
Text that is shown as hint when the user stays with the mouse on top of the control for a while.
| ...anytext... | Text that is displayed as tooltip. |
| server:true | Indicator that tooltip for the component is managed on server side. The actionListener will be invokde with events BaseActionEventTooltipStarted and BaseActionEventTooltipEnde. On server side you may implement some modeless popup in order to show some more complex tooltip |
| server:true;opendelay:1000 | Duration in milliseconds after which a tooltip event is triggered when the user moves the mouse on top of this component |