BadDocumentFileType Event

Example-VB Example-VC++

This event occurs when an image is being saved to an existing image document, and the current page attempting to be overwritten is read-only.

Available With

Ö Imaging for Windows Professional Edition V2.0
Imaging for Windows Professional Edition V1.0 and V1.1
Imaging for Windows 95 and 98
Imaging for Windows NT 4.0

Applies To

Image Edit control

Syntax

Sub object_BadDocumentFileType(Page,ErrorOut,Skip,Overwrite)

Arguments

Parameter Data Type Setting

Page Long Specifies the page number being saved.
ErrorOut Boolean Determines whether the current operation terminates with an error when the event fires:

True The current operation terminates with an error (default).  The Skip and Overwrite parameters are ignored.
False The current operation does not terminate with an error.  Handling is determined by the Skip or Overwrite parameter setting.

Skip Boolean If the ErrorOut parameter is set to False, the Skip parameter determines whether to skip the file being processed:

True Skips the file being processed.  The Overwrite parameter is ignored.
False Does not skip the file being processed (default).  Handling is determined by the Overwrite parameter setting.

Overwrite Boolean If the ErrorOut and Skip parameters are set to False, the Overwrite parameter determines whether the current, read-only page in the document is overwritten:

True The current, read-only page in the document is overwritten.

The overwritten image document retains the same name, which insures that any links to it are not broken.  However, its extension may be changed to a read-only type, even thought it contains read-write image data (the overwritten page).

False The current, read-only page in the document is not overwritten (default).

Set Overwrite to False if you want to create a new, read-write file for the page being saved.  (Keep in mind that other documents linking to this page will not be affected, but that the current document will no longer point to the same file for the current page).


Remarks

This event is functional only when writing to AWD, BMP, and TIFF file types.

Links to image document pages are managed using Hyperlink annotations.

Note: AWD is not available with Imaging for Windows NT 4.0.