Properties of the IMAGE Object

ACTION_MOVE_BOTTOM_SIDE

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the horizontal bar below the object, or when he/she resizes the window below and when the split bar expands (VERTICAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_HEIGHT) and if the object belongs to one of the bottommost views.

Accessibility
Layout design mode	Read / Write,
Execution mode	Read / Write.
Associated constants
_IMG_MOVE	The control moves relative to the window.
_IMG_EXPAND	The control expands of contracts.
_IMG_ANCHOR	The control does not move relative to the window.
_IMG_DEFAULT	Corresponds to the value _IMG_ANCHOR if the control is in a pane located above the bar. Corresponds to the value _IMG_MOVE if located in a pane at the bottom.
Conditions for use	The object must be in a split bar pane.

Note: This property is not implemented in Java and Mobile generation.

ACTION_MOVE_LEFT_SIDE

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the vertical bar to the left of the object, or when he/she resizes the window below and when the split bar expands (HORIZONTAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_WIDTH) and if the object belongs to one of the rightmost views.

Accessibility
Layout design mode	Read / Write,
Execution mode	Read / Write.
Associated constants
_IMG_MOVE	The control moves relative to the window.
_IMG_EXPAND	The control expands of contracts.
_IMG_ANCHOR	The control does not move relative to the window.
_IMG_DEFAULT	Corresponds to the value _IMG_ANCHOR if the control is in a pane located to the left of the bar. Corresponds to the value _IMG_MOVE if located in a pane on the right.
Conditions for use	The object must be in a split bar pane.

Note: This property is not implemented in Java and Mobile generation.

ACTION_MOVE_RIGHT_SIDE

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the vertical bar to the right of the object, or when he/she resizes the window below and when the split bar expands (HORIZONTAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_WIDTH) and if the object belongs to one of the rightmost views.

Accessibility
Layout design mode	Read / Write,
Execution mode	Read / Write.
Associated constants
_IMG_MOVE	The control moves relative to the window.
_IMG_EXPAND	The control expands of contracts.
_IMG_ANCHOR	The control does not move relative to the window.
_IMG_DEFAULT	Corresponds to the value _IMG_ANCHOR if the control is in a pane located to the left of the bar. Corresponds to the value _IMG_MOVE if located in a pane on the right.
Conditions for use	The object must be in a split bar pane.

Note: This property is not implemented in Java and Mobile generation.

ACTION_MOVE_TOP_SIDE

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the horizontal bar above the object, or when he/she resizes the window above and when the split bar expands (VERTICAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_HEIGHT) and if the object belongs to one of the bottommost views.

Accessibility
Layout design mode	Read / Write,
Execution mode	Read / Write.
Associated constants
_IMG_MOVE	The control moves relative to the window.
_IMG_EXPAND	The control expands of contracts.
_IMG_ANCHOR	The control does not move relative to the window.
_IMG_DEFAULT	Corresponds to the value _IMG_ANCHOR if the control is in a pane located above the bar. Corresponds to the value _IMG_MOVE if located in a pane at the bottom.
Conditions for use	The object must be in a split bar pane.

Note: This property is not implemented in Java and Mobile generation.

ACTIVE

Specifies whether the image responds to the user's keyboard and mouse actions.

This property is mainly used when transparent objects overlap the image.

When it has the *FALSE value, it is possible to select overlapped objects in the layout manager. The overlapped objects also respond to the user's actions.

For more information about managing overlapping of graphical objects, consult the working with object overlap section.

Adelia type	BOOL.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	None.
Conditions for use	None.
Default value	*TRUE

BITMAP

Image displayed inside the object.

Adelia type	IMAGE.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	None.
Conditions for use	None.
Default value	None.

DD_DROP_ALLOWED

Specifies whether an object can be the destination of drag and drop operations.

Adelia type	BOOL.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	None.
Conditions for use	None.
Default value	*FALSE

Note: This property is not implemented by the Java generator.

HEIGHT

Height value of the object.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	None.
Conditions for use	None.
Default value	204

HORIZONTAL_ADJUSTMENT

Defines how the graphical control is adjusted when the window is resized horizontally.

Adelia type	NUM_BIN_2.
Accessibility
Layout design mode	Read/Write.
Execution mode	Read/Write.
Associated constants
_IMG_ADJUST_EXPAND_WIDTH	The control is expanded width-wise.
_IMG_ADJUST_ALIGNED_LEFT	The control keeps its left side alignment.
_IMG_ADJUST_ALIGNED_RIGHT	The control keeps its right side alignment.
_IMG_ADJUST_ALIGNED_CENTER	The control keeps its center alignment.
_IMG_ADJUST_NONE	No horizontal adjustment is applied to the control.
Conditions of use	This property applies when the window's ADJUSTMENT property is other than _WIN_ADJUST_NONE and when the object is not part of a Split bar pane. When executed, its value is taken into account before initializing the window and when the window's ADJUSTMENT property is modified. At this point, the object's VISIBILITY property must be True. Otherwise, the control will not be adjusted. The modification is only taken into account if the window's ADJUSTMENT property is _WIN_ADJUST_NONE. Otherwise it is ignored.
Default value	_IMG_ADJUST_ALIGNED_LEFT

