Properties of the ICON_GRID 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
_OGW_MOVE	The control moves relative to the window.
_OGW_EXPAND	The control expands of contracts.
_OGW_ANCHOR	The control does not move relative to the window.
_OGW_DEFAULT	Corresponds to the value _OGW_ANCHOR if the control is in a pane located above the bar. Corresponds to the value _OGW_MOVE if located in a pane at the bottom.
Conditions of use	The object must be in a split bar pane.

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
_OGW_MOVE	The control moves relative to the window.
_OGW_EXPAND	The control expands of contracts.
_OGW_ANCHOR	The control does not move relative to the window.
_OGW_DEFAULT	Corresponds to the value _OGW_ANCHOR if the control is in a pane located above the bar. Corresponds to the value _OGW_MOVE if located in a pane on the right.
Conditions of use	The object must be in a split bar pane.

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
_OGW_MOVE	The control moves relative to the window.
_OGW_EXPAND	The control expands of contracts.
_OGW_ANCHOR	The control does not move relative to the window.
_OGW_DEFAULT	Corresponds to the value _OGW_ANCHOR if the control is in a pane located above the bar. Corresponds to the value _OGW_MOVE if located in a pane on the right.
Conditions of use	The object must be in a split bar pane.

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
_OGW_MOVE	The control moves relative to the window.
_OGW_EXPAND	The control expands of contracts.
_OGW_ANCHOR	The control does not move relative to the window.
_OGW_DEFAULT	Corresponds to the value _OGW_ANCHOR if the control is in a pane located above the bar. Corresponds to the value _OGW_MOVE if located in a pane at the bottom.
Conditions of use	The object must be in a split bar pane.

ACTIVE

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

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

BACKGROUND_COLOR

Default RGB color used to draw the background for the object (transparent by default if _OGW_COL_SYSTEM).

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read/Write.
Execution mode	Read/Write.
Associated constants
_OGW_COL_SYSTEM	system color (transparent)
_OGW_COL_BLACK	the color black
_OGW_COL_BLUE	the color blue
_OGW_COL_CYAN	the color cyan
_OGW_COL_GREEN	the color green
_OGW_COL_MAGENTA	the color magenta
_OGW_COL_RED	the color red
_OGW_COL_WHITE	the color white
_OGW_COL_YELLOW	the color yellow
_OGW_COL_DARKBLUE	the color dark blue
_OGW_COL_DARKCYAN	the color dark cyan
_OGW_COL_DARKGREEN	the color dark green
_OGW_COL_DARKRED	the color dark red
_OGW_COL_DARKYELLOW	the color dark yellow
_OGW_COL_GREY	the color gray
_OGW_COL_DARKGREY	the color dark gray
Conditions of use	None
Default value	_OGW_COL_SYSTEM.

BORDER

Draws a frame around the object.

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

COLUMNS

Grid width (number of icons).

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

CSS_ICON_BORDER_COLOR

CSS border-color style property. Defines the default color of icon borders. This color can be overridden for a specific icon by calling the SET_ICON_COLORS method.

Adelia type	NUM_BIN_4
Accessibility
Layout design mode	No
Execution mode	Read / Write
Associated constants
_OGW_COL_SYSTEM	"system" color
_OGW_COL_BLACK	"black" color
_OGW_COL_BLUE	"blue" color
_OGW_COL_CYAN	"cyan" color
_OGW_COL_GREEN	"green" color
_OGW_COL_MAGENTA	"magenta" color
_OGW_COL_RED	"red" color
_OGW_COL_WHITE	"white" color
_OGW_COL_YELLOW	"yellow" color
_OGW_COL_DARKBLUE	"dark blue" color
_OGW_COL_DARKCYAN	"dark cyan" color
_OGW_COL_DARKGREEN	"dark green" color
_OGW_COL_PURPLE	"purple" color
_OGW_COL_DARKRED	"dark red" color
_OGW_COL_DARKYELLOW	"dark yellow" color
_OGW_COL_GREY	"grey" color
_OGW_COL_DARKGREY	"dark grey" color
Conditions for use	none
Default value	none

CSS_ICON_BORDER_RADIUS

CSS border-radius style property. Rounds the icon borders.

Adelia type	ALPHA(50)
Accessibility
Layout design mode	No
Execution mode	Read / Write
Associated constants	none
Conditions for use	none
Default value	none

