Version 8.3.4
 —  Special Development Topics  —

ABSAREA

Independent of what type of area you define for positioning controls (see previous section), it is possible to define subareas inside this area. A subarea is an area with its own x-, y- and z-coordinates and also contains absolutely positioned controls - or again: subareas.

This document covers the following topics:


Example

The following example shows a page with three groups of absolutely positioned controls - each group holding an icon (ABSICON) and a label (ABSLABEL):

graphics/image184.png

The XML layout definition contains three definitions of an ABSAREA control - with different x-, y- and z-coordinates. Inside the area, the controls are positioned with exactly the same coordinates.

<rowarea name="Absolute Area" height="500">
    <rowabsarea width="100%" height="100%">
        <absarea x="150" y="150" z="10">
            <abslabel x="5" y="5" z="10" name="This is test-position 5,5">
            </abslabel>
            <absicon image="images/remove.gif" x="0" y="0" z="0">
            </absicon>
        </absarea>
        <absarea x="150" y="400" z="10">
            <abslabel x="5" y="5" z="10" name="This is test-position 5,5">
            </abslabel>
            <absicon image="images/remove.gif" x="0" y="0" z="0">
            </absicon>
        </absarea>
        <absarea x="300" y="300" z="10">
            <abslabel x="5" y="5" z="10" name="This is test-position 5,5">
            </abslabel>
            <absicon image="images/remove.gif" x="0" y="0" z="0">
            </absicon>
        </absarea>
    </rowabsarea>
</rowarea>

An ABSAREA control opens its own area on the page, providing its own coordinate system.

In this example, the x-, y- and z-coordinates for each area are defined inside the layout definition. Set the position dynamically by deriving the x-, y- and z-values by the adapter properties.

Top of page

Properties

Basic
x

X-coordinate (in pixels) of the left top corner of the area.

Optional  
y

Y-coordinate (in pixels) of the left top corner of the area.

Optional  
z

Z-coordinate (in pixels) of the left top corner of the area.

Optional  
xprop

Name of adapter properties for the x-coordinates.

Optional  
yprop

Name of adapter properties for the y-coordinates.

Optional  
zprop

Name of adapter properties for the z-coordinates.

Optional  
comment

Comment without any effect on rendering and behaviour. The comment is shown in the layout editor's tree view.

Optional  

Either all of the properties x, y and z have to be defined or all the properties xprop, yprop and zprop have to be defined.

Top of page