ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / GUI Component API Reference / GUI Component Functions Reference / Save Functions / IG_gui_save_filename_dlg_W
In This Topic
    IG_gui_save_filename_dlg_W
    In This Topic

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