CSS_ICON_BORDER_STYLE

CSS border-style style property. Defines the icon border style.

Adelia type	ALPHA(50)
Accessibility
Layout design mode	No
Execution mode	Read / Write
Associated constants	none
Conditions for use	none
Default value	none

CSS_ICON_BORDER_WIDTH

CSS border-width style property. Defines the icon border size.

Adelia type	ALPHA(50)
Accessibility
Layout design mode	No
Execution mode	Read / Write
Associated constants	none
Conditions for use	none
Default value	none

CURRENT_PAGE

Active page index.

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

FONT

Character font used to display the object text.

The string format contains the name, size, style and script, in that order. A semi-colon must be inserted between each element.

If you set a property's value, you MUST specify the name and size.

The different styles are specified using the following values:

1: Normal (no special style)

2: Strikethrough

16: Italics

256: Bold

4096: Underlined

The style value to be specified in the string can either be one of the above values or else the sum of values other than 1.

Adelia type	ALPHA(250).
Accessibility
Layout design mode	Read/Write
Execution mode	Read/Write
Associated constants	None
Conditions of use	None
Default value	"Microsoft Sans Serif;8;1;0"

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
_OGW_ADJUST_EXPAND_WIDTH	The control is expanded width-wise.
_OGW_ADJUST_ALIGNED_LEFT	The control keeps its left side alignment.
_OGW_ADJUST_ALIGNED_RIGHT	The control keeps its right side alignment.
_OGW_ADJUST_ALIGNED_CENTER	The control keeps its center alignment.
_OGW_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	_OGW_ADJUST_ALIGNED_LEFT.

ICON_BACKGROUND_COLOR

RGB color used to draw the background for the icon (transparent by default if _OGW_COL_SYSTEM). This color can be overridden for a specific icon by calling the SET_ICON_COLORS method.

Adelia type	NUM_BIN_4
Accessibility
Layout design mode	Read/Write
Execution mode	Read/Write
Associated constants
_OGW_COL_SYSTEM	system color (transparent)
_OGW_COL_BLACK	the color black
_OGW_COL_BLUE	the color blue
_OGW_COL_CYAN	the color cyan
_OGW_COL_GREEN	the color green
_OGW_COL_MAGENTA	the color magenta
_OGW_COL_RED	the color red
_OGW_COL_WHITE	the color white
_OGW_COL_YELLOW	the color yellow
_OGW_COL_DARKBLUE	the color dark blue
_OGW_COL_DARKCYAN	the color dark cyan
_OGW_COL_DARKGREEN	the color dark green
_OGW_COL_DARKRED	the color dark red
_OGW_COL_DARKYELLOW	the color dark yellow
_OGW_COL_GREY	the color gray
_OGW_COL_DARKGREY	the color dark gray
Conditions of use	None
Default value	_OGW_COL_SYSTEM.

ICON_SPACING

Space between icons in pixels. Only useful if the CSS_ICON_BORDER property is set.

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

ICON_TEXT_VISIBILITY

Specifies if the text associated with the icons is displayed.

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

IMAGE_HEIGHT

Height of icon images in pixels.

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

IMAGE_WIDTH

Width of icons in pixels.

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

NAME

Static name of the object.

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

NOTIFICATION_BACKGROUND_COLOR

RGB color used to draw the background for the notification text on the icon (red by default if _OGW_COL_SYSTEM).

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read/Write.
Execution mode	Read/Write.
Associated constants
_OGW_COL_SYSTEM	system color (red)
_OGW_COL_BLACK	the color black
_OGW_COL_BLUE	the color blue
_OGW_COL_CYAN	the color cyan
_OGW_COL_GREEN	the color green
_OGW_COL_MAGENTA	the color magenta
_OGW_COL_RED	the color red
_OGW_COL_WHITE	the color white
_OGW_COL_YELLOW	the color yellow
_OGW_COL_DARKBLUE	the color dark blue
_OGW_COL_DARKCYAN	the color dark cyan
_OGW_COL_DARKGREEN	the color dark green
_OGW_COL_DARKRED	the color dark red
_OGW_COL_DARKYELLOW	the color dark yellow
_OGW_COL_GREY	the color gray
_OGW_COL_DARKGREY	the color dark gray
Conditions of use
Default value	_OGW_COL_SYSTEM (red).

NOTIFICATION_TEXT_COLOR

