BROWSEDIRCALLBACK Function

#include "l_bitmap.h"

L_INT pEXT_CALLBACK YourFunction(pBitmap, pszFilename, pFileInfo, nStatusCode, nPercent, pUserData)

pBITMAPHANDLE pBitmap;

pointer to the bitmap handle

L_TCHAR* pszFilename;

pointer to the filename

pFILEINFO pFileInfo;

pointer to the file info structure

L_INT nStatusCode;

status code

L_INT nPercent;

percentage completion of a file load

L_VOID* pUserData;

pointer to additional parameters

Handles the thumbnails generated by calling the L_BrowseDir function.

Parameter Description
pBitmap The pointer to the bitmap handle referencing the thumbnail generated by L_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.
nStatusCode Status code. If an error occurred during thumbnail generation, this will be < SUCCESS. Possible values are:
  Value Meaning
  <SUCCESS An error occurred.
  SUCCESS [1] Image was loaded.
  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 L_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 nStatusCode is equal to BROWSE_LOADING.
pUserData A void pointer that you can use to access a variable or structure containing data that your callback function needs. This gives you a way to receive data indirectly from the function that uses this callback function. (This is the same pointer that you pass in the pUserData parameter of the calling function.). Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function.

Returns

SUCCESS

The function was successful.

< SUCCESS

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 L_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.

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Raster Imaging C API Help