Note: This property is not implemented in Java and Mobile generation.

IMAGE_LOCATION

Specifies the location of the image displayed inside the object.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants
_IMG_LOCATION_CENTER_IMAGE	The image is centered within the object.
_IMG_LOCATION_TOP_LEFT_JUSTIFY	The image is aligned from the top and left edges of the object.
_IMG_LOCATION_EXTENDED	The image is extended over the object area and will be distorted if its proportions are different from those of the object.
_IMG_LOCATION_CONTAINED	The image is extended so it is fully displayed while maintaining its proportions. Bands may appear in the object if the image proportions do not correspond to those of the object.
_IMG_LOCATION_COVERED	The image is extended so it fully covers the whole area of the object while maintaining its proportions. Part of the image may not be displayed if the image proportions do not correspond to those of the object.
Conditions for use	None.
Default value	_IMG_LOCATION_CENTER_IMAGE

NAME

Static name of the object.

Adelia type	ALPHA(128).
Accessibility
Layout design mode	Read/Write.
Execution mode	Read.
Associated constants	None.
Conditions for use	None.
Default value	Prefix of the basic object.

OVERLAP

Authorizes the image object to draw itself over a control positioned in front of it in the window object order.

This property must be set to *TRUE when the image is transparent and the user wishes to overlay it onto another object.

Example

Transparent image T is placed partially or entirely over image F (transparent or not). For T to be displayed above F and for F to be visible in the transparent areas of T, the "overlap" property of T must be set to *TRUE and T must be after F in the window object order.

Note: If a transparent image is likely to move during window execution (via the object adjustment mode for example), the window's FORCE_REDRAW_OBJECTS property must be set to *TRUE.

Adelia type	BOOL.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	None.
Conditions for use	None.
Default value	*TRUE.

For more information about managing overlapping of graphical objects, consult the working with object overlap section.

Note: This property is not implemented in Java, Mobile and Cloud generation.

SCROLL_BARS

Specifies whether scroll bars must be displayed to allow access to the truncated parts of the image. If the complete image is displayed, the scroll bars will be invisible even if the property is set to *TRUE.

Adelia type	BOOL.
Accessibility
Layout design mode	Read / Write,
Execution mode	Read / Write.
Associated constants	None.
Conditions for use	None.
Default value	*FALSE

Note: This property is not available in Java generation and in Mobile generation.

TRUE_HEIGHT

Provides the actual height of the image.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	No.
Execution mode	Read.
Associated constants	None.
Conditions for use	None.
Default value	0

Note: This property is not implemented by the Java generator.

TRUE_WIDTH

Provides the actual width of the image.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	No.
Execution mode	Read.
Associated constants	None.
Conditions for use	None.
Default value	0

Note: This property is not implemented by the Java generator.

VERTICAL_ADJUSTMENT

Defines how the graphical control is adjusted when the window is resized vertically.

Adelia type	NUM_BIN_2.
Accessibility
Layout design mode	Read/Write.
Execution mode	Read/Write.
Associated constants
_IMG_ADJUST_EXPAND_HEIGHT	The control is extended height-wise.
_IMG_ADJUST_ALIGNED_TOP	The control keeps its top side alignment.
_IMG_ADJUST_ALIGNED_BOTTOM	The control keeps its bottom side alignment.
_IMG_ADJUST_ALIGNED_CENTER	The control keeps its center alignment.
_IMG_ADJUST_NONE	No vertical adjustment is applied to the control.
Conditions for use	This property applies when the window's ADJUSTMENT property is other than _WIN_ADJUST_NONE and when the object is not part of a Split bar pane. When executed, its value is taken into account before initializing the window and when the window's ADJUSTMENT property is modified. At this point, the object's VISIBILITY property must be True. Otherwise, the control will not be adjusted. The modification is only taken into account if the window's ADJUSTMENT property is _WIN_ADJUST_NONE. Otherwise it is ignored.
Default value	_IMG_ADJUST_ALIGNED_TOP.

Note: This property is not implemented in Java and Mobile generation.

VISIBILITY

Visibility of the object.

Adelia type	BOOL.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	None.
Conditions for use	None.
Default value	*TRUE

WIDTH

Width value of the object.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	None.
Conditions for use	None.
Default value	195

X_AXIS

X coordinate value of the object's position relative to the area covered by the window, page or pane.

The reference point (origin) is the top left corner of the object.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	None.
Conditions for use	None.
Default value	None.

Y_AXIS

Y coordinate value of the object's position relative to the area covered by the window, page or pane.

The reference point (origin) is the top left corner of the object.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	None.
Conditions for use	None.
Default value	None.