VMMap (Hot Map) Component for Delphi (ver. 1.2)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Contents

I.   Properties
II.  Methods
III. Events
IV.  How to use.


I. Properties

BorderWidth (1..3) - regions border width
MapArea (string)   - click on MapArea property in Object Inspector to call
                     regions editor dialog box
Picture (TPicture) - Image
RgnColor (TColor)  - regions border color
SelectedFill (fmNone, fmInvert) - selected region fill mode
SelectedColor (TColor) - selected region's border color
ShowRgns (smAll, smHone, smSelected) - defines how to show regions
Stretch - if true then image can be resized, regions are resized simultaniously.

II. Methods

procedure LoadFromStream(Stream: TStream) - loads regions from stream
procedure SaveToStream(Stream: TStream)   - saves regions to stream 
procedure LoadFromFile(FileName: string)  - loads regions from file
procedure SaveToFile(FileName: string)    - saves regions to file

function AddRgn(RegionName : IDString; NPoints : Integer; 
  Points : Array of TPoint) : HRGN  
Adds new region on image. RName (string[10]) - region name,
NPoints - Number of points in region, Points - array of Points

function DeleteRgn(Region : HRGN) : Boolean - Delete region from image

function GetRgnID(Region : HRGN) : IDString - returns region name by
it's handle

function GetRgn(RegionID : IDString) : HRGN - returns region handle by it's
name

function GetSelectedRgn : HRGN  - returns currently selected region handler

function SelectRgn(Region : HRGN) : Boolean - selects region by it's handle


III Events

Mouse event handlers (OnClick, OnDblClick, OnMouseDown, OnMouseDown, 
OnMouseMove, OnMouseUp) have two additional parameters:
  Rgn (Integer) - region handler
  RgnID (string[10]) - region name


IV. How to use

 - Select VMMap component on Components Palette
 - Double click on Picture property in Object Inspector and load BMP image 
 - Double click on MapArea to call Region Editor and define regions:
   click "Add" button, use left mouse button to add a new point, use BackSpace
   to delete last point, use right mouse button to finish a new region.
   Enter a region's name in dialog.
 - Define events handler procedure 

!!Warning!! Regions in Delphi 1.0 and 2.0 have incompatible format.
            You have to delete all regions from VMMap component before 
            loading project from other version of Delphi. Otherwise your 
            project may work incorrectly. 

--------------------------------------------------------------------------

(c) Vadim Miller, 1996
E-mail: miller@bor.compnet.ru
