IG_gui_save_filename_dlg

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);