typedef struct _OPENDLGFILEDATA
{
L_UINT uStructSize;
L_TCHAR szFileName [L_MAXPATH];
pBITMAPHANDLE pBitmap;
pBITMAPHANDLE pThumbnail;
pFILEINFO pFileInfo;
L_INT nPageNumber;
L_INT nPasses;
L_BOOL bLoadCompressed;
L_BOOL bLoadRotated ;
OPENDLGOPTIONS FileOptions ;
RASTERIZEDOCOPTIONS RasterizeDocOptions;
L_BOOL bLoadMultithreaded ;
} OPENDLGFILEDATA, * LPOPENDLGFILEDATA ;
The OPENDLGFILEDATA structure is allocated by the L_DlgOpen function based on the number of files selected when the user presses Open the open button. After the user presses Open the open button, this structure is updated with information about the user's selections.
Size of this structure, in bytes. Use the sizeof operator to calculate this value.
Character string containing the name of the file to open.
Pointer to the bitmap handle to be filled with the file's bitmap if DLG_OPEN_LOADBITMAP is set in the uDlgFlags member of the OPENDLGPARAMS structure. You should free this pointer using the GlobalFree function only if you set the DLG_OPEN_LOADBITMAP flag.
Pointer to the bitmap handle to be filled with the file's thumbnail bitmap if DLG_OPEN_GENERATETHUMBNAIL is set in the uDlgFlags member of the OPENDLGPARAMS structure. You should free this pointer using the GlobalFree function only if you set the DLG_OPEN_GENERATETHUMBNAIL flag.
Pointer to a FILEINFO structure to be updated with information entered by the user through the dialog. You should free this pointer when it is no longer needed using the GlobalFree function.
Number of the page to load.
The number of passes (scans through the image) when loading or saving a progressive JPEG, LEAD CMP, or PNG files. (This value is also used when loading, but not when saving, interlaced PNG files.). Possible values when loading a progressive file:
Any positive number | Do the specified number of times. |
---|---|
CALLBACK_ONCE | Do only one pass at the end. |
CALLBACK_WHEN_MEANINGFUL | Do only significant scans. (This is usually the best option). |
CALLBACK_ALWAYS | Do the number of passes stored in the file. |
Value that indicates the status of the Load Compressed Box and therefore whether to load the image in compressed form. If possible, load the file as a 1 bit RLE compressed image. For more information, refer to Speeding Up 1-Bit Documents.
Value that indicates the status of the Load Rotated Box and whether you wish to load the image in a rotated state, if the image was saved with a rotated view perspective in the file. For more information, refer to LOADFILEOPTION. Possible flags values are:
Value | Meaning |
---|---|
TRUE | The Load Rotated Box is checked and the image will be loaded in a rotated state. |
FALSE | The Load Rotated Box is not checked and the image will not be loaded in a rotated state. |
An OPENDLGOPTIONS structure to be updated with information entered by the user through the dialog.
An RASTERIZEDOCOPTIONS structure to be updated with information entered by the user through the dialog.
Value that indicates the status of the Load Multithreaded Box and whether you wish to use multi-threaded load. For more information, refer to LOADFILEOPTION.Flags. Possible values are:
Value | Meaning |
---|---|
TRUE | The Load Multithreaded Box is checked and multi-threaded load will be used. |
FALSE | The Load Multithreaded Box is not checked and multi-threaded load will not be used. |