This function displays an enhanced file open dialog, opens the specified image and returns a handle to be used with the other ImageMan functions. The Open dialog optionally displays a preview thumbnail of the selected image as well as the various information such as image size, file size, etc.
|
Parameter |
Type |
Description |
|
lpOpenFilename |
LPOPENFILENAME |
Points to an OPENFILENAME structure that has been initialized. |
|
lOptions |
LONG |
Specifies options used for the Open Dialog |
Return Value
The return value specifies the handle used to refer to the image. The name of the selected file is returned in the lpstrFile field of the OPENFILENAME structure.
Comments
Be sure to initialize the OPENFILENAME structure before passing it to this function. We recommend you call memset( lpOpenFilename, 0, sizeof(OPENFILENAME) ).
The values for the lOptions flag are:
|
Flag |
Description |
|
IMG_OFN_ALLOWTHUMBOPT |
Specifies that the 'Preview' button be enabled |
|
IMG_OFN_SHOWTHUMB |
Specified that the preview thumbnail should be shown when the dialog is opened. |
|
IMG_OFN_ALLOWSTATSOPT |
Specifies that the 'Stats' button be enabled. |
|
IMG_OFN_SHOWSTATS |
Specifies that the image's information be displayed when the dialog is opened. |
|
IMG_OFN_FULL |
Specifies all the above flags. |
© 1995-2004 Data Techniques, Inc. All rights reserved.