@...IMAGE \/ DEFINE IMAGE

Creates an image control

Displays images in formats: BMP, GIF, JPG, TIF, WMF, EMF, CUR and PNG.

Standard Syntax (xBase Style):

 @ <nRow> ,<nCol>
 IMAGE <ControlName>
 [ OF | PARENT <ParentWindowName> ]
 [ ACTION | ONCLICK | ON CLICK <ActionProcedureName> | <bBlock> ]
 PICTURE <cPictureName>
 [ WIDTH <nWidth> ]
 [ HEIGHT <nHeight> ]
 [ STRETCH ]
 [ HELPID <nHelpId> ]
 [ INVISIBLE ]
 [ TRANSPARENT ]
 [ BACKGROUNDCOLOR anBackgroundColor ]
 [ ADJUSTIMAGE ]
 [ TRANSPARENTCOLOR anTransparentColor ]
 [ TOOLTIP <cToolTipText> ]

Alternate Syntax:

DEFINE IMAGE <Controlname>
   PARENT <ParentWindowName>
   ROW <nRow>
   COL <nCol>
   ONCLICK <ActionProcedureName>
   PICTURE <cPictureName>
   WIDTH <nWidth>
   HEIGHT <nHeight>
   STRETCH <lValue>
   HELPID <nHelpId>
   VISIBLE <lValue>
   TRANSPARENT <lValue>
   BACKGROUNDCOLOR <anBackgroundColor>
   ADJUSTIMAGE <lValue>
   TRANSPARENTCOLOR <anTransparentColor>
   TOOLTIP <cToolTipText>
END IMAGE

Properties:

• Enabled
• Visible
• Picture
• Row
• Col
• Width
• Height
• Name (R)
• Parent (D)
• HelpId (D)
• Stretch (D)
• Transparent (D)
• BackgroundColor (D)
• AdjustImage (D)
• TransparentColor (D)
• hBitmap

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

Note:

• If WIDTH is Zero the image is displayed with the Width of the original image, for default is zero.
• If HEIGHT is Zero the image is displayed with the Height of the original image, for default is zero.
• STRETCH: the Width\/Height of the image is adjusted exactly at the Width\/Height of the Image Control.
• TRANSPARENT: sets the color of the first pixel (col=0, row=0) of the image to treat as transparent in the image.
• BACKGROUNDCOLOR: sets the color of the Background image in anBackgroundColor, for default is the color COLOR_BTNFACE.
• ADJUSTIMAGE: the WIDTH\/HEIGHT ratio of the Image Control is adjusted exactly at the Width\/Height ratio of the image.
• TRANSPARENTCOLOR: sets the color anTransparentColor to treat as transparent in the image, for default is the color of the first pixel of the image.

Events:

• OnClick

Methods:

• Show
• Hide
• Release
• Refresh