RGB color of icon notification text (white by default if _OGW_COL_SYSTEM).

Adelia type	NUM_BIN_4
Accessibility
Layout design mode	Read/Write.
Execution mode	Read/Write.
Associated constants
_OGW_COL_SYSTEM	system color
_OGW_COL_BLACK	the color black
_OGW_COL_BLUE	the color blue
_OGW_COL_CYAN	the color cyan
_OGW_COL_GREEN	the color green
_OGW_COL_MAGENTA	the color magenta
_OGW_COL_RED	the color red
_OGW_COL_WHITE	the color white
_OGW_COL_YELLOW	the color yellow
_OGW_COL_DARKBLUE	the color dark blue
_OGW_COL_DARKCYAN	the color dark cyan
_OGW_COL_DARKGREEN	the color dark green
_OGW_COL_DARKRED	the color dark red
_OGW_COL_DARKYELLOW	the color dark yellow
_OGW_COL_GREY	the color gray
_OGW_COL_DARKGREY	the color dark gray
Conditions of use	None.
Default value	System color (white).

PAGE_COUNT

Number of pages.

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

ROWS

Grid height (number of icons).

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

SHADOW_COLOR

Default RGB color of text shadow (black by default if _OGW_COL_SYSTEM). This color can be overridden for a specific icon by calling the SET_ICON_COLORS method.

Adelia type	NUM_BIN_4
Accessibility
Layout design mode	Read/Write.
Execution mode	Read/Write.
Associated constants
_OGW_COL_SYSTEM	system color
_OGW_COL_BLACK	the color black
_OGW_COL_BLUE	the color blue
_OGW_COL_CYAN	the color cyan
_OGW_COL_GREEN	the color green
_OGW_COL_MAGENTA	the color magenta
_OGW_COL_RED	the color red
_OGW_COL_WHITE	the color white
_OGW_COL_YELLOW	the color yellow
_OGW_COL_DARKBLUE	the color dark blue
_OGW_COL_DARKCYAN	the color dark cyan
_OGW_COL_DARKGREEN	the color dark green
_OGW_COL_DARKRED	the color dark red
_OGW_COL_DARKYELLOW	the color dark yellow
_OGW_COL_GREY	the color gray
_OGW_COL_DARKGREY	the color dark gray
Conditions of use	None.
Default value	System color (black).

TEXT_COLOR

Default RGB color of text (white by default if _OGW_COL_SYSTEM). This color can be overridden for a specific icon by calling the SET_ICON_COLORS method.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read/Write.
Execution mode	Read/Write.
Associated constants
_OGW_COL_SYSTEM	system color
_OGW_COL_BLACK	the color black
_OGW_COL_BLUE	the color blue
_OGW_COL_CYAN	the color cyan
_OGW_COL_GREEN	the color green
_OGW_COL_MAGENTA	the color magenta
_OGW_COL_RED	the color red
_OGW_COL_WHITE	the color white
_OGW_COL_YELLOW	the color yellow
_OGW_COL_DARKBLUE	the color dark blue
_OGW_COL_DARKCYAN	the color dark cyan
_OGW_COL_DARKGREEN	the color dark green
_OGW_COL_DARKRED	the color dark red
_OGW_COL_DARKYELLOW	the color dark yellow
_OGW_COL_GREY	the color gray
_OGW_COL_DARKGREY	the color dark gray
Conditions of use	None.
Default value	System color (white).

TEXT_SHADOW

Specifies if the text has a shadow.

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

TITLE_HEIGHT

Height of page title or 0 to hide the title.

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

TITLE_POSITION

Title position.

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

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
_OGW_ADJUST_EXPAND_HEIGHT	The control is extended height-wise.
_OGW_DJUST_ALIGNED_TOP	The control keeps its top side alignment.
_OGW_AJUST_ALIGNED_BOTTOM	The control keeps its bottom side alignment.
_OGW_ADJUST_ALIGNED_CENTER	The control keeps its center alignment.
_OGW_ADJUST_NONE	No vertical 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	_OGW_ADJUST_EXPAND_HEIGHT.

VISIBILITY

Visibility of the object.

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

WIDTH

Object's width value.

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

X_AXIS

Value of the object's X coordinate, relative to the area covered by the window.

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

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

Y_AXIS

Y-axis value of the object relative to the area covered by the window, page or view.

The reference point is the top-left point of the object.

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