class Image

Topic group Related topics

A rectangular region on a form that displays a bitmap image.

Syntax

[<oRef> =] new Image(<container> [,<name expC>])

<oRef>

A variable or property—typically of <container>—in which to store a reference to the newly created Image object.

The container—typically a Form object—to which you’re binding the Image object.

An optional name for the Image object. If not specified, the Image class will auto-generate a name for the object.

Properties

The following table lists the properties of interest in the Image class. (No particular methods are associated with this class.)

Property	Default	Description
alignment	Stretch	Determines the size and position of the graphic inside the Image object (0=Stretch, 1=Top left, 2=Centered, 3=Keep aspect stretch, 4=True size)
allowDrop	false	Whether dragged objects (i.e. the name of a graphic image file) can be dropped in the Image object
anchor	0 – None	How the Image object is anchored in its container (0=None, 1=Bottom, 2=Top, 3=Left, 4=Right, 5=Center, 6=Container)
baseClassName	IMAGE	Identifies the object as an instance of the Image class
className	(IMAGE)	Identifies the object as an instance of a custom class. When no custom class exists, defaults to baseClassName
dataSource		The file or field that is displayed in the Image object
fixed	false	Whether the Image object’s position is fixed or if it can be "pushed down" or "pulled up" by the rendering or suppression of other objects
imgPixelHeight	0	Returns an image's actual height in pixels
imgPixelWidth	0	Returns an image's actual width in pixels

Event	Parameters	Description
onDragEnter	<left expN> <top expN> <type expC> <name expC>	When the mouse enters the Image object's display area during a Drag&Drop operation
onDragLeave		When the mouse leaves the Image object's display area without having dropped an object
onDragOver	<left expN> <top expN> <type expC> <name expC>	While the mouse drags an object over the Image object's display area during a Drag&Drop operation
onDrop	<left expN> <top expN> <type expC> <name expC>	When the mouse button is released over the Image object's display area during a Drag&Drop operation

The following table lists the common properties, events, and methods of the Image class:

Property		Event		Method
before borderstyle dragEffect enabled form height hWnd id left mousePointer	name pageno parent printable speedTip systemTheme top visible width	beforeRelease canRender onClose onDesignOpen onDragBegin onLeftDblClick onLeftMouseDown onLeftMouseUp onMiddleDblClick	onMiddleMouseDown onMiddleMouseUp onMouseMove onOpen onRender onRightDblClick onRightMouseDown onRightMouseUp	drag( ) move( ) release( )

Description

Use an Image object to display a bitmap image. The image can be data from a field, or a static image like a company logo.

dBASE Plus supports the following bitmap image formats:

Graphics Interchange Format (GIF), including animated GIF

Joint Photographic Experts Group (JPG, JPEG)

Portable Network Graphics (PNG)

X BitMap (XBM)

Windows bitmap (BMP)

Windows icon (ICO)

Device Independent Bitmap (DIB)

Windows metafile (WMF)

Enhanced Windows metafile (EMF)

PC Paintbrush (PCX)

Tag Image File Format (TIF, TIFF)

Encapsulated PostScript (EPS)

dBASE Plus will resize images according to the Image object’s alignment property. When resizing, transparent GIF backgrounds are lost. To prevent resizing, set the alignment property to 4 (True size).

For TIFF, dBASE Plus supports uncompressed, single-bit Group 3, PackBits, and LZW (Lempel-Ziv & Welch) compression. Group 4 compression is not supported. Color TIFF images must have a palette. Except when rendering an EPS file on a PostScript-capable printer, dBASE Plus uses the bitmap preview in the EPS file, which must be in TIFF or WMF format.