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_page_dlg_W
In This Topic
    IG_gui_save_page_dlg_W
    In This Topic

    Shows the file save dialog and returns the file name, specified as a wide string (UTF-16) and page number to save or replace. It also returns the format identifier if file format of the image is detected.

    Declaration:

     
    Copy Code
    BOOL ACCUAPI IG_gui_save_page_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.
    lpTitle LPCHAR Dialog title.
    hIGear HIGEAR Pointer to the HIGEAR.
    lpnSaveList LPAT_LMODE Format list. If NULL the function generates list of available formats to use in the save dialog as a file names filter.
    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 non-zero. If the user cancels or closes the dialog box or an error occurs, the return value is zero.

    Supported Raster Image Formats:

    All pixel formats supported by ImageGear for C and C++.

    Sample:

    GUI Windows, PDF Demo

    Example:

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