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

Shows the file save dialog and returns the file name, specified as a wide string (UTF-16), and format identifier if file format of the image is detected.

Declaration:

 
Copy Code
BOOL ACCUAPI IG_gui_save_filename_dlg_W (
        HWND hWnd, 
        LPAT_WCHAR lpwszTitle, 
        LPAT_MODE lpnFormatList, 
        UINT nFListSize, 
        LPAT_WCHAR lpwszFileName, 
        UINT nFNameSize, 
        LPAT_MODE lpnFormat
);

Arguments:

Name Type Description
hWnd HWND Handle of the parent window.
lpwszTitle LPAT_WCHAR Dialog title.
lpnFormatList LPAT_MODE Format list.
nFListSize UINT Format list size.
lpwszFileName LPAT_WCHAR Pointer to the file name buffer.
nFNameSize UINT File name buffer size.
lpnFormat LPAT_MODE Format ID.

Return Value:

If the user specifies the parameters and clicks the OK button, the return value is non-zero. 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"
IG_gui_save_filename_dlg_W (hWnd, NULL, NULL, 0, wszFile, sizeof(wszFile), &lFormat);