This function displays the "Save" dialog which includes a file preview and file information. This dialog is used to select an image file to be saved.
Parameters
| Name | Explanation |
|---|---|
| hWnd | The window handle |
| FileName | The name of the selected file or the name of the file initially displayed in the "Save" dialog |
| FilePath | The name of the directory shown in the "Save" dialog when it is first displayed. If this parameter is blank then the current directory is shown. |
| FileExt | This sets the types of files that are shown in the "Save" dialog when it is first displayed. To set multiple file types use a semicolon as a delimiter. Ex: "BMP;JPG". Setting an asteriks "*" will remove the term "All Files" from the dropdown menu in the "Save" dialog. If you surround the file type with "<>" as in "<JPG>" then that file type will be displayed as the default type. |
| ExtendedDialog | False(0): Preview and FileInfo checkbox is not
displayed True(nonzero): Preview and FileInfo checkbox is displayed |
| Preview | Sets the file preview function when the "Save" dialog is first displayed. False (0): No preview, True (nonzero): Preview |
| FileType | The type of file that has
been selected. 1:BMP, 2:JPEG, 3:GIF, 4:TIFF, 5:PNG, 6:FPX, 7:PCX, 8:WMF, 9:EMF, 10:DXF, 11:SVG, 12:JPEG2000, 13:JPEG2000(Code Stream), 14:SXF(p21), 15:SXF(sfc) |
| FileInfo | Sets whether or not the file information displayed when the "Save" dialog is first displayed. False(0): File information not displayed, True (nonzero): File information is displayed |
Return Value
Returns True (nonzero) if "Save" is selected. Returns False (0) if "Cancel"is selected.
Explanation
The IKSaveFileDialog function displays the "Save" dialog which includes a file preview and file information. This dialog is used to select an image file to be saved.
The FilePath and FileExt parameters set the file that is shown in the list when the "Save" dialog is initially displayed. If the FileName parameter contains the full path, then the FilePath parameter is disabled. By selecting the Save button, the file name and full path are set in the FileName parameter. When the Save button is clicked, FileType parameter returns the type of file that was selected in the "Save" dialog. If ExtendedDialog is set to true, when the dialog is displayed the preview and file information checkboxes are displayed. Even if Preview and FileInfo are False, these checkboxes will be displayed.
To reference a vector image in the preview , you must first execute the Ik9VectCom.dll, Ik9VectComA.dll, Ik9VectCom64.dll, or Ik9VectCom64A.dll's IKVectorGdipStart function.
Example:
(1)C++Builder/Visual C++
TCHAR FileName[256];
BOOL Ret;
int FileType;
memset(FileName, 0, sizeof(FileName)); //in this case, the FilePath parameter is enabled
//if the file name and full path are set into the FileName parameter, then the FilePath parameter is disabled
//lstrcpy(FileName, "C:\\Images\\001.jpg");
//In Visual C++, set Form1->Handle into m_hWnd
Ret = IKSaveFileDialog(Form1->Handle, FileName, "C:\\My Pictures", "*;BMP;JPG;", FALSE, &FileType);
(2)Delphi
FileName: array [0..255] of Char;
Ret: LongBool;
FileType: Integer;
FillChar(FileName, SizeOf(FileName), 0); // in this case, the FilePath parameter is enabled
//if the file name and full path are set into the FileName parameter, then the FilePath parameter is disabled
//StrPCopy(FileName, 'C:\Images\001.jpg');
Ret = IKSaveFileDialog(Form1.Handle, FileName, 'C:\My Pictures', '*;BMP;JPG;', False, FileType);
(3)Visual Basic
Dim FileName As String * 256
Dim Ret As Long
Dim FileType As Long
FileName = Chr$(0) 'in this case, the FilePath parameter is enabled
'if the file name and full path are set into the FileName parameter, then the FilePath parameter is disabled
'FileName = "C:\Images\001.jpg"
Ret = IKSaveFileDialog(Form1.hWnd, FileName, "C:\My Pictures", "*;BMP;JPG;", False, FileType);