LFile::BrowseDirCallBack

#include "ltwrappr.h"

virtual L_INT LFile::BrowseDirCallBack(pLBitmap, pszFilename, pInfo, nStatusCode, nPercent, pUserData)

LBitmapBase L_FAR *pLBitmap;

/* pointer to an LBitmapBase object */

L_TCHAR L_FAR * pszFilename;

/* pointer to the filename */

pFILEINFO pFileInfo;

/* pointer to the file info structure */

L_INT nStatus;

/* status code */

L_INT nPercent;

/* percentage completion of a file load */

Handles the thumbnails generated by calling the LFile::BrowseDir function.

Parameter

Description

pBitmap

The pointer to the LBitmapBase object that references the thumbnail generated by LFile::BrowseDir. You can copy this bitmap, save it to file, insert it into a LEADTOOLS ImageList Control, or otherwise process it as needed in your application.

pszFilename

Character string containing the filename from which this thumbnail was generated.

pFileInfo

Pointer to a FILEINFO structure containing information about pszFilename.

nStatus

Status code. If an error occurred during thumbnail generation, this will be < SUCCESS. Possible values are:

 

Value

Meaning

 

BROWSE_LOADING

[2] Indicates image is being loaded, see nPercent.

 

BROWSE_SKIPPED

[3] Indicates image was skipped because it was larger than the specified range in LFile::BrowseDir.

 

BROWSE_PRELOAD

[4] Indicates that LEADTOOLS has found a file and is about to determine the file format. It will then attempt to create a thumbnail for it. If the user wishes to avoid the internal file information processing, return ERROR_FILE_FORMAT. This will cause LEADTOOLS to skip the file.

nPercent

Represents the percentage completion of a file load when nErrorCode is equal to BROWSE_LOADING.

Returns

> 0

The function was successful, and returns the handle to the ImageList Control window.

< 0

An error occurred. Return Codes

Comments

You must return SUCCESS to continue browsing for supported image files. The value you return from this callback will also be returned from LFile::BrowseDir.

Required DLLs and Libraries

LTFIL
LTIMG
LTTMB
File format DLLs

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

LFile::BrowseDir, LFile::LoadBitmap, LFile::GetCompressStamp, LFileSettings::SetExtFileOption, LFileSettings::SetLoadResolution, LFileSettings::SetPCDResolution, LFileSettings::SetWMFResolution, LFileSettings::SetWMFResolutionExt

Topics:

Thumbnail Browser

Example

For an example, refer to LFile::BrowseDir.