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

Shows the file save dialog. Returns the selected file name as a wide string (UTF-16) 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_W ( 
            HWND hWnd,
            LPAT_WCHAR lpwszTitle,
            HIGEAR hIGear,
            LPAT_LMODE lpnSaveList,
            UINT nSListSize,
            LPAT_IGGUI_SAVEFILE_INFO_W lpSFInfo
);

Arguments:

Name Type Description
hWnd HWND Handle of the parent window.
lpwszTitle LPAT_WCHAR Dialog title.
hIGear HIGEAR Image handle.
lpnSaveList LPAT_LMODE Format List.
nSListSize UINT Format list size.
lpSFInfo LPAT_IGGUI_SAVEFILE_INFO_W Pointer to AT_IGGUI_SAVEFILE_INFO_W 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

Example:

 
Copy Code
#include "IG_gui_common.h" 
AT_IGGUI_SAVEFILE_INFO_W          SFInfo; 
HIGEAR                          hIGear; 
memset( &SFInfo, 0, sizeof(SFInfo) ); 
IG_gui_save_image_dlg_W( hWnd, NULL, hIGear, NULL, 0, &SFInfo );