ImageGear for C and C++ on Windows v19.3 - Updated
IG_gui_save_image_dlg
API Reference Guide > GUI Component API Reference > GUI Component Functions Reference > Save Functions > IG_gui_save_image_dlg

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:

 
Copy Code
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.

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

GUI Windows, Color, Display, Filter, Image Processing, ImageClean, ISIS, JPEG, Palette Edit, Progressive JPEG, Print, Recognition, TWAIN, Medical, Alpha, Multimedia, Annotation, ArtX, FreqIP, Legacy Alpha, Legacy Pixel Access, Pixel Access

Example:

 
Copy Code
#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 );