ImageGear for C and C++ on Windows v19.1 - Updated
IG_gui_load_filename_dlg
API Reference Guide > GUI Component API Reference > GUI Component Functions Reference > Load Functions > IG_gui_load_filename_dlg

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.