Component SCALEPANE

Overview

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.

Attribute summary

Typically used attributes

All attributes are

General attributes are

Positioning

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

Attribute details

actionListener

Binding to server side method that processes the events coming from this component.

#{methodBinding}Method binding

animatechangeofsize

If set to true then changes of the width/height of the component are animated.

trueWith animation
falseWithout animation (default)

autoscale

If set to true, then pane will automatically scale so that the content fits inside.

trueThe scale is calculated internally
false(default) No auto-scaling: scaling follows value of SCALE attribute

comment

Comment that can be asigned to any component. The comment is not operationally used.

Any textAny text

configinfo

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.

flush

Indicator if data changed in the component are transferred immediately to the server, causing a normal round trip processing from client to server.

trueFlush is done on data change.
falseNo flush. Data is transferred to server with next round trip.

height

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.

100100 Pixels
120120 Pixels
200200 Pixels
50%50 percents
100%Full available height

maxscale

Maximum scaling that can be defined due to user interaction.

 any float value, well reasonable is something between 1.0 and 2.0 ...
1.0100% (default)
1.25125%
1.5150%

minscale

Minimum scaling that can be defined due to user interaction.

 any float value, well reasonable is something between 1.0 and 2.0 ...
1.0100% (default)
1.25125%
1.5150%

reference

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.

refOne reference
ref1;ref2Two references
ref1;ref2;ref3Three references

scale

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.0100% (default)
1.25125%
1.5150%

width

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.

100100 Pixels
120120 Pixels
200200 Pixels
50%50 percents
100%Full available width

withscrollpositionupdate

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
trueUpdate of scroll position - requires the component to be placed inside a SCROLLPANE!

withuserscaling

Defines if the user can zoom in/out.

falseNo scaling/zooming by user (default)
trueUser is able to scale/zoom content on his/her own, using the mouse wheel.

x

x-pixel-position: this attribute is only used if the component is directly placed into a PAINTAREA!

y

y-pixel-position: this attribute is only used if the component is directly placed into a PAINTAREA!