OPENDLGFILEDATA

Summary

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.

Syntax

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 ; 

Members

uStructSize

Size of this structure, in bytes. Use the sizeof operator to calculate this value.

szFileName

Character string containing the name of the file to open.

pBitmap

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.

pThumbnail

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.

pFileInfo

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.

nPageNumber

Number of the page to load.

nPasses

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:

bLoadCompressed

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.

bLoadRotated

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:

FileOptions

An OPENDLGOPTIONS structure to be updated with information entered by the user through the dialog.

RasterizeDocOptions

An RASTERIZEDOCOPTIONS structure to be updated with information entered by the user through the dialog.

bLoadMultithreaded

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:

Usage

• OPENDLGPARAMS