Image Edit Control

What the Image Edit control lets you do

The Image Edit control lets you the application developer add image display, annotation, manipulation, and management functions to applications that support 32-bit ActiveX/OCX controls.

Note: The Image Edit control is an ActiveX control in:

• Imaging for Windows Professional Edition V1.0, V1.1, and V2.0
  
  
• Imaging for Windows 98

And an OCX control in:

• Imaging for Windows 95
  
  
• Imaging for Windows NT 4.0

What the Image Edit control lets your users do

Depending on how you design and code your application, the Image Edit control lets your users display, annotate, and manipulate image document files and managed image documents.

Image Display

The Image Edit control allows end users to display image documents of various types.  Specifically, the control supports the following file types:

• AWD
  
  
• BMP
  
  
• DCX
  
  
• GIF
  
  
• JPG
  
  
• PCX
  
  
• TIFF
  
  
• WIFF
  
  
• XIF

Note: AWD is not available with Imaging for Windows NT 4.0.  GIF and WIFF are available with Imaging for Windows Professional Edition V1.0, V1.1, and V2.0; and Imaging for Windows 98.

Image Annotation

The control includes several properties, methods, and events that enable you to add annotation functions to application programs.  The annotation functions permit your end users to annotate displayed images.

You can set the annotation types you want to include in your application programmatically, or you can invoke the standard Annotation Tool Palette to include a complete set of annotation tools.  Invoking the Annotation Tool Palette frees you from writing several lines of code.

Image Manipulation

The Image Edit control has properties, methods, and events that enable you to add image manipulation functions to your application programs.  These functions permit end users to perform the following tasks on displayed images:

• Convert to text (when used in conjunction with the Image OCR control)
  
  
• Copy, cut, and paste to the Clipboard
  
  
• Crop
  
  
• Deskew
  
  
• Despeckle
  
  
• Flip
  
  
• Invert
  
  
• Rotate
  
  
• Scale
  
  
• Scroll
  
  
• Zoom

Image Document Retrieval and Storage

The Image Edit control also includes methods that enable you to add image document retrieval and storage functions to application programs.  These functions permit end users to retrieve, save, print, and delete image and annotation data.

Linking Other Imaging Controls to the Image Edit Control

The Image Edit control is the main Imaging control.  The Image Annotation Tool Button and Image Scan controls link to the Image Edit control to perform several functions.

Image Annotation Tool Button Control

The Image Annotation Tool Button control links to the Image Edit control to permit the annotation of displayed images.  The Image Annotation Tool Button control sends messages to the Image Edit control that set annotation attributes, thereby changing all of the Image Edit annotation attributes to the values set within the Image Annotation Tool Button control.  When the Draw method is invoked, the Image Edit control draws the annotation.

Image Scan Control

The Image Scan control links to the Image Edit control to display images while they are being scanned.

Establishing the Link

To link the Image Annotation Tool Button control to the Image Edit control:

1. Set the DestImageControl property of the Image Annotation Tool Button control to the name of the desired Image Edit control.
   
   
2. Set the ImageControl property of the Image Edit control to the same Image Edit control name.

To link the Image Scan control to the Image Edit control:

1. Set the DestImageControl property of the Image Scan control to the name of the desired Image Edit control.
   
   
2. Set the ImageControl property of the Image Edit control to the same Image Edit control name.