Shows the file save dialog. Returns the selected file name and page number to save or replace. It also returns the format identifier if the selected file exists and its format has been detected.
Declaration:
BOOL ACCUAPI IG_gui_save_image_dlg (
HWND hWnd,
LPCHAR lpTitle,
HIGEAR hIGear,
LPAT_LMODE lpnSaveList,
UINT nSListSize,
LPAT_IGGUI_SAVEFILE_INFO lpSFInfo
);
Arguments:
Name |
Type |
Description |
hWnd |
HWND |
Handle of the parent window. |
lpTitle |
LPCHAR |
Dialog title. |
hIGear |
HIGEAR |
Pointer to the HIGEAR. |
lpnSaveList |
LPAT_LMODE |
Format List. |
nSListSize |
UINT |
Format list size. |
lpSFInfo |
LPAT_IGGUI_SAVEFILE_INFO |
Pointer to AT_IGGUI_SAVEFILE_INFO structure that provides information on how the image file should be saved. |
Return Value:
If the user specifies parameters and clicks the OK button, the return value is nonzero. If the user cancels or closes the dialog box or an error occurs, the return value is zero.
This function does not process image pixels.
Sample:
GUI Windows, Color, Display, Filter, Image Processing, ImageClean, ISIS, JPEG, Palette Edit, Progressive JPEG, Print, TWAIN, Medical, Alpha, Multimedia, Annotation, ArtX, FreqIP, Legacy Alpha, Legacy Pixel Access, Pixel Access
Example:
#include "IG_gui_common.h"
AT_IGGUI_SAVEFILE_INFO SFInfo;
HIGEAR hIGear;
memset( &SFInfo, 0, sizeof(SFInfo) );
IG_gui_save_page_dlg( hWnd, NULL, hIGear, NULL, 0, &SFInfo );