This method displays the "Save" dialog which includes the file preview function. This dialog is used to select an image file to be saved.
Parameters
None
Return Value
Returns True(nonzero) if "Save" is selected. Returns False(0) if "Cancel" is selected.
Explanation
The SaveFile method displays the "Save" dialog which includes the file preview function. This dialog is used to select a directory and file name into which the image date is to be saved.
By setting the FilePath and FileExt properties it is possible to control the directory and types of files that are listed when the "Save" dialog is displayed. For details, please refer to the explanation for those properties.
However, if the FileName property contains a full path, the FilePath property will be ignored.
Prior to executing this method, if the ExtendedDialog property is set to true, when the dialog is displayed the preview and file information checkboxes are displayed. Even if the Preview and Information properties are False, these checkboxes will be displayed.
When the "Save" button is clicked the file name and path are set into the FileName property and the type of file is set into the SaveFileDlgFileType property.
Example:
Visual Basic
Dim Ret As Boolean
ImageKit1.File.FileExt = "*;BMP;JPG;"
ImageKit1.File.FilePath = "C:\My Pictures"
ImageKit1.File.FileName = "" 'By setting a blank string here, the FilePath property is enabled.
'if the full path is set into the FileName property then the FilePath property is disabled.
' ImageKit1.File.FileName = "C:\Images\001.jpg"
ImageKit1.File.ExtendedDialog = True
ImageKit1.File.Preview = False
ImageKit1.File.Information = False
Ret = ImageKit1.File.SaveFileDialog()