ICON

A ICON control merely displays an ICON image (ie, some graphic stored in an .ico file format).


Uses

Can be used for decoration or display some visual information such as a company logo.


Styles

An ICON may have any, all, or none of the following styles:

Notify Causes the Window Layout's DBLCLK or CLICK subroutines for this control to be called when the mouse is double-clicked or clicked on the image.
Sunken Creates a border with a sunken edge around the picture.
Center image (CENTER) The image is centered in the ICON control. The control is not resized, so that an image too large for the control will be clipped.
Right justify (FIXRIGHT) The lower right corner of the ICON is to remain fixed when the control is resized. Only the top and left sides are adjusted to accommodate a new image loaded into the area.
Real size image (REALSIZE) The ICON (area) is not resized to fit the real size of the image. If the image is larger than the ICON area, the image is scaled to fit the original ICON area. If CENTER style is also specified, the image is centered (and clipped if needed). If CENTER is not specified, the image is stretched or shrunk.
FIXSIZE The ICON is resized (down and to the right) to automatically fit the full, original image. If CENTER style is also specified, then the image is centered within the control.
No Sibling (NOSIBLING) Prevents this control from drawing into any overlapping controls.
Group Marks this control as the first of a group of controls in which the user can move from one control to the next with the arrow keys. All subsequent controls (after this first control) belong to the same group up to the next control that has its GROUP flag set. (ie, One group ends where the next begins).
Disabled Control is initially disabled. You can later enable it with a call to GuiSetCtlPlacement.
Hide Control is hidden. You can later make it visible with a call to GuiSetCtlPlacement.
Border Creates a border around the picture.


Events

An ICON generates the following events:

Event name When it occurs
CLICK The user has clicked on the image. Note: A disabled ICON does not cause a CLICK event. This event also does not occur if the NOTIFY style is not specified for the control.
DBLCLK The user has double-clicked on the image. Note: A disabled ICON does not cause a DBLCLK event. This event also does not occur if the NOTIFY style is not specified for the control.


REXX Variable

An ICON must have a REXX variable associated with it only if you specify the NOTIFY style, or you wish to be able to change its state (with GuiSetCtlPlacement) or image. You do not need to initialize the variable before opening the window which contains the ICON control.