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
Used inside: ADAPTIVETILECONTAINER, ADAPTIVETOOLBAR, AREASELECTOR, BLOCKABLEAREA, BUTTONPOPUP, COLSYNCHEDROW, CUBEROTATOR, DRAWAREA, FLYINCONTENTAREA, FOLDABLEPANEHEADERROW, GRIDHEADERLABEL, GRIDLAYOUTROW, HIDEABLE, LABELCONTAINER, LAYEREDPANE, OVERLAYAREABASEITEM, OVERLAYAREAITEM, PAGEBEANROOT, PAINTAREAITEM, REPEAT, ROTATECONTENTAREA, ROW, ROWADAPTIVELINE, ROWFLEXCOLUMNCONTAINER, ROWFLEXLINECONTAINER, ROWFOOTER, ROWHEADER, ROWMATRIXAREA, ROWTITLEBAR, SCALEPANE, SCHEDULEITEM, SCHEDULEITEMAREA, SHIFTCONTAINER, SIZEANIMATIONAREA, STABLEAREA, STABLEAREACONFIGAREA, TABBEDAREABEGIN, TABBEDAREAEND, TEXTWITHCONTROLS, TREENODE
Using inside: ADAPTIVEGRIDLAYOUTPANE, ADAPTIVESPLITAREA, ANIMATEDPANE, AREASELECTOR, BLOCKABLEAREA, BOX, COLSYNCHEDPANE, CUBEROTATOR, FLYINCONTENTAREA, FOLDABLEPANE, FOLDABLEPOPUPINCLUDE, FOLDABLEVERTICALPANE, GRIDLAYOUTPANE, LAYEREDPANE, OVERLAYAREA, PAINTAREA, PANE, PARENTEXIT, REPEAT, ROLLINGCONTAINERAREA, ROTATECONTENTAREA, SCALEPANE, SCROLLPANE, SIZEABLEPANE, SIZEABLEPANEHORIZONTAL, SIZEANIMATIONAREA, SPLITPANE, STABLEAREAMANAGER, STABLEAREAPLACEHOLDER, TABBEDLINECONTAINER, TABBEDPANE, TEXTWITHCONTROLS, TILEDAREA
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 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).
The attribute value must be an expression.
| #{tobedefined} | Binding to IComponentAdapter instance |
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.
In case the content of the component exceeds the available height and in case the height is defined as percentage value then the content by default will expand the height correspondingly. But, if defined as true, then the content will be cut.
| true | Cut content to fit into available height |
| false | Expand surrounding layout (default) |
In case the content of the component exceeds the available width and in case the width is defined as percentage value then the content by default will expand the width correspondingly. But, if defined as true, then the content will be cut.
| true | Cut content to fit into available width |
| false | Expand surrounding layout (default) |
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 use an extended syntax: "xxx%;<min>;<max>": in this case the minimum and maximum definitions are respected. 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 |
| 100%;100 | Full available height, minimum 100 pixels |
| 100%;100;500 | Full available height, minimum 100 pixels, maximum 500 pixels |
| 100%;;500 | Full available height, maximum 500 pixels |
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.
The attribute value must not be changed once the component is created.
| 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 use an extended syntax: "xxx%;<min>;<max>": in this case the minimum and maximum definitions are respected. - 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 |
| 100%;100 | Full available width, minimum 100 pixels |
| 100%;100;500 | Full available width, minimum 100 pixels, maximum 500 pixels |
| 100%;;500 | Full available width, maximum 500 pixels |
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!