The OffsetX / OffsetY property specifies the (x,y)-position of the layer, relative to the upper-left corner of the control. The Value property associates a value to a layer. The ValueToOffsetX property specifies the expression to convert the value to x-offset. The ValueToOffsetY property specifies the expression to convert the value to y-offset. For instance, you can use the OffsetYValid property on "0", and so no vertical movement is allowed for the current layer. Use the DefaultLayer(exDefLayerOffsetX) property to specify the default value for the OffsetX, before adding any layer. The Change event occurs when the layer's OffsetX property is changed. The DragStart / Drag / DragEnd events notify your application when a layer is dragged.
For instance:
- "0", indicates that no horizontal movement is allowed, or in other words, OffsetX is always 0.
- "16 * int(value / 16)", specifies that only multiply of 16 is allowed for OffsetX property ( grid movement )
- "value = 0 ? 0 : ( value < 0 ? -100 : +100 )", indicates that valid values for OffsetX property is -100, 0 and +100 ( discrete movement )
- "value MIN -64 MAX 64", indicates that values of OffsetX property are between -64 and +64 ( range movement )
- "y" indicates that OffsetX property is always the same as OffsetY property ( diagonal movement )
The OffsetXValid property supports the following keywords:
- value keyword indicates the current value of OffsetX property ( the value to validate )
- y keyword specifies the current value of the OffsetY property
Also, this property supports all constants, operators and functions defined here.
The following picture shows the position/size properties of the Layer, relative to the view / control:
The following properties determines the position / size / offset of the layer:
- Left, specifies the expression relative to the view, to determine the x-position to show the current layer on the control.
- Top, specifies the expression relative to the view, to determine the y-position to show the current layer on the control.
- Width, specifies the expression relative to the view, to determine the width to show the current layer on the control.
- Height, specifies the expression relative to the view, to determine the height to show the current layer on the control.
You can use the following properties to offset the view ( background + foreground ) inside the layer:
- DefaultOffsetX, gets or sets a value that indicates the default x-offset of the layer.
- OffsetX, gets or sets a value that indicates x-offset of the layer.
- OffsetXValid, validates the x-offset value of the layer.
- Value and ValueToOffsetX specifies the expression to convert the value to x-offset.
- DefaultOffsetY, gets or sets a value that indicates the default y-offset of the layer.
- OffsetY, gets or sets a value that indicates y-offset of the layer.
- OffsetYValid, validates the y-offset value of the layer.
- Value and ValueToOffsetY specifies the expression to convert the value to y-offset.
The following properties can be used to move / resize the picture on the layer's background:
- DisplayAs, retrieves or sets a value that indicates the way how the graphic is displayed on the layer's background.
- Left, specifies the expression relative to the view/current picture, to determine the x-position to show the current picture on the background.
- Top, specifies the expression relative to the view/current picture, to determine the y-position to show the current picture on the background.
- Width, specifies the expression relative to the view/current picture, to determine the width to show the current picture on the background.
- Height, specifies the expression relative to the view/current picture, to determine the height to show the current picture on the background.