ShowSaveFileDlg Method

Description:

Shows the Windows standard file "Save As" dialog. There are no arguments to this subroutine, but the programmer may set the IGGUIDlgCtl Control.Directory property before calling ShowOpenDirDlg(), to set the "starting point" from which the end-user will navigate.

The Save As dialog is slightly modified as displayed by ShowSaveFileDlg, and is as follows:

The dialog behaves essentially the same as the standard Windows Save As dialog: the user navigates to different directories using the "Save in:" pulldown, the navigation buttons, and by double-clicking in the list area. Whenever a file is selected, its name is displayed in the "File name:" field. If the user needs to create a new file for the image, then after navigating to the appropriate folder, the user must enter a file-name.

The "Save as type" pull-down list displays all of the image file-types that ImageGear can write. When the user selects a particular file-type, then the list area will only show directories and files whose file-name extensions correspond to the selected file-type.

The "Selected File:" field is generated by ImageGear, by reading the first few bytes of the selected file and determining its actual file-type (thus, for instance, a JPEG image might be misnamed "foobar.bmp" - the "File Info" field will show that the file is a 1-page JPEG file).

The "Save Mode" and "Page to replace" controls are only active when the selected file is a multi-page file - they allow the user to control the particulars of how the image is written into the existing file.

Clicking the "Save" button will close the dialog, sets the following IGGUIDlgCtl Control properties and returns True to the application program. Properties set:

Note that the file is not saved by the ShowSaveFileDlg processing: it is up to the application programmer to actually call IGFormatsCtl Control.SavePageToFile or IGFormatsCtln.SaveDocumentToFile.

Clicking the "Cancel" button will close the dialog and return False to the application program.

Syntax:

      ShowSaveFileDlg() As Boolean

Return Value:

True indicates that the user chose a filename, save mode and page number and clicked "Save". False indicates that the user clicked "Cancel".

Bits Per Pixel:

N/A

Sample:

ig_guidlg.vb6.exe