The SCALEPANE is a container component that can scale its content.
If defining WITHUSERSCALING to "true" then the user can scale the content on his/her own. In a desktop system this is done either by pressing the ctrl-key and spinning the mouse wheel or by using the keyboard short cuts "ctrl-+", "ctrl--" and "ctrl-0".
Please pay attention: in this case the VALUE is not only read from the server side but also is written back: your server-side property binding must provide a corresponding set-ter method. - By setting FLUSH to "true" changes are sent to the server immediately, otherwise changes are sent with the next round-trip.
Typically used attributes
All attributes are
General attributes are
Used inside: ADAPTIVETILECONTAINER, ADAPTIVETOOLBAR, AREASELECTOR, BLOCKABLEAREA, BUTTONPOPUP, COLSYNCHEDROW, DRAWAREA, FOLDABLEPANEHEADERROW, GRIDHEADERLABEL, GRIDLAYOUTROW, HIDEABLE, LABELCONTAINER, OVERLAYAREABASEITEM, OVERLAYAREAITEM, PAGEBEANROOT, PAINTAREAITEM, REPEAT, ROW, ROWADAPTIVELINE, ROWFLEXCOLUMNCONTAINER, ROWFLEXLINECONTAINER, ROWFOOTER, ROWHEADER, ROWMATRIXAREA, ROWTITLEBAR, SCALEPANE, SCHEDULEITEM, SHIFTCONTAINER, STABLEAREA, STABLEAREACONFIGAREA, TEXTWITHCONTROLS, TREENODE
Using inside: ADAPTIVESPLITAREA, ANIMATEDPANE, AREASELECTOR, BLOCKABLEAREA, BOX, COLSYNCHEDPANE, FOLDABLEPANE, FOLDABLEPOPUPINCLUDE, FOLDABLEVERTICALPANE, GRIDLAYOUTPANE, LAYEREDPANE, OVERLAYAREA, PAINTAREA, PANE, PARENTEXIT, REPEAT, ROLLINGCONTAINERAREA, SCALEPANE, SCROLLPANE, SIZEABLEPANE, SIZEABLEPANEHORIZONTAL, SPLITPANE, STABLEAREAMANAGER, STABLEAREAPLACEHOLDER, TABBEDLINECONTAINER, TABBEDPANE, TEXTWITHCONTROLS, TILEDAREA
Binding to server side method that processes the events coming from this component.
#{methodBinding} | Method binding |
If set to true then changes of the width/height of the component are animated.
true | With animation |
false | Without animation (default) |
If set to true, then pane will automatically scale so that the content fits inside.
true | The scale is calculated internally |
false | (default) No auto-scaling: scaling follows value of SCALE attribute |
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 data changed in the component are transferred immediately to the server, causing a normal round trip processing from client to server.
true | Flush is done on data change. |
false | No flush. Data is transferred to server with next round trip. |
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 percentage sizing then you may define a minimum size in addition, by appending it with a semicolon: "100%;100" means: use 100%, but always keep a minimum size of 100. If using absolute sizes you may append a "+" to define, that the size is extended if required by the component. - Please note: the sizing may be completely taken over by the parent component (e.g. if a component is used in a grid cell), in this case the size definintions on this component level are obsolete.
100 | 100 Pixels |
120 | 120 Pixels |
200 | 200 Pixels |
50% | 50 percents |
100% | Full available height |
Maximum scaling that can be defined due to user interaction.
any float value, well reasonable is something between 1.0 and 2.0 ... | |
1.0 | 100% (default) |
1.25 | 125% |
1.5 | 150% |
Minimum scaling that can be defined due to user interaction.
any float value, well reasonable is something between 1.0 and 2.0 ... | |
1.0 | 100% (default) |
1.25 | 125% |
1.5 | 150% |
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 |
Scaling of sizes on client side. Float value. If attribute SCALEFONT is not set, then the scale value is taken for fonts scaling, too.
any float value, well reasonable is something between 1.0 and 2.0 ... | |
1.0 | 100% (default) |
1.25 | 125% |
1.5 | 150% |
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 percentage sizing then you may define a minimum size in addition, by appending it with a semicolon: "100%;100" means: use 100%, but always keep a minimum size of 100. If using absolute sizes you may append a "+" to define, that the size is extended if required by the component. - Please note: the sizing may be completely taken over by the parent component (e.g. if a component is used in a grid cell), in this case the size definintions on this component level are obsolete.
100 | 100 Pixels |
120 | 120 Pixels |
200 | 200 Pixels |
50% | 50 percents |
100% | Full available width |
If the component is positioned within a SCROLLPANE, then the scroll positions is updated automatically so that the current center of the view is kept.
false | (default) No update of scroll position |
true | Update of scroll position - requires the component to be placed inside a SCROLLPANE! |
Defines if the user can zoom in/out.
false | No scaling/zooming by user (default) |
true | User is able to scale/zoom content on his/her own, using the mouse wheel. |
x-pixel-position: this attribute is only used if the component is directly placed into a PAINTAREA!
y-pixel-position: this attribute is only used if the component is directly placed into a PAINTAREA!