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.

<container>

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

<name expC>

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

s
ystemTheme
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.