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

    This function shows the file open dialog and returns the file name to load.

    Declaration:

     
    Copy Code
    BOOL ACCUAPI IG_gui_load_filename_dlg (
            HWND hWnd, 
            LPCHAR lpTitle, 
            LPCHAR lpFileName, 
            UINT nFNameSize, 
            LPAT_MODE lpnFormatID
    );
    

    Arguments:

    Name Type Description
    hWnd HWND Handle of the parent window.
    lpTitle LPCHAR Dialog title.
    lpFileName LPCHAR Pointer to the file name buffer.
    nFNameSize UINT File name buffer size.
    lpnFormatID LPAT_MODE Format ID.

    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:

    ASCII, Display, GUI Windows, Image Processing, IOSET, JPEG, Load Callback, Page, Print, Multipage, FlashPix, Multimedia

    Example:

     
    Copy Code
    #include "IG_gui_common.h"
    IG_gui_load_filename_dlg(hWnd, NULL, szFile, sizeof(szFile), NULL);
    

    Remarks:

    This function also shows the format identifier if the format is detected.