@...IMAGE
DEFINE IMAGE 
Creates an image control.
  

An image static control can display bitmaps, icons (including animated icons), JPEG, GIF, CUR PNG TIF or enhanced metafiles. 

SYNTAX

Standard Window:

@ <nRow> ,<nCol> IMAGE <ControlName>
[ ID <
nId> ]
[ OF | PARENT | DIALOG <
ParentWindowName> ]
PICTURE <
cPictureName>
[ ACTION | ONCLICK | ON CLICK <
OnClickProcedure> | <bBlock> ]
[ ON MOUSEHOVER | ONMOUSEHOVER <
OnHoverProcedure> | <bBlock> ]
[ ON MOUSELEAVE | ONMOUSELEAVE <
OnLeaveProcedure> | <bBlock>]
[ WIDTH <
nWidth> HEIGHT <nHeight> ]
[STRETCH ]
WHITEBACKGROUND
[ TRANSPARENT ]
[ TOOLTIP <
cToolTipText> ]
[ ADJUSTIMAGE, | ADJUST> ]
[ HELPID <
nHelpId> ]
[ INVISIBLE ]

@ <nRow> ,<nCol> IMAGE <ControlName>
[ ID <
nId> ]
[ OF | PARENT | DIALOG <
ParentWindowName> ]
PICTURE <
cPictureName>
[ ACTION | ONCLICK | ON CLICK <
OnClickProcedure> | <bBlock> ]
[ ON MOUSEHOVER | ONMOUSEHOVER <
OnHoverProcedure> | <bBlock> ]
[ ON MOUSELEAVE | ONMOUSELEAVE <
OnLeaveProcedure> | <bBlock> ]
[ WIDTH <
nWidth> HEIGHT <nHeight> ]
[STRETCH ]
[ TRANSPARENT ]
[ TOOLTIP <
cToolTipText> ]
[ BACKGROUNDCOLOR <
anBackColor> ]
[ ADJUSTIMAGE, | ADJUST> ]
[ HELPID <
nHelpId> ]
[ INVISIBLE ]


Dialog Window:

REDEFINE IMAGE <ControlName>
ID <
nId>
[ OF | PARENT | DIALOG <
ParentWindowName> ]
PICTURE <
cPictureName>
[ ACTION | ONCLICK | ON CLICK <
OnClickProcedure> | <bBlock> ]
[STRETCH ]
[ WHITEBACKGROUND ]
[TRANSPARENT ]
[ TOOLTIP <
cToolTipText> ]
[ HELPID <
nHelpId> ]
[ INVISIBLE ]

Alternate Syntax:

DEFINE IMAGE <ControlName>

[ ID <nId> ]
[ PARENT <
ParentWindowName> ]
COL <
nCol>
ROW <
nRow>
PICTURE <
cPictureName>
[ ACTION | <
OnClickProcedure> | <bBlock> ]
[ ONMOUSEHOVER <
OnHoverProcedure> | <bBlock> ]
[ ONMOUSELEAVE <
OnLeaveProcedure> | <bBlock> ]
[ WIDTH <
nWidth> HEIGHT <nHeight> ]
[STRETCH < .T. | .F.> ]
[ WHITEBACKGROUND < .T. | .F.> ]
[ BACKGROUNDCOLOR <
anBackColor> ]
[TRANSPARENT < .T. | .F. ]
[ TOOLTIP <
cToolTipText> ]
[ ADJUSTIMAGE,< .T. | .F.> ]
[ HELPID <
nHelpId> ]
[ INVISIBLE < .T. | .F.> ]

END IMAGE


DESCRIPTION:
nRow, nCol
Position in the area of ??the window in pixels.
nWidth, nHeight
The desired size of the Image Control in pixels.
nId
The ID identifier this Control in Dialog Window
ControlName
A reference to the Image Control
ParentWindowName
A reference to the Parent Window.
nHelpID
The help topic identifier for this Control
cPictureName
Specifies the name of the Image to be showed
OnClickProcedure
An action to be performed when Clicking the control
OnHoverProcedure
An action to be performed when Mouse Hover over the control
OnLeaveProcedure
An action to be performed when Mouse Leave from over the control
cToolTipText
Specifies a Text for the ToolTip
anBackColor
Specifies  he Background Color
 
 
STRETCH
Specifies to strech the image to fit the specified Width and Height that were defined
WHITEBACKGROUND
Specifies that the background of the image is White
TRANSPARENT
Specifies that the background of a control should be transparent
ADJUSTIMAGE | ADJUST
?
INVISIBLE
The visibility property specifies whether or not a control is visible


PROPERTIES:

·   Enabled
Set / Gets enabled state of a Image control
·   Visible          
Sets or gets visible a Image control.
·   Picture
Set / Gets image name of a mage control.
·   Row
Set / Gets row position of a Image control.
·   Col   
Set / Gets column position of a Image control.
·   Width
Set / Gets width of a Image control.
·   Height
Set / Gets height of a Image control.
·   Action
Set / Gets Image control's Tooltip text.
·   Cargo
Set / Gets user property 'Cargo' for Image control
·   HBitmap
Set / Gets hBitmap of a Image control
·   Name (R)
Retrieves the name of a Image control.
·   Parent(D)
Set the name as character identifier of the parent window.
·   HelpId(D)
Set the numeric help topic identifier of the control.
·   Stretch(D)
Sets a value that image to stretch to completely fill the destination rectangle.

D: Available at control definition only
R: Read-Only

EVENTS:

·   OnClick/Action
Action to be performed when generic clicking of the control
Action to be performed when the mouse pointer hovers over the control
Action to be performed when the user moves the mouse pointer outside the boundaries of the control

METHODS:

·   Show
Shows a Image control
·   Hide
Hides a Image control.
·   Release
Releases a Image control from memory.
·   Refresh
Repaint a Image control
·   SaveAs
Save Control as BitMap file.

EXAMPLE:

See sample in Chapter:
       \Samples\Basic\HyperLink
Displaying Images (The Image